Azure Pipeline自托管代理运行PowerShell脚本提示创建管道出错如何排查

• PowerShell版本冲突：Visual Studio 2022 Preview 5会自带安装PowerShell 7.x预览版本，或是修改系统PowerShell模块路径的优先级。Azure自托管代理默认调用的PowerShell版本可能和本地手动启动的版本不一致，可在流水线脚本开头添加$PSVersionTable输出版本信息，和本地运行的结果对比排查差异。
• 配置文件加载异常：Azure代理运行PowerShell时默认会加载代理服务账户对应的PowerShell profile配置，和本地运行时使用的登录用户profile不是同一个文件。VS2022安装过程中可能修改了系统级别的PowerShell profile（如$PROFILE.AllUsersAllHosts），引入了和代理运行环境不兼容的指令。可修改流水线PowerShell任务的启动参数，添加-NoProfile跳过profile加载，测试能否正常运行。
• 系统环境变量变更：VS2022安装时会修改PATH、PSModulePath等系统环境变量，你安装后首次重启代理还在使用旧的环境变量缓存所以运行正常，后续代理服务重启或机器二次重启后，代理加载了更新后的环境变量，可能导致模块搜索路径冲突、同名模块不同版本优先级错乱。可在脚本开头添加$env:PSModulePath输出，和本地运行的结果对比排查异常路径。
• 跨架构执行策略差异：64位和32位PowerShell的执行策略是独立配置的，如果你只修改了64位PowerShell的执行策略为Unrestricted，而Azure代理调用的是32位PowerShell，依然会触发策略相关的报错。可分别打开C:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell.exe（32位）和C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe（64位），运行Get-ExecutionPolicy确认两边的执行策略配置是否一致。

内容的提问来源于stack exchange，提问作者K. B.