Invoke-Command 命令使用技巧

■ 上海 崔陽

編者按：在PowerShell 中，Invoke-Command 命令用于在本地或遠程計算機上運行命令，并從命令返回所有輸出，包括錯誤信息。本文筆者通過實踐總結出使用技巧，分享給讀者。

首先，當我們要在本地或遠程計算機上運行一條命令時，我們可以用以下命令行去實現：

In voke-Comm and-Computer Name < MACHINENAME > -Scriptblock {}

其 中，MACHINENAME 是本地或遠程計算機的名字，COMMAND 是 你 要 運 行的 命 令，例 如：Invoke-Command -ComputerName bjbffo 3 0 ads 001 -Script Block {g e tchilditem d:}

通常情況下，你可能需要去執行一系列（多條）的命令才能達到你的操作目標，這時候如果你仍然使用上面的命令形式，每次Invoke 一條命令，你就需要進行一次建立連接和釋放連接的過程。為了提高命令執行速度，降低系統開銷，我們可以引入-Session 參數，如下所示：

In voke-Comm and-Session -Scriptblock {}

這樣你先定義了一個Session 變 量，Session 變量可以重復使 用， 每 次Invoke 一條命令時把Session變量直接加進去就可以使用了，不用重復定義。 例 如：$s = New-PSSession -ComputerName BJBFFO30ADS001

In voke-Comm and-Session $s -ScriptBlock {get-childitem c:}

In voke-Comm and-Session $s -ScriptBlock {get-childitem d:}

在執行Invoke-Command命令時，我們也可以傳入外部參數，通常情況下，我們可以傳入以下類型的參數：

傳入字符串：

Invoke-Command -Scrip tBlock { param([string]$tem) $item } -ArgumentLi st “Hello”

傳入變量：

$somestring = “Hello again!”

Invoke-Command -Scrip tBlock { param([string]$item) $item } -ArgumentL ist $somestring

傳入數組：

In voke-Comm and-ScriptBlock { param([arr ay]$item) $item } -Argume ntList @("Hello", "World")

當傳入數組時，你會發現結果只會返回當前的第一個元素，為了解決這個問題，我們需要在數組前加入一個逗號，引入空數組元素，如下所示：

$array = @("hello","w orld")

In voke-Comm and-ScriptBlock { param([ar ray]$item) $item } -Argu mentList @(,$array)

我們還可以用Invoke-Command 來遠程地執行本 地 的function，這 時候我們要把原來命令行中 的“Scriptblock {}”更 改 為“scriptblock ${function:}”，如下所示：

function Get-ItemsCr eatedLastweek

{

$date = (get-date).AddDays(-7)

$items = Get-ChildIte m D: |?{$_.lastwritetime -gt $date}

return $items

}

Invoke-Command -Compu terName shaffo30lg001 -ScriptBlock ${function:Get-ItemsCreatedLastwee k}

當需要遠程執行的本地function 有參數時，可以有以下幾種執行方式。

當參數為單參數字符串類型時：

function Get-ItemsCre atedByDate

{

param($date)

$items = Get-ChildIt em D: |?{$_.lastwriteti me -gt $date}

return $items

}

Invoke-Command -ComputerName shaffo30lg001 -ScriptBlock ${function:G et-ItemsCreatedByDate} ` -ArgumentList '2019-10-13'

當參數為單參數數組類型時：

function Get-ItemsCr eatedByDate

{

param($locations)$items = @()

foreach($lct in $loca tions)

{

$items += Get-ChildIt em $lct

}

return $items

}

$locations = @("c:","D:")

Invoke-Command -Compu terName shaffo30lg001 -Sc riptBlock ${function:Get-I tems Created By Date} `-ArgumentList @(,$locat ions)

當參數為

多參數類型時：

function Get-exItem

{param($location,$date)

$items = Get-ChildIte m $location |?{$_.lastwri tetime -gt $date}

return $items

}

Invoke-Command -Compu terName shaffo30lg001 -ScriptBlock ${function:G et-exItem} -ArgumentList ` @('D:21V-GalOpsDigicerts','2018-05-23')

當參數類型為數組時：

function Get-ItemsCre atedByDate

{param($date,$locations)

$items = @()

foreach($lct in $loca tions)

{

$items += Get-ChildItem $ lct | ? { $ _ .lastwritetim e -gt $date}

return $items

}

}

$locations = @("c:","d:")

Invoke-Command -Compu terName shaffo30lg001 -ScriptBlock ${function:Get-ItemsCreatedByDate} ` -ArgumentList @('2019-10-10',@(,$locations))

以上是命令的使用技巧，大家可以作為參考，并加以體會和運用。