Add-VsDevPwsh7.ps1
|
<#PSScriptInfo .VERSION 0.0.1 .GUID af7c8e7f-7575-442b-a1ea-ca749eedd0d8 .AUTHOR ScriptForge6 .COMPANYNAME ScriptForge .COPYRIGHT (c) 2026 ScriptForge6. All rights reserved. .TAGS VisualStudio, PowerShell7, Developer, Terminal .LICENSEURI https://github.com/ScriptForge6/Add-VsDevPwsh7/blob/master/LICENSE.txt .PROJECTURI https://github.com/ScriptForge6/Add-VsDevPwsh7 .ICONURI .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES Initial release. Auto-detect Visual Studio via vswhere, generate PowerShell 7 startup script with full build environment. .PRIVATEDATA #> <# .SYNOPSIS Auto PS5.1 Script: PowerShell 7 Developer Terminal for Visual Studio (Win10/11 Only) 自动化PowerShell 5.1脚本：适用于Visual Studio的PowerShell 7开发终端（仅Windows10/11可用） .DESCRIPTION Locate installed Visual Studio instances via vswhere, generate a startup script that loads complete VS build environment for PowerShell 7. Supports registering to Windows Registry and adding dedicated profile to Windows Terminal. 通过 vswhere 检索本机已安装的 Visual Studio，生成加载完整编译环境的 PowerShell 7 启动脚本，支持写入注册表注册程序、向 Windows Terminal 添加专属配置项。 .PARAMETER Vswhere Optional. Specifies the path to vswhere.exe. Defaults to the official default installation path of vswhere. 可选，指定 vswhere.exe 文件路径，默认使用 vswhere 官方默认安装路径。 .PARAMETER OutDir Optional. Directory path for the final generated ps1 script. Defaults to C:\VsDevWithPwsh7. 可选，指定生成后的 ps1 脚本存放目录，默认路径为 C:\VsDevWithPwsh7。 .PARAMETER RegisterToRegistry Optional. When specified, registers the VS PowerShell 7 developer terminal to Windows Registry as an installed application. 可选，指定后会将 VS PowerShell 7 开发者终端写入注册表，注册为已安装程序。 .PARAMETER RegistryName Optional. Specifies the display name shown in Windows Registry and Apps list. Defaults to "Developer PowerShell 7 for VS". 可选，指定在注册表与软件列表中展示的名称，默认为“Developer PowerShell 7 for VS”。 .PARAMETER AddToWindowsTerminal Optional. When specified, adds the VS PowerShell 7 developer terminal profile to Windows Terminal's settings.json. 可选，指定后会将 VS PowerShell 7 开发者终端配置写入 Windows Terminal 的 settings.json。 .PARAMETER WtProfileName Optional. Specifies the display name used in Windows Terminal. If not provided, the value of -RegistryName will be used instead. 可选，指定在 Windows Terminal 中显示的名称；若未传入该参数，则复用 -RegistryName 的值。 .PARAMETER Guid Optional. Specifies the unique GUID identifier for the Windows Terminal profile. A random GUID will be generated if omitted. 可选，指定 Windows Terminal 配置项的唯一标识 GUID，未传入时将随机生成。 #> #一、参数列表 #1.参数列表 [CmdletBinding()] param( # 基础通用参数 [string]$Vswhere = "${env:ProgramFiles(x86)}\Microsoft Visual Studio\Installer\vswhere.exe", [string]$OutDir = "C:\VsDevWithPwsh7", # 注册表注册相关参数 [switch]$RegisterToRegistry, [string]$RegistryName = "Developer PowerShell 7 for VS", # Windows Terminal 配置相关参数 [switch]$AddToWindowsTerminal, [string]$WtProfileName = $RegistryName, [string]$Guid ) #一、初始化 #1.初始化变量 # 初始化Guid if (-not $PSBoundParameters.ContainsKey('Guid')) { $Guid = [guid]::NewGuid().ToString("B") } #2.校验参数使用是否正确 #校验函数： function Test-ParameterDependency { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string]$ChildName, # 子参数名（如 'RegistryName'） [Parameter(Mandatory = $true)] [string]$ParentName, # 父参数名（如 'RegisterToRegistry'） [Parameter(Mandatory = $true)] [switch]$ParentIsPresent, # 父参数是否被指定 [Parameter(Mandatory = $true)] [hashtable]$CallerBoundParameters # 调用方的 $PSBoundParameters，用于检测子参数是否显式传入 ) if ($CallerBoundParameters.ContainsKey($ChildName) -and -not $ParentIsPresent) { Write-Warning "The parameter -$ChildName only takes effect when -$ParentName is specified; the input will be ignored. 参数 -$ChildName 仅在指定 -$ParentName 时生效，当前传入无效" return } return } #校验-RegistryName参数 Test-ParameterDependency -ChildName 'RegistryName' -ParentName 'RegisterToRegistry' -ParentIsPresent:$RegisterToRegistry -CallerBoundParameters $PSBoundParameters #校验-WtProfileName参数 Test-ParameterDependency -ChildName 'WtProfileName' -ParentName 'AddToWindowsTerminal' -ParentIsPresent:$AddToWindowsTerminal -CallerBoundParameters $PSBoundParameters #校验-Guid参数 Test-ParameterDependency -ChildName 'Guid' -ParentName 'AddToWindowsTerminal' -ParentIsPresent:$AddToWindowsTerminal -CallerBoundParameters $PSBoundParameters |