Invoke-Command无法传递字符串参数至远程脚本问题排查

这种变量传递失败但字符串字面量正常的情况，核心原因是PowerShell远程会话的作用域隔离——远程VM上的会话无法直接访问你本地会话中的变量，而字面量是直接嵌入脚本块的，所以能被正确解析。下面分两种最常见的原因和对应的解决办法：

1. 本地变量未被注入到远程会话 #

当你在Invoke-Command的脚本块里直接写$SqlLogin时，远程会话会在它自己的上下文中查找这个变量，而不是你本地的那个。这时候需要用$Using:前缀明确告诉PowerShell：“这个变量来自本地会话”。

错误写法： #

Invoke-Command -ComputerName $VMName -ScriptBlock {
    & C:\DiagnosticsCollection_BRB.ps1 -SqlLogin $SqlLogin -SqlPassword $SqlPassword -CollectLocally
}

正确写法（使用$Using:）： #

Invoke-Command -ComputerName $VMName -ScriptBlock {
    & C:\DiagnosticsCollection_BRB.ps1 -SqlLogin $Using:SqlLogin -SqlPassword $Using:SqlPassword -CollectLocally
}

$Using:是PowerShell 3.0及以上版本引入的语法，专门用于跨会话传递变量，它会把本地变量的值“复制”到远程会话的执行上下文中。

2. 替代方案：用-ArgumentList传递参数 #

如果你需要兼容更早的PowerShell版本，可以通过-ArgumentList参数把本地变量作为参数传递给脚本块，然后在脚本块内部通过param()或者$args接收：

示例（用param()接收）： #

Invoke-Command -ComputerName $VMName -ScriptBlock {
    param(
        [string]$LocalSqlLogin,
        [string]$LocalSqlPassword
    )
    & C:\DiagnosticsCollection_BRB.ps1 -SqlLogin $LocalSqlLogin -SqlPassword $LocalSqlPassword -CollectLocally
} -ArgumentList $SqlLogin, $SqlPassword

示例（用$args接收）： #

Invoke-Command -ComputerName $VMName -ScriptBlock {
    & C:\DiagnosticsCollection_BRB.ps1 -SqlLogin $args[0] -SqlPassword $args[1] -CollectLocally
} -ArgumentList $SqlLogin, $SqlPassword

为什么字面量能正常工作？ #

当你直接写-SqlLogin "login"时，这个字符串字面量是直接包含在脚本块代码里的，远程会话执行脚本块时会直接读取这个字符串值，不需要依赖任何外部变量，所以不会有作用域的问题。

额外检查点 #

• 确认本地的$SqlLogin和$SqlPassword变量确实被正确赋值（可以在调用Invoke-Command前用Write-Host $SqlLogin验证）；
• 如果变量包含特殊字符（比如空格、引号），可以用$Using:或者-ArgumentList自动处理转义，不需要手动加引号。

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