如何在Visual Studio 2019中配置使用PowerShell7验证与部署ARM模板

根因说明 #

很多人第一次配置时都会踩这个坑：VS2019的ARM资源组项目触发验证、部署流程时，完全不读取系统层面的.ps1文件默认打开关联配置。它的部署逻辑是写死的：通过固定注册表路径检索PowerShell可执行文件，直接以命令行参数的形式启动脚本进程，根本不会感知你在系统层面给.ps1文件设置的默认打开程序。你之前修改.ps1默认打开方式的操作，只会影响在文件资源管理器里双击打开ps1文件时的关联行为，对VS右键菜单触发的内部部署流程没有任何作用。

具体配置步骤 #

• 第一步：确认PowerShell7的实际安装路径
  常规默认安装的路径为C:\Program Files\PowerShell\7\pwsh.exe，如果是自定义安装路径，请记录实际的可执行文件位置，后续配置时替换对应路径值即可。
• 第二步：修改VS读取PowerShell路径的注册表配置
  打开系统注册表编辑器，定位到项路径：
  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine
  找到右侧的字符串值PowerShellExePath，将原有指向Windows PowerShell 5.x的路径（通常为C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe），替换为你第一步记录的PowerShell7可执行文件完整路径。

  提示：修改该值前请先记录原有路径，如果你后续需要在VS中运行依赖Windows PowerShell 5.x的旧脚本，可以随时切回原配置。

• 第三步：清理项目内的硬编码PowerShell路径引用
  打开你的ARM项目所在目录，检查项目下的以下两类文件：
  • 项目主文件（通常为.csproj格式）
  • 部署相关的配置文件（如.deployment、PublishScripts目录下的启动参数配置）
    排查所有硬编码写死powershell.exe路径的配置项，将其替换为PowerShell7的可执行文件路径，避免VS启动时优先匹配硬编码的旧路径。
• 第四步：校验PowerShell7的环境依赖
  你之前已经将Deploy-AzureResourceGroup.ps1修改为Az模块兼容版本，只需要确保当前PowerShell7环境能正常加载所需模块即可：
  手动打开PowerShell7终端，执行Get-Module Az.Resources -ListAvailable命令，确认Az.Resources模块已正常安装。同时在当前用户范围配置PowerShell7的执行策略，避免脚本被系统拦截，执行命令：
  Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
• 第五步：重启Visual Studio 2019
  所有配置完成后重启VS，重新加载你的ARM项目，右键执行验证、部署操作时，VS就会通过PowerShell7环境加载运行你修改过的Az模块版本的部署脚本。

常见踩坑提醒 #

• 如果你使用的是Visual Studio 2019 16.10及以上的版本，不需要修改注册表：直接打开VS的「工具-选项」面板，定位到「Azure 资源组管理」配置页，直接在PowerShell可执行路径选择框中指向你的pwsh.exe路径即可，这种方式比修改注册表的影响范围更小，不会干扰其他依赖Windows PowerShell5.x的应用。
• 不要在未安装Az模块的PowerShell7环境下直接触发部署：VS调用脚本时会直接在当前pwsh进程中加载模块，没有预装Az模块的话会直接报模块找不到的错误。
• 不要混淆系统文件关联和VS内部调用逻辑：继续修改.ps1文件的默认打开方式对VS内置部署流程没有任何帮助，反而可能影响其他依赖Windows PowerShell打开脚本的工具。

内容的提问来源于stack exchange，提问作者Kaja