Azure Pipeline：将System.Debug传递给PowerShell开关参数的问题

错误原因 #

当未勾选“启用系统诊断”时，System.Debug变量不存在，此时$$(System.Debug)会被Azure Pipeline解析为$(System.Debug)字符串，而PowerShell中$(System.Debug)属于无效的子表达式语法，直接触发解析报错。

可行解决方案 #

方案1：在Pipeline YAML层处理默认值，传递明确的布尔字符串 #

在调用pwsh脚本时，通过Pipeline表达式直接处理System.Debug的存在性，给参数赋明确的True/False值：

steps:
- pwsh: ./your-script.ps1
  arguments: '-isDebug:${{ coalesce(variables['System.Debug'], ''False'') }}'

或者用条件判断更直观：

steps:
- pwsh: ./your-script.ps1
  arguments: >
    -isDebug:${{ 
        if eq(variables['System.Debug'], 'True') { 
            'True' 
        } else { 
            'False' 
        }
    }}

然后在脚本中直接声明布尔类型的参数，PowerShell会自动将字符串转换为布尔值：

param(
    [bool]$isDebug
)

# 直接使用$isDebug即可，已正确解析为布尔值
Write-Host "Debug mode: $isDebug"

方案2：在PowerShell脚本中通过环境变量判断 #

Azure Pipeline的预定义变量会自动映射为环境变量（变量名转为大写，点号替换为下划线），因此可以直接读取$env:SYSTEM_DEBUG，变量不存在时该值为$null，不会触发语法错误：

$isDebug = $false
if ($env:SYSTEM_DEBUG -eq 'True') {
    $isDebug = $true
}

# 后续逻辑使用$isDebug
Write-Host "Debug mode: $isDebug"

方案3：简化脚本参数接收逻辑 #

如果直接传递变量，也可以在脚本中通过参数默认值处理：

param(
    [string]$isDebugInput = ''
)

$isDebug = $isDebugInput -eq 'True'

然后在Pipeline中传递参数时，直接用-isDebugInput:$(System.Debug)，当变量不存在时，$(System.Debug)会被替换为空字符串，脚本中判断空字符串不等于True，自然赋值为$false。

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