EnterDeveloperPowerShell.psm1
|
<#
.SYNOPSIS This function will enter the Visual Studio Developer Powershell mode of the version selected using the $DisplayNameMatch .PARAMETER DisplayNameMatch A regex that will be matched against the DisplayName of the instance. You can also send in "latest" to just get the latest version. Default: "latest" .NOTES Depends upon VSWHERE.exe. Requires that at the very least Visual Studio 2017 is installed or greater. Can be used to enter the developer powershell for lower versions as long as VSWHERE.EXE is found. .EXAMPLE PS> Invoke-VSDeveloperPowershell -DisplayNameMatch "latest" .EXAMPLE PS> Invoke-VSDeveloperPowershell # This is the same as passing in latest .EXAMPLE PS> Invoke-VSDeveloperPowershell -DisplayNameMatch "2017" .EXAMPLE PS> Invoke-VSDeveloperPowershell -DisplayNameMatch "2019" -Verbose .EXAMPLE PS> Invoke-VSDeveloperPowershell -DisplayNameMatch "Visual.*2019" .LINK About vshwere: https://docs.microsoft.com/en-us/visualstudio/install/tools-for-managing-visual-studio-instances?using-vswhereexe .LINK References: https://github.com/Microsoft/vswhere/wiki/Start-Developer-Command-Prompt #> function Invoke-VSDeveloperPowershell { [CmdletBinding()] param ( [Parameter(ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [string] $DisplayNameMatch = "latest" ) process { Write-Verbose "Scanning for Visual Studio using: $DisplayNameMatch" $vsWhere = "$(${env:ProgramFiles(x86)})\Microsoft Visual Studio\Installer\vswhere.exe" if (!(Test-Path $vsWhere)) { throw "VSWHERE.EXE not found at $vsWhere. This module requires at leat Visual Studio 2017 or greater is installed as it depends upon VSWHERE.EXE" exit -1 } if ($DisplayNameMatch -ieq "latest") { $instance = (. $vsWhere -latest -format json | ConvertFrom-Json) | Select-Object -First 1 } else { $instance = (. $vsWhere -format json | ConvertFrom-Json) ` | Where-Object { $_.displayName -imatch $DisplayNameMatch } } if (!($instance)) { throw "An instance of Visual Studio could not be found using: $DisplayNameMatch" exit -2 } elseif ($instance.GetType().Name -ieq "Object[]" -and $instance.Count -gt 1) { throw "Too many instances of Visual Studio were found using: $DisplayNameMatch, please alter your regex so that it is more selective." exit -3 } $vsDevCmdPath = [System.IO.Path]::Combine($instance.installationPath, "Common7\Tools\VsDevCmd.bat") if (!(Test-Path $vsDevCmdPath)) { throw "Could not locate VsDevCmd.bat at: $vsDevCmdPath" exit -4 } Write-Verbose "Found VsDevCmd.bat at $vsDevCmdPath" if ([string]::IsNullOrWhiteSpace($env:VSCMD_VER)) { & "$env:comspec" /s /c "`"$($instance.installationPath)\Common7\Tools\vsdevcmd.bat`" && set" | foreach-object { if ($_ -match "=") { $name, $value = $_ -split '=', 2 Write-Verbose "SETTING $name=$value" Set-Content env:\"$name" $value } else { $_ } } } else { Write-Warning "Visual Studio Developer Command Prompt v$($env:VSCMD_VER) is already installed" } } } |