Jenkins向PowerShell脚本传递含空格参数时索引异常的解决方法

1. 先搞定Jenkins侧的参数传递转义 #

shell环境下，带空格的字符串必须用引号包裹才能作为单个参数传递，在Jenkins的sh步骤里要注意引号的转义：

• 用三重单引号包裹sh命令，内部每个参数用单引号括起来，避免Jenkins解析内部引号：

  sh '''pwsh -file script.ps1 \'${params.NAME}\' \'${params.DESCRIPTION}\' \'${params.PEOPLE}\''''
  

• 或者用双引号包裹sh命令，内部参数用转义的双引号：

  sh "pwsh -file script.ps1 \"${params.NAME}\" \"${params.DESCRIPTION}\" \"${params.PEOPLE}\""
  

两种写法都能保证带空格的参数被视为一个整体，不会被shell拆分成多个$args元素。

2. PowerShell脚本里别再用$args索引，改用明确定义的参数 #

依赖$args按索引取参数本身就很脆弱，直接给script.ps1定义参数列表，从根源避免索引错乱：

param(
    [string]$Name,
    [string]$Description,
    [string]$People
)

# 要合并额外变量的话直接加进去
$extraVar = "your-extra-value"
$parameters = @($Name, $Description, $People, $extraVar)

这样不管参数有没有空格，都会被正确赋值到对应的变量，后续处理也更清晰。

3. Invoke-Command传递参数的正确姿势 #

远程脚本块里也别用$args[1]这种写法，两种可靠方式：

方式一：用-ArgumentList+远程脚本块的param定义 #

Invoke-Command -ComputerName "RemoteHost" -ScriptBlock {
    param($remoteName, $remoteDesc, $remotePeople, $remoteExtra)
    # 直接用定义好的变量，不用管索引
    Write-Host "Name: $remoteName"
    Write-Host "Desc: $remoteDesc"
} -ArgumentList $parameters

方式二：用$using:直接引用本地变量（PowerShell 5.1+支持） #

如果远程会话允许，直接用$using:前缀引用本地变量，不用手动传参数：

Invoke-Command -ComputerName "RemoteHost" -ScriptBlock {
    Write-Host "Name: $using:Name"
    Write-Host "Desc: $using:Description"
    Write-Host "Extra: $using:extraVar"
}

4. 快速验证参数是否正确接收 #

在script.ps1开头加几行调试代码，确认参数传递没问题：

# 用param定义参数的情况
Write-Host "Name received: '$Name'"
Write-Host "Description received: '$Description'"

# 仍用$args的临时调试
Write-Host "Total args count: $($args.Count)"
for ($i=0; $i -lt $args.Count; $i++) {
    Write-Host "Arg $i: '$($args[$i])'"
}

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