如何在Azure DevOps YAML中正确传递订阅名参数给Azure PowerShell？

我的YAML管道配置 #

parameters:
- name: sub_name # name of the subscription; required
  type: string 
  default: false

steps:
  - script: echo "Here is subscription name:" ${{ parameters.sub_name }}
  - task: AzurePowerShell@5
    displayName: 'Launching Main.yml'
    inputs:
      azurePowerShellVersion: LatestVersion
      azureSubscription: My-SPN # 我的服务主体
      ScriptType: 'FilePath'
      ScriptPath: '$(System.DefaultWorkingDirectory)/MyPowerShell.ps1'
      ScriptArguments: -sub_name ${{ parameters.sub_name  }}

PowerShell脚本（MyPowerShell.ps1）内容 #

$SID=(Get-AzSubscription -SubscriptionName $sub_name).id

运行时错误信息 #

##[error]Subscription AzureSubcription1 was not found in tenant . Please verify that the subscription exists in this tenant.
##[error]PowerShell exited with code '1'.

测试对比 #

如果直接在脚本内硬编码订阅名称，就能正常运行：

$sub_name=AzureSubcription1 
$SID=(Get-AzSubscription -SubscriptionName $sub_name).id

Get-AzSubscription命令相关文档说明 #

-SubscriptionId <System.String>
        Specifies the ID of the subscription to get.

        Required?                    false
        Position?                    named
        Default value                None
        Accept pipeline input?       True (ByPropertyName)
        Accept wildcard characters?  false

疑问 #

我哪里操作出错了？本地PowerShell 5环境运行相同代码正常，试过用Out-String -InputObject $sub_name也没解决问题。

问题原因及解决方案 #

1. 脚本未声明参数：你的PowerShell脚本直接使用$sub_name变量，但没有通过param()块显式声明参数，导致管道传递的参数无法正确绑定到变量。修改脚本：

param(
    [Parameter(Mandatory=$true)]
    [string]$sub_name
)

$SID=(Get-AzSubscription -SubscriptionName $sub_name).id

2. 参数传递需加引号：如果订阅名称包含空格或特殊字符，未加引号会导致参数被截断。修改YAML中的ScriptArguments，给参数值加上双引号：

ScriptArguments: '-sub_name "${{ parameters.sub_name }}"'

3. 验证参数值正确性：在脚本开头添加调试输出，确认接收到的$sub_name是否和预期一致：

param(
    [string]$sub_name
)

Write-Host "接收到的订阅名称: '$sub_name'"
$SID=(Get-AzSubscription -SubscriptionName $sub_name).id

4. 检查服务主体权限：确认管道中使用的服务主体My-SPN有权限访问目标订阅AzureSubcription1，本地运行正常可能是因为使用了你的个人权限，而管道中的SPN没有对应订阅的访问权限。

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