Azure DevOps调用PowerShell脚本时布尔参数转换失败求助

1. 先修复PowerShell命令换行的反引号问题 #

你的脚本里的换行反引号`后面可能存在空格或制表符，这会导致PowerShell无法正确识别换行，进而把参数解析混乱，出现看似无关的类型转换错误。

修复方式：确保每个反引号是所在行的**最后一个字符**，后面不能有任何空格、制表符或其他字符。同时建议把--isReady和--isShared`拆分成单独行，避免参数挤在一行导致解析异常：

. ./powershells/az-create-pp-service-connection.ps1
write-host "File loaded"
New-Service-Connection-Object `
--clientId $(serviceConnection.clientId) `
--clientSecret $(serviceConnection.clientSecret) `
--tenantId $(serviceConnection.tenantId) `
--url $(dataverseUrl) `
--authorizationScheme $(serviceConnection.AuthorizationScheme) `
--isReady $(serviceConnection.IsReady) `
--isShared $(serviceConnection.IsShared) `
--serviceConnectionName $(serviceConnection.Name) `
--type $(serviceConnection.Type) `
--description $(serviceConnection.Description)

2. 显式转换Azure DevOps布尔变量的类型 #

Azure DevOps中所有流水线变量传递到PowerShell时都是字符串类型，哪怕你在变量里设置的是布尔值，传递过来的也是"True"或"false"这样的字符串，而PowerShell的[bool]参数无法自动将这类字符串转换为布尔值，必须显式转换。

方法一：直接在参数中转换 #

. ./powershells/az-create-pp-service-connection.ps1
write-host "File loaded"
New-Service-Connection-Object `
--clientId $(serviceConnection.clientId) `
--clientSecret $(serviceConnection.clientSecret) `
--tenantId $(serviceConnection.tenantId) `
--url $(dataverseUrl) `
--authorizationScheme $(serviceConnection.AuthorizationScheme) `
--isReady $([bool]::Parse("$(serviceConnection.IsReady)")) `
--isShared $([bool]::Parse("$(serviceConnection.IsShared)")) `
--serviceConnectionName $(serviceConnection.Name) `
--type $(serviceConnection.Type) `
--description $(serviceConnection.Description)

如果变量可能为空（因为isReady是可选参数），可以加空值判断避免转换报错：

. ./powershells/az-create-pp-service-connection.ps1
write-host "File loaded"

$isReady = if ("$(serviceConnection.IsReady)" -ne '') { [bool]::Parse("$(serviceConnection.IsReady)") } else { $null }
$isShared = if ("$(serviceConnection.IsShared)" -ne '') { [bool]::Parse("$(serviceConnection.IsShared)") } else { $null }

New-Service-Connection-Object `
--clientId $(serviceConnection.clientId) `
--clientSecret $(serviceConnection.clientSecret) `
--tenantId $(serviceConnection.tenantId) `
--url $(dataverseUrl) `
--authorizationScheme $(serviceConnection.AuthorizationScheme) `
@(if ($isReady -ne $null) { @('--isReady', $isReady) }) `
@(if ($isShared -ne $null) { @('--isShared', $isShared) }) `
--serviceConnectionName $(serviceConnection.Name) `
--type $(serviceConnection.Type) `
--description $(serviceConnection.Description)

方法二：修改函数参数的类型兼容 #

如果不想每次调用都手动转换，可以修改函数的参数定义，允许接受字符串并在内部转换：

function New-Service-Connection-Object
{
    param(
        [Parameter(Mandatory)] [string] $clientId,
        [Parameter(Mandatory)] [string] $clientSecret,
        [Parameter(Mandatory)] [string] $tenantId,
        [Parameter(Mandatory)] [string] $url,
        [Parameter(Mandatory)] [string] $authorizationScheme,
        [Parameter()] [ValidateSet('True','False','true','false',0,1)] $isReady,
        [Parameter()] [ValidateSet('True','False','true','false',0,1)] $isShared,
        [Parameter(Mandatory)] [string] $serviceConnectionName,
        [Parameter(Mandatory)] [string] $type,
        [Parameter()] [string] $description
    )
    # 内部转换为布尔值
    $isReadyBool = [bool]::Parse($isReady)
    $isSharedBool = [bool]::Parse($isShared)
    # 省略后续代码
}

3. 验证变量传递的实际值 #

可以在调用函数前添加打印语句，确认变量的实际内容和类型，排查是否存在空值或非预期的字符串：

. ./powershells/az-create-pp-service-connection.ps1
write-host "File loaded"
write-host "IsReady 值: '$(serviceConnection.IsReady)'，类型: $((Get-Variable -Name 'serviceConnection.IsReady' -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Value).GetType().Name)"
write-host "IsShared 值: '$(serviceConnection.IsShared)'，类型: $((Get-Variable -Name 'serviceConnection.IsShared' -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Value).GetType().Name)"

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