Receive-Job

Receive-Job [-Job] <Job[]> [[-ComputerName] <string[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [[-InstanceId] <Guid[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [-Job] <Job[]> [[-Location] <string[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [[-Name] <string[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [-Job] <Job[]> [[-Session] <PSSession[]>] [-Keep] [-NoRecurse] [<CommonParameters>]

Receive-Job [-Id] <Int32[]> [-Keep] [-NoRecurse] [<CommonParameters>]

C:\PS>$job = start-job -scriptblock {get-process}

C:\PS> receive-job -job $job

설명
-----------
이들 명령은 Job 매개 변수를 사용하여 특정 작업의 결과를 가져옵니다. 첫 번째 명령은 Start-Job cmdlet을 사용하여 "Get-Process" 명령을 실행하는 작업을 시작합니다. 이 명령은 할당 연산자(=)를 사용하여 결과 작업 개체를 $job 변수에 저장합니다.

두 번째 명령은 Receive-Job cmdlet을 사용하여 작업의 결과를 가져옵니다. 이 명령은 Job 매개 변수를 사용하여 작업을 지정합니다.

C:\PS>$job = start-job -scriptblock {get-process}

C:\PS> $job | receive-job

설명
-----------
이 예는 명령에서 파이프라인 연산자(|)를 사용하여 작업 개체를 Receive-Job에 보내는 점을 제외하고 예제 2와 동일합니다. 따라서 명령에는 작업을 지정하는 Job 매개 변수가 필요하지 않습니다.

C:\PS>$j = invoke-command -computername Server01, Server02, Server03 -scriptblock {get-service} -AsJob

C:\PS> $j.childjobs

Id   Name     State      HasMoreData   Location       Command
--   ----     -----      -----------   --------       -------
2    Job2     Completed  True          Server01       get-service
3    Job3     Completed  True          Server02       get-service
4    Job4     Completed  True          Server03       get-service

C:\PS> receive-job -name Job3  -keep

Status  Name        DisplayName                        PSComputerName
------  ----------- -----------                        --------------
Running AeLookupSvc Application Experience             Server02
Stopped ALG         Application Layer Gateway Service  Server02
Running Appinfo     Application Information            Server02
Running AppMgmt     Application Management             Server02

설명
-----------
이들 명령은 Receive-Job의 Name 매개 변수를 사용하여 원격 컴퓨터에서 실행되는 몇 가지 백그라운드 작업 중 하나의 결과를 가져옵니다. 

첫 번째 명령은 Invoke-Command cmdlet을 사용하여 세 원격 컴퓨터에서 Get-Service 명령을 실행하는 백그라운드 작업을 시작합니다. 이 명령은 AsJob 매개 변수를 사용하여 명령을 백그라운드 작업으로 실행합니다. 이 명령은 결과 작업 개체를 $j 변수에 저장합니다.

Invoke-Command의 AsJob 매개 변수를 사용하여 작업을 시작하는 경우 작업이 원격 컴퓨터에서 실행되는 경우에도 작업 개체가 로컬 컴퓨터에 만들어집니다. 따라서 로컬 명령을 사용하여 작업을 관리합니다.

또한 AsJob을 사용하는 경우 Windows PowerShell은 시작된 각 작업의 하위 작업이 포함된 작업 개체 하나를 반환합니다. 이 경우 작업 개체에는 각 원격 컴퓨터의 작업마다 하나씩 세 개의 하위 작업이 포함됩니다.

두 번째 명령은 점 방법을 사용하여 작업 개체의 ChildJobs 속성 값을 $j에 표시합니다. 표시에는 각 원격 컴퓨터의 작업에 대해 하나씩, 세 개의 하위 작업이 명령에 의해 만들어졌다고 나타납니다.
 
세 번째 명령은 Receive-Job cmdlet을 사용하여 Server02 컴퓨터에서 실행된 Job3 하위 작업의 결과를 가져옵니다. 이 명령은 Name 매개 변수를 사용하여 하위 작업의 이름을 지정하고 작업 결과를 받은 후에도 Keep 매개 변수를 사용하여 작업 결과를 저장합니다.

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

C:\PS> $j = invoke-command -session $s -scriptblock {start-job -scriptblock {get-eventlog -logname system}}

C:\PS> $j

Id   Name     State      HasMoreData   Location   Command
--   ----     -----      -----------   --------   -------
1    Job1     Completed  True          Localhost  get-eventlog system
2    Job2     Completed  True          Localhost  get-eventlog system
3    Job3     Completed  True          Localhost  get-eventlog system

C:\PS> $results = invoke-command -session $s -scriptblock {param($j) receive-job -job $j} -ArgumentList $j

설명
-----------
이 예에서는 세 개의 원격 컴퓨터에서 실행된 백그라운드 작업의 결과를 가져오는 방법을 보여 줍니다.

첫 번째 명령은 New-PSSession cmdlet을 사용하여 명령에 지정된 서버마다 하나씩 세 개의 PSSession을 만든 다음 $s 변수에 저장합니다.

두 번째 명령은 Invoke-Command cmdlet을 사용하여 $s 변수의 각 PSSession에서 Start-Job 명령을 실행합니다. 이 작업은 시스템 로그에서 이벤트를 가져오는 Get-Eventlog 명령을 실행합니다. 이 명령은 $j 변수에 결과를 저장합니다.

이 명령은 Invoke-Command를 사용하여 Start-Job 명령을 실행했기 때문에 실제로 세 컴퓨터에서 각각 세 개의 독립 작업을 시작했습니다. 따라서 이 명령은 세 컴퓨터에서 로컬로 실행된 세 작업을 나타내는 세 작업 개체를 반환했습니다.

세 번째 명령은 $j에 있는 세 작업 개체를 표시합니다.  

네 번째 명령은 Invoke-Command를 사용하여 $s의 각 PSSession에서 Receive-Job 명령을 실행하고 그 결과를 $results 변수에 저장합니다.

$j가 로컬 변수이기 때문에 스크립트 블록에서 "param" 키워드를 사용하여 명령에서 변수를 선언하고 ArgumentList 매개 변수를 사용하여 $j의 값을 제공합니다.