命令行与文本处理 / 系统课时
使用 Invoke-Command
使用 Invoke-Command
Invoke-Command 用于把脚本块发送到一台或多台远程主机执行。本课将完成远程参数传递、结果汇总和逐主机失败记录,让批量执行既能返回业务数据,也能保留可追踪的诊断信息。
学习目标
- 理解
Invoke-Command的远程执行与结果返回机制 - 使用
param()和-ArgumentList向远程脚本块传参 - 在部分主机失败时保留成功结果和错误详情
Invoke-Command 的执行模型
使用 -ComputerName 时,本地 PowerShell 通过 WSMan/WinRM 建立临时运行空间,把脚本块和参数交给目标主机;使用 SSH 传输时应改用 -HostName 参数集。命令在远程进程中执行,返回对象会被序列化后传回本地,因此属性通常可继续读取,但原对象的方法不一定保留。

执行前应确认目标主机已启用 PowerShell Remoting,当前账号具备远程权限,并且防火墙、DNS 与认证方式可用。域环境优先使用 Kerberos;工作组环境不要把 TrustedHosts 长期设置为 *,应优先使用 HTTPS 监听器或 SSH 传输。
主示例:传参并保留失败诊断
下面查询两台主机上的 Spooler 服务。示例逐台调用,是为了让每个失败都能准确对应到主机,同时保留其他主机的成功结果。
$computers = @("srv-app-01", "srv-app-02")
$serviceName = "Spooler"
$results = foreach ($computer in $computers) {
try {
Invoke-Command -ComputerName $computer -ScriptBlock {
param([string]$Name)
$service = Get-Service -Name $Name -ErrorAction Stop
[pscustomobject]@{
ComputerName = $env:COMPUTERNAME
ServiceName = $service.Name
Status = [string]$service.Status
Error = $null
}
} -ArgumentList $serviceName -ErrorAction Stop
}
catch {
[pscustomobject]@{
ComputerName = $computer
ServiceName = $serviceName
Status = "Unknown"
Error = $_.Exception.Message
}
}
}
$results | Format-Table -AutoSize预期输出
ComputerName ServiceName Status Error
------------ ----------- ------ -----
SRV-APP-01 Spooler Running
srv-app-02 Spooler Unknown <ERROR_MESSAGE>实际服务状态、主机名大小写和错误文本可能不同。<ERROR_MESSAGE> 表示连接失败、权限不足或服务不存在时的真实异常信息。
参数、并发与返回值边界
param() 配合 -ArgumentList 最适合显式定义参数顺序和类型。也可以在脚本块中使用 $using:变量名 捕获本地值,但它传递的是调用时的值,不会让远程端直接访问本地变量本身。
对多台主机直接使用 Invoke-Command -ComputerName $computers 时,PowerShell 会并发建立远程连接,可通过 -ThrottleLimit 控制并发度。返回结果通常自动包含 PSComputerName,适合区分来源;若业务要求精确记录每台主机的重试次数、阶段和错误,显式构造统一结果对象更容易后续导出 CSV 或写入日志。
远程返回的对象常显示为 Deserialized.<TypeName>。这不是数据丢失,而是跨进程序列化后的表现。后续逻辑应优先依赖属性值,不要假设远程对象的实例方法仍然可调用。