如何在ADO Pipeline中使用PowerShell模块？注册仓库失败求助

1. 替换任务类型：弃用AzurePowerShell@5 #

你当前用的AzurePowerShell@5是专门针对Azure资源操作的任务，它会强制检查Azure PowerShell模块版本，但你没指定azurePowerShellVersion参数，导致版本值为null，触发了报错。你不需要连接Azure订阅来注册PS仓库，直接用普通PowerShell任务即可：

替换为PowerShell@7任务（跨平台兼容）：

steps:
  - task: PowerShell@7
    displayName: 'Register PS Repository & Install Module'
    inputs:
      targetType: 'inline'
      script: |
        # 创建PSCredential对象，ADO用户名可任意填写，PAT作为密码
        $pat = "<你的PAT令牌>"
        $securePat = ConvertTo-SecureString $pat -AsPlainText -Force
        $cred = New-Object System.Management.Automation.PSCredential("dummy-user", $securePat)

        # 注册私有仓库
        Register-PSRepository -Name Axis.DevOpsLib -SourceLocation "$(feed)" -InstallationPolicy Trusted -Credential $cred -Verbose

        # 安装模块
        Install-Module -Name Axis.DevOpsLib -Repository Axis.DevOpsLib -Force -Verbose

2. 修正NuGet源地址格式 #

Azure DevOps私有NuGet源用于PS仓库时，建议用v3版本地址（兼容性更稳定），格式为：
https://pkgs.dev.azure.com/<组织名>/_packaging/<源名>/nuget/v3/index.json

更新变量中的feed值：

variables:
  system.debug: true
  feed: 'https://pkgs.dev.azure.com/<org>/_packaging/Axis-Private/nuget/v3/index.json'

3. 安全存储PAT令牌 #

不要在YAML中明文写PAT，将其存入Azure DevOps的库变量组或流水线秘密变量，通过变量引用：

variables:
  - group: DevOps-Secrets # 假设该组包含名为PAT_SECRET的秘密变量
  system.debug: true
  feed: 'https://pkgs.dev.azure.com/<org>/_packaging/Axis-Private/nuget/v3/index.json'

# 在脚本中引用秘密变量
$pat = "$(PAT_SECRET)"

4. 验证模块打包正确性 #

确保你的NuGet包符合PowerShell模块规范：

• .psd1文件的RootModule属性指向你的.psm1文件
• 包ID与模块名称完全一致（即Axis.DevOpsLib）
• 打包时包含.psm1、.psd1等核心文件，可本地测试安装：

Install-Package -Path .\Axis.DevOpsLib.1.0.0.nupkg -Force

错误根源总结 #

• 误用AzurePowerShell@5任务：该任务默认加载Azure模块，未指定版本导致版本校验失败
• Credential参数格式错误：直接传递JSON字符串而非PSCredential对象
• （可选）源地址版本兼容性：v2源在部分PowerShell版本中存在解析问题

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