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으로 보냅니다. 이 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의 Microsoft-Windows-Forwarding/Operational 이벤트 로그에서 10개의 최신 이벤트를 가져오는 Get-EventLog 명령을 Server01 원격 컴퓨터에서 실행합니다.

이 명령은 "param" 키워드를 사용하여 Get-EventLog 명령에서 자리 표시자로 사용되는 두 변수 $log 및 $num을 만듭니다. 이러한 자리 표시자에는 값을 제공하는 로컬 변수의 이름과 일치할 필요가 없는 임의의 이름이 있습니다.

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 Server에서 Set-Mailbox 명령을 실행합니다. 명령의 역음(`)은 Windows PowerShell의 연속 문자입니다.

첫 번째 명령은 Get-Credential cmdlet을 사용하여 Windows Live ID 자격 증명을 $LiveCred 변수에 저장합니다. 자격 증명 대화 상자가 나타나면 Windows Live ID 자격 증명을 입력합니다.

두 번째 명령은 Invoke-Command cmdlet을 사용하여 Set-Mailbox 명령을 실행합니다. 이 명령은 ConfigurationName 매개 변수를 사용하여 명령이 Microsoft.Exchange 세션 구성을 사용하는 세션에서 실행되도록 지정합니다. ConnectionURI 매개 변수는 Exchange Server 끝점의 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 변수에 저장되는 PSSessionOption 개체를 만듭니다. 이 명령은 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을 만든 다음 $s 변수에 저장합니다.

다섯 번째 명령은 Invoke-Command cmdlet을 사용하여 세션의 $s에서 Net03\Scripts 네트워크 공유의 스크립트를 가져오는 Get-Item 명령을 실행합니다. 이 명령은 Credential 매개 변수를 사용하며 CredSSP 값과 함께 Authentication 매개 변수를 사용합니다.