PowerShell远程执行时本地变量默认不传递，必须显式传参；推荐用$using:语法传递值，或用-ArgumentList配合param声明；不可直接引用本地变量；函数需转字符串后通过$using:传递并创建执行。
powershell 远程执行时，本地变量默认不会自动传递到远程会话中——因为远程命令在另一台计算机的独立 powershell 进程中运行，作用域完全隔离。要让远程端“知道”本地变量的值，必须显式传递，不能靠作用域继承。
用 $using: 语法传递变量（推荐）
这是最常用、最安全的方式，专为 Invoke-Command 设计。它把本地变量的值序列化后传入远程会话，不依赖远程环境中的同名变量定义。
- 只适用于
-ScriptBlock参数场景（不能用于-FilePath） - 变量名前加
$using:前缀，例如$using:myPath - 支持标量、数组、哈希表等常见类型；复杂对象需可序列化
示例：
powershell$logPath = "C:\Temp\app.log"
$maxEvents = 50
Invoke-Command -ComputerName Server01 -ScriptBlock {
Get-WinEvent -Path $using:logPath -MaxEvents $using:maxEvents
}
通过 -ArgumentList 和 $args 传参
适合需要动态控制参数数量或顺序的场景，也兼容 -FilePath 调用方式。
-
-ArgumentList指定参数列表（按顺序） - 远程脚本块内用
$args[0]、$args[1]等访问，或用param()显式声明 - 比
$using:更灵活，但可读性稍弱
示例（带 param）：
$target = "DC01"
$timeout = 30
Invoke-Command -ComputerName Server01 -ScriptBlock {
param($server, $sec)
Test-Connection -ComputerName $server -Count 1 -TimeoutSeconds $sec
} -ArgumentList $target, $timeout
注意：不要直接写 $localVar 在远程脚本块里
以下写法是错误的，会导致远程端报“变量未定义”：
powershell$name = "Admin"
Invoke-Command -ComputerName Server01 -ScriptBlock {
Write-Host "Hello $name" # ❌ $name 在远程不存在
}
这是因为 $name 是本地作用域变量，远程会话无法访问。PowerShell 不会自动查找或注入同名变量。
进阶：传递函数或脚本块本身
如果本地定义了函数，想在远程复用，可将其转为字符串再用 $using: 传过去，然后用 [scriptblock]::Create() 构建执行：
function Get-LocalTime { Get-Date -Format "yyyy-MM-dd HH:mm" }
$funcStr = ${function:Get-LocalTime}.ToString()
Invoke-Command -ComputerName Server01 -ScriptBlock {
$sb = [scriptblock]::Create($using:funcStr)
& $sb
}
注意：函数内若引用其他本地变量或模块，仍需单独处理；不建议用于含大量依赖的复杂函数。
