Invoke-Command

Invoke-Command [-ScriptBlock] <scriptblock> [[-ComputerName] <string[]>] [-ApplicationName <string>] [-AsJob] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-HideComputerName] [-JobName <string>] [-Port <int>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [-UseSSL] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-FilePath] <string> [[-ComputerName] <string[]>] [-ApplicationName <string>] [-AsJob] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-ConfigurationName <string>] [-Credential <PSCredential>] [-HideComputerName] [-JobName <string>] [-Port <int>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [-UseSSL] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-FilePath] <string> [[-Session] <PSSession[]>] [-AsJob] [-HideComputerName] [-JobName <string>] [-ThrottleLimit <int>] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-FilePath] <string> [[-ConnectionURI] <Uri[]>] [-AllowRedirection] [-AsJob] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-ConfigurationName <string>] [-Credential <PSCredential>] [-HideComputerName] [-JobName <string>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-ScriptBlock] <scriptblock> [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-ScriptBlock] <scriptblock> [[-Session] <PSSession[]>] [-AsJob] [-HideComputerName] [-JobName <string>] [-ThrottleLimit <int>] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

Invoke-Command [-ScriptBlock] <scriptblock> [[-ConnectionURI] <Uri[]>] [-AllowRedirection] [-AsJob] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-HideComputerName] [-JobName <string>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [-ArgumentList <Object[]>] [-InputObject <psobject>] [<CommonParameters>]

C:\PS>invoke-command -filepath c:\scripts\test.ps1 -computerName Server01

Disks: C:, D:, E:
Status: Warning, Normal, Normal

描述
-----------
這個命令會在 Server01 電腦上執行 Test.ps1 指令碼。

此命令會使用 FilePath 參數來指定位於本機電腦上的指令碼。這個指令碼會在遠端電腦上執行，而且結果會傳回本機電腦。

C:\PS>invoke-command -computername server01 -credential domain01\user01 -scriptblock {get-culture}

描述
-----------
這個命令會在 Server01 遠端電腦執行 Get-Culture 命令。

它會使用 ComputerName 參數指定電腦名稱，並使用 Credential 參數在 "Domain01\User01" (具有執行命令之權限的使用者) 的安全內容中執行命令。此外，它還會使用 ScriptBlock 參數指定要在遠端電腦執行的命令。

Windows PowerShell 會顯示對話方塊，要求 User01 帳戶的密碼與驗證方法，以示回應。接著，它會在 Server01 遠端電腦執行命令並傳回結果。

C:\PS>$s = new-pssession -computername server02 -credential domain01\user01

C:\PS> invoke-command -session $s -scriptblock {get-culture}

描述
-----------
此範例會在 Server02 遠端電腦的工作階段 (固定連線) 中執行相同的 "Get-Culture" 命令。通常只有在遠端電腦執行一系列命令時，您才會建立工作階段。

第一個命令會使用 New-PSSession Cmdlet，在 Server02 遠端電腦建立工作階段，然後將工作階段儲存在 $s 變數中。

第二個命令會使用 Invoke-Command Cmdlet，在 Server02 執行 Get-Culture 命令，並使用 Session 參數指定儲存在 $s 變數中的工作階段。

Windows PowerShell 會在 Server02 電腦的工作階段中執行命令，以示回應。

C:\PS>invoke-command -computername Server02 -scriptblock {$p = get-process powershell}

C:\PS> invoke-command -computername Server02 -scriptblock {$p.virtualmemorysize}
C:\PS>

C:\PS> $s = new-pssession -computername Server02
C:\PS> invoke-command -session $s -scriptblock {$p = get-process powershell}
C:\PS> invoke-command -session $s -scriptblock {$p.virtualmemorysize}
17930240

描述
-----------
這個範例會比較使用 Invoke-Command 之 ComputerName 和 Session 參數的效果。其中顯示如何使用工作階段，執行共用相同資料的一系列命令。

前兩個命令會使用 Invoke-Command 的 ComputerName 參數，在 Server02 遠端電腦執行命令。第一個命令會使用 Get-Process 命令取得遠端電腦的 PowerShell 處理序，並將它儲存在 $p 變數中。第二個命令則會取得 PowerShell 處理序的 VirtualMemorySize 屬性值。

第一個命令執行成功，但第二個命令執行失敗，因為當您使用 ComputerName 參數時，Windows PowerShell 建立的連線只會執行命令，然後再於命令完成後關閉該連線。$p 變數是在一個連線中建立，但是在針對第二個命令所建立的連線中，這個變數並不存在。

解決這個問題的方法是在遠端電腦上建立工作階段 (固定連線)，並在相同的工作階段中執行這兩個相關命令。

第三個命令會使用 New-PSSession Cmdlet，在 Server02 電腦建立工作階段，然後將工作階段儲存在 $s 變數中。第四和第五個命令會重複第一個集合中使用的一系列命令，但是這次 Invoke-Command 命令會使用 Session 參數，在相同的工作階段中執行這兩個命令。

這次由於兩個命令是在相同的工作階段中執行，因此命令會執行成功，而且 $p 值在 $s 工作階段中將持續作用，以供日後使用。

C:\PS>$command = { get-eventlog -log "windows powershell" | where {$_.message -like "*certificate*"} }

C:\PS> invoke-command -computername S1, S2 -scriptblock $command

描述
-----------
在這個範例中，會示範如何輸入儲存在本機變數中的命令。

當整個命令都儲存在本機變數時，您可以指定該變數做為 ScriptBlock 參數的值。您不需要使用 "param" 關鍵字或 ArgumentList 變數來提交本機變數的值。

第一個命令會將 Get-Eventlog 命令儲存在 $command 變數中。這個命令的格式會做為指令碼區塊。

第二個命令會使用 Invoke-Command Cmdlet，在 S1 和 S2 遠端電腦執行 $command 中的命令。

C:\PS>invoke-command -computername server01, server02, TST-0143, localhost -configurationname MySession.PowerShell -scriptblock {get-eventlog "windows powershell"}

描述
-----------
在這個範例中，會示範如何使用 Invoke-Command Cmdlet 在多部電腦執行單一命令。

此命令會使用 ComputerName 參數來指定這些電腦。這些電腦的名稱會以逗號分隔清單來呈現。電腦清單包括 "localhost" 值，代表本機電腦。

這個命令會使用 ConfigurationName 參數來指定 Windows PowerShell 的其他工作階段設定，並使用 ScriptBlock 參數來指定命令。

在這個範例中，指令碼區塊中的命令會取得每一部遠端電腦上 Windows PowerShell 事件記錄檔中的事件。

C:\PS>$version = invoke-command -computername (get-content machines.txt) -scriptblock {(get-host).version}

描述
-----------
這個命令會取得在 200 部遠端電腦執行之 Windows PowerShell 主機的版本。

由於執行的命令只有一個，因此不需要建立與每一台電腦的固定連線 (工作階段)。所以，此命令會使用 ComputerName 參數來指定電腦。

這個命令會使用 Invoke-Command Cmdlet 來執行 Get-Host 命令，並使用點標記法取得 Windows PowerShell 主機的 Version 屬性。

為了指定電腦，它會使用 Get-Content Cmdlet 取得 Machine.txt 檔案 (電腦名稱的檔案) 的內容。

這些命令會同步執行 (一次執行一個)。當命令執行完畢後，所有電腦的命令輸出都會儲存在 $version 變數中。輸出中包括產生這些資料的來源電腦名稱。

C:\PS>$s = new-pssession -computername Server01, Server02

C:\PS> invoke-command -session $s -scriptblock {get-eventlog system} -AsJob

Id   Name    State      HasMoreData   Location           Command
---  ----    -----      -----         -----------        --------             -------
1    Job1    Running    True          Server01,Server02  get-eventlog system


C:\PS> $j = Get-Job

C:\PS> $j | format-list -property *

HasMoreData   : True
StatusMessage :
Location      : Server01,Server02
Command       : get-eventlog system
JobStateInfo  : Running
Finished      : System.Threading.ManualResetEvent
InstanceId    : e124bb59-8cb2-498b-a0d2-2e07d4e030ca
Id            : 1
Name          : Job1
ChildJobs     : {Job2, Job3}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :

C:\PS> $results = $j | Receive-Job

描述
-----------
這些命令會在兩部遠端電腦上執行背景工作。因為 Invoke-Command 命令會使用 AsJob 參數，所以雖然這些命令在遠端電腦上執行，不過工作實際上位於本機電腦，而且結果會傳送至本機電腦。

第一個命令會使用 New-PSSession Cmdlet，在 Server01 和 Server02 遠端電腦建立工作階段。

第二個命令會使用 Invoke-Command Cmdlet，在每個工作階段中執行背景工作。這個命令會使用 AsJob 參數，將命令當做背景工作來執行。它會傳回工作物件，其中包含兩個子工作物件，分別表示兩部遠端電腦執行的每一項工作。

第三個命令會使用 Get-Job 命令將工作物件儲存在 $j 變數中。

第四個命令會使用管線運算子 (|)，將 $j 變數的值傳送至 Format-List Cmdlet，並由後者將此工作的所有屬性顯示在清單中。

第五個命令會取得工作的結果。它會經由管道，將 $j 中的工作物件輸出至 Receive-Job Cmdlet，並將結果儲存在 $results 變數中。

C:\PS>$MWFO-LOg = Microsoft-Windows-Forwarding/Operational

C:\PS> invoke-command -computername server01 -scriptblock {param($log, $num) get-eventlog -logname $log -newest $num} -ArgumentList $MWFO-log, 10

描述
-----------
在這個範例中，會示範如何將本機變數的值加入在遠端電腦執行的命令中。

第一個命令會將 Microsoft-Windows-Forwarding/Operational 事件記錄檔的名稱儲存在 $MWFO-Log 變數中。

第二個命令會使用 Invoke-Command Cmdlet在 Server01 遠端電腦執行 Get-EventLog 命令，以便從 Server01 的 Microsoft-Windows-Forwarding/Operational 事件記錄檔中取得最新的 10 個事件。

這個命令會使用 "param" 關鍵字建立 $log 和 $num 兩個變數，做為 Get-EventLog 命令中的預留位置使用。這些預留位置具有任意名稱，不必符合提供其值之本機變數的名稱。

ArgumentList 參數的值示範兩種在引數清單中指定值的不同方法。$log 預留位置的值是在第一個命令中定義的 $MFWO-Log 變數。$num 變數的值是 10。

命令在傳送到遠端電腦之前，這些變數都會被取代成指定的值。

C:\PS>invoke-command -computername S1, S2 -scriptblock {get-process powershell} 

PSComputerName    Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id   ProcessName
--------------    -------  ------    -----      ----- -----   ------     --   -----------
S1                575      15        45100      40988   200     4.68     1392 powershell
S2                777      14        35100      30988   150     3.68     67   powershell


C:\PS> invoke-command -computername S1, S2 -scriptblock {get-process powershell} -HideComputerName

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id   ProcessName
-------  ------    -----      ----- -----   ------     --   -----------
575      15        45100      40988   200     4.68     1392 powershell
777      14        35100      30988   150     3.68     67   powershell

描述
-----------
在這個範例中，會顯示使用 Invoke-Command 之 HideComputerName 參數的效果。

前兩個命令會使用 Invoke-Command Cmdlet 針對 PowerShell 處理序執行 Get-Process 命令。第一個命令的輸出包括 PsComputerName 屬性，而該屬性包含執行命令的電腦名稱。第二個命令會使用 HideComputerName 參數，其輸出並不包括 PsComputerName 一欄。

使用 HideComputerName 參數並不會變更物件。您仍然可以使用各項 Format Cmdlet，顯示所有受影響之物件的 PsComputerName 屬性。

C:\PS>invoke-command -comp (get-content servers.txt) -filepath c:\scripts\sample.ps1 -argumentlist Process, Service

描述
-----------
這個範例會使用 Invoke-Command Cmdlet 在 Servers.txt 檔案列出的所有電腦執行 Sample.ps1 指令碼，並使用 FilePath 參數指定程式碼檔案。即使遠端電腦無法存取指令碼檔案，這個命令也可以讓您在遠端電腦執行指令碼。

提交命令時，便會將 Sample.ps1 檔案的內容複製到指令碼區塊中，而且此指令碼區塊會在每一部遠端電腦執行。這個程序相當於使用 ScriptBlock 參數提交指令碼的內容。

C:\PS>$LiveCred = Get-Credential

C:\PS> Invoke-Command -ConfigurationName Microsoft.Exchange `
         -ConnectionUri https://ps.exchangelabs.com/powershell `
         -Credential $LiveCred  -Authentication Basic `
         -scriptblock {Invoke-Command {Set-Mailbox dan -DisplayName "Dan Park"}

描述
-----------
在這個範例中，會示範如何在 URI (網際網路位址) 所識別的遠端電腦執行命令。此特定範例會在遠端 Exchange 伺服器上執行 Set-Mailbox 命令。命令中的倒引號字元 (`) 是 Windows PowerShell 接續字元。

第一個命令會使用 Get-Credential Cmdlet，將 Windows Live ID 認證儲存在 $LiveCred 變數中。當認證對話方塊出現時，請輸入 Windows Live ID 認證。

第二個命令會使用 Invoke-Command Cmdlet 來執行 Set-Mailbox 命令，並使用 ConfigurationName 參數指定命令應該在使用 Microsoft.Exchange 工作階段設定的工作階段中執行、ConnectionURI 參數指定 Exchange 伺服器端點的 URL、

Credential 參數指定儲存在 $LiveCred 變數中的 Windows Live 認證、AuthenticationMechanism 參數指定使用基本驗證，以及 ScriptBlock 參數指定包含命令的指令碼區塊。

C:\PS>$max = New-PSSessionOption -MaximumRedirection 1

C:\PS> Invoke-Command -ConnectionUri https://ps.exchangelabs.com/powershell `
         -scriptblock {Invoke-Command {Get-Mailbox dan} `
         -AllowRedirection -SessionOption $max

描述
-----------
這個命令會示範如何使用 AllowRedirection 和 SessionOption 參數，在遠端命令中管理 URI 重新導向。

第一個命令會使用 New-PSSessionOption Cmdlet 來建立儲存在 $max 變數中的 PSSessionOpption 物件。此命令會使用 MaximumRedirection 參數，將 PSSessionOption 物件的 MaximumConnectionRedirectionCount 屬性設定為 1。

第二個命令會使用 Invoke-Command Cmdlet，在執行 Microsoft Exchange Server 的遠端伺服器上執行 Get-Mailbox 命令。此外，這個命令會使用 AllowRedirection 參數提供明確權限，以便將連線重新導向到其他端點。它也會使用 SessionOption 參數來指定 $max 變數中的工作階段物件。

因此，如果 ConnectionURI 參數指定的遠端電腦傳回重新導向訊息，Windows PowerShell 會重新導向連線。但是如果新的目的地傳回其他重新導向訊息，便會超過重新導向計數值 1，而導致 Invoke-Command 傳回非終止錯誤。

C:\PS>$so = New-PSSessionOption -SkipCACheck

PS C:\> invoke-command $s { get-hotfix } -SessionOption $so -credential server01\user01

描述
-----------
在這個範例中，會示範如何建立及使用 SessionOption 參數。

第一個命令會使用 New-PSSessionOption Cmdlet 建立工作階段選項，並會將產生的 SessionOption 物件儲存在 $so 參數中。

第二個命令會使用 Invoke-Command Cmdlet 從遠端執行 Get-Hotfix 命令。SessionOption 參數的值是 $so 變數中的 SessionOption 物件。

C:\PS>enable-wsmanCredSSP -delegate server02

C:\PS> connect-wsman Server02

C:\PS> set-item wsman:\server02*\service\auth\credSSP -value $true

C:\PS> $s = new-pssession server02

C:\PS> invoke-command -session $s -script {get-item \\Net03\Scripts\LogFiles.ps1} -authentication credssp -credential domain01\admin01

描述
-----------
這個範例會示範如何從遠端工作階段內部存取網路共用。

此命令要求本機電腦的用戶端設定以及遠端電腦的服務設定都必須啟用 CredSSP 委派。若要執行這個範例中的命令，您必須是本機電腦和遠端電腦上 Administrators 群組的成員。

第一個命令會使用 Enable-WSManCredSSP Cmdlet 來啟用從 Server01 本機電腦到 Server02 遠端電腦的 CredSSP 委派。這個命令會設定本機電腦的 CredSSP 用戶端設定。

第二個命令會使用 Connect-WSman Cmdlet 來連線到 Server02 電腦。這個動作會將 Server02 電腦的節點新增至本機電腦的 WSMan: 磁碟機，讓您檢視和變更 Server02 電腦的 WS-Management 設定。

第三個命令會使用 Set-Item Cmdlet，將 Server02 電腦之 Service 節點中的 CredSSP 項目值變更為 True。這個動作會在遠端電腦的服務設定中啟用 CredSSP。

第四個命令會使用 New-PSSession Cmdlet，在 Server02 電腦上建立 PSSession，並將這個 PSSession 儲存在 $s 變數中。

第五個命令會使用 Invoke-Command Cmdlet，在 $s 的工作階段中執行 Get-Item 命令，以便從 Net03\Scripts 網路共用取得指令碼。此命令會使用 Credential 參數，而且它會使用 Authentication 參數搭配 CredSSP 值。