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 创建一个用于运行该命令的连接。然后，当该命令完成后，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（Internet 地址）标识的远程计算机上运行命令。此特定示例在远程 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 来创建 PSSessionOpption 对象，并将该对象保存在 $max 变量中。该命令使用 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。此操作在本地计算机上的 WSMan: 驱动器中为计算机 Server02 添加一个节点，从而允许您查看和更改计算机 Server02 上的 WS-Management 设置。

第三条命令使用 Set-Item cmdlet 将计算机 Server02 的 Service 节点中 CredSSP 项的值更改为 True。此操作会在远程计算机上的服务设置中启用 CredSSP。

第四条命令使用 New-PSSession cmdlet 在计算机 Server02 上创建一个 PSSession。它将 PSSession 保存在 $s 变量中。

第五条命令使用 Invoke-Command cmdlet 在 $s 中的会话中运行从 Net03\Scripts 网络共享获取脚本的 Get-Item 命令。该命令使用 Credential 参数，并使用值为 CredSSP 的 Authentication 参数。