將參數傳送至 Windows PowerShell 中的遠端電腦

已完成

除非遠端電腦能解析變數,否則 Invoke-Command 無法在其腳本區塊或腳本檔中包含變數。 幸運的是, Invoke-Command 內建了從本地電腦傳遞資料到遠端電腦的方式。

以下指令旨在顯示每台目標電腦上最新的 10 個安全事件日誌,但照原寫無法運作:

$Log = 'Security'
$Quantity = 10
Invoke-Command –Computer ONE,TWO –ScriptBlock {
  Get-WinEvent –LogName $Log –MaxEvents $Quantity
}

變數 $Log 和 $Quantity 只存在於本地電腦上。 它們的值不會在腳本區塊送回遠端電腦前插入,因此遠端電腦無法解析它們。

使用 ArgumentList 傳遞變數

此命令的正確語法如下:

$Log = 'Security'
$Quantity = 10
Invoke-Command –Computer ONE,TWO –ScriptBlock {
  Param($x,$y) Get-WinEvent –LogName $x –MaxEvents $y
} –ArgumentList $Log,$Quantity

Note

這些範例使用 Get-WinEvent,這是已棄用的 Get-EventLog 指令元的現代替代品。 Get-WinEvent 使用-MaxEvents而不是-Newest來限制結果。

本地變數會傳遞到 -ArgumentListInvoke-Command 的參數。 在腳本區塊內, Param() 區塊宣告的變數數量與 中的 -ArgumentList值相同——在此例中為兩個。 你可以為 Param() 區塊中的變數指派任何名稱。 它們依序從 接收值 -ArgumentList ,因此因為 $Log 是 列在最前面,其值會到 $x,這是 Param() 中的第一個項目。 Param () 區塊變數則在整個腳本區塊中皆可用。

請使用$Using:前綴

此語法適用於 Windows PowerShell 2.0 及更新版本。 Windows PowerShell 3.0 則提供了更簡單的替代方案。 如果你有一個本地變數$variable,想在遠端電腦執行的指令中使用它的值,請使用以下前綴:$Using:

Invoke-Command –ScriptBlock { Do-Something $Using:variable } –ComputerName REMOTE

本地與遠端電腦皆能正確處理$Using:前綴,並將$Using:variable替換為本地$variable的值。