Azure Pipeline自托管Agent运行脚本时缺失必填参数求助

问题根源 #

你使用的ACR清理脚本中，目标参数（ServicePrincipalId、ServicePrincipalPass等）被标记为Mandatory=$true，即使你在脚本中直接赋值默认值，PowerShell仍会强制要求显式传递这些参数（Mandatory属性优先级高于默认值设置）。另外，Azure Pipeline的Az CLI任务运行脚本时，若未正确配置参数传递逻辑，也会触发该错误。

解决方案一：修改脚本移除参数强制性 #

打开脚本的param定义块，将每个参数的[Parameter(Mandatory=$true)]修改为[Parameter(Mandatory=$false)]，同时保留你设置的默认值。示例：

param(
    [Parameter(Mandatory=$false)]
    [String] $ServicePrincipalId = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    [Parameter(Mandatory=$false)]
    [String] $ServicePrincipalPass = "your-password-here",
    [Parameter(Mandatory=$false)]
    [String] $ServicePrincipalTenant = "your-tenant-id-here",
    [Parameter(Mandatory=$false)]
    [String] $AzureRegistryName = "your-acr-name-here"
    # 其他参数同理修改
)

修改后保存脚本，重新在Pipeline中运行即可。

解决方案二：在Azure Pipeline任务中显式传递参数 #

不修改脚本，而是在Az CLI任务的脚本参数中传入对应值：

• 在Azure Pipeline的Az CLI任务配置界面，找到脚本参数（Script arguments）输入框。
• 按照PowerShell参数传递格式填入参数，示例：

-ServicePrincipalId "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" -ServicePrincipalPass "your-password-here" -ServicePrincipalTenant "your-tenant-id-here" -AzureRegistryName "your-acr-name-here"

• 敏感参数（如ServicePrincipalPass）建议使用Azure Pipeline的变量组或秘密变量存储，避免明文暴露，示例：

-ServicePrincipalId $(SP-ID) -ServicePrincipalPass $(SP-PASS) -ServicePrincipalTenant $(SP-TENANT) -AzureRegistryName $(ACR-NAME)

额外注意事项 #

• 若使用自托管Agent，确保Agent已安装Azure PowerShell模块（Az.Accounts、Az.ContainerRegistry等），脚本运行依赖这些模块。
• 验证服务主体权限：确保你使用的服务主体拥有ACR的Contributor或AcrDelete权限，避免后续清理操作失败。

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