Receive-Job

구문

Receive-Job
       [-Job] <Job[]>
       [[-Location] <String[]>]
       [-Keep]
       [-NoRecurse]
       [-Force]
       [-Wait]
       [-AutoRemoveJob]
       [-WriteEvents]
       [-WriteJobInResults]
       [<CommonParameters>]

Receive-Job
       [-Job] <Job[]>
       [[-ComputerName] <String[]>]
       [-Keep]
       [-NoRecurse]
       [-Force]
       [-Wait]
       [-AutoRemoveJob]
       [-WriteEvents]
       [-WriteJobInResults]
       [<CommonParameters>]

Receive-Job
       [-Job] <Job[]>
       [[-Session] <PSSession[]>]
       [-Keep]
       [-NoRecurse]
       [-Force]
       [-Wait]
       [-AutoRemoveJob]
       [-WriteEvents]
       [-WriteJobInResults]
       [<CommonParameters>]

Receive-Job
       [-Keep]
       [-NoRecurse]
       [-Force]
       [-Wait]
       [-AutoRemoveJob]
       [-WriteEvents]
       [-WriteJobInResults]
       [-Name] <String[]>
       [<CommonParameters>]

Receive-Job
       [-Keep]
       [-NoRecurse]
       [-Force]
       [-Wait]
       [-AutoRemoveJob]
       [-WriteEvents]
       [-WriteJobInResults]
       [-InstanceId] <Guid[]>
       [<CommonParameters>]

Receive-Job
       [-Keep]
       [-NoRecurse]
       [-Force]
       [-Wait]
       [-AutoRemoveJob]
       [-WriteEvents]
       [-WriteJobInResults]
       [-Id] <Int32[]>
       [<CommonParameters>]

Description

Receive-Job cmdlet은 Start-Job cmdlet 또는 모든 cmdlet의 AsJob 매개 변수를 사용하여 시작한 작업과 같은 PowerShell 백그라운드 작업의 결과를 가져옵니다. 모든 작업의 결과를 가져오거나 이름, ID, 인스턴스 ID, 컴퓨터 이름, 위치 또는 세션 또는 작업 개체를 제출하여 작업을 식별할 수 있습니다.

PowerShell 백그라운드 작업을 시작하면 작업이 시작되지만 결과가 즉시 표시되지는 않습니다. 대신 이 명령은 백그라운드 작업을 나타내는 개체를 반환합니다. 작업 개체는 작업에 대한 유용한 정보를 포함하지만 결과가 포함되지 않습니다. 이 메서드를 사용하면 작업이 실행되는 동안 세션에서 작업을 계속할 수 있습니다. PowerShell의 백그라운드 작업에 대한 자세한 내용은 about_Jobs참조하세요.

Receive-Job cmdlet은 Receive-Job 명령이 제출될 때까지 생성된 결과를 가져옵니다. 결과가 아직 완료되지 않은 경우 추가 Receive-Job 명령을 실행하여 나머지 결과를 가져올 수 있습니다.

기본적으로 작업 결과는 받을 때 시스템에서 삭제되지만 Keep 매개 변수를 사용하여 결과를 다시 받을 수 있도록 저장할 수 있습니다. 작업 결과를 삭제하려면 Keep 매개 변수 없이 Receive-Job 명령을 다시 실행하거나 세션을 닫거나 Remove-Job cmdlet을 사용하여 세션에서 작업을 삭제합니다.

Windows PowerShell 3.0부터 Receive-Job 워크플로 작업 및 예약된 작업의 인스턴스와 같은 사용자 지정 작업 유형의 결과도 가져옵니다. Receive-Job 결과를 사용자 지정 작업 유형으로 가져올 수 있도록 하려면 Import-Module cmdlet을 사용하거나 모듈에서 cmdlet을 사용하거나 가져와서 Receive-Job 명령을 실행하기 전에 사용자 지정 작업 유형을 지원하는 모듈을 세션으로 가져옵니다. 특정 사용자 지정 작업 유형에 대한 자세한 내용은 사용자 지정 작업 유형 기능의 설명서를 참조하세요.

예제

예제 1: 특정 작업에 대한 결과 가져오기

$job = Start-Job -ScriptBlock {Get-Process}
Receive-Job -Job $job

이러한 명령은 Receive-JobJob 매개 변수를 사용하여 특정 작업의 결과를 가져옵니다.

첫 번째 명령은 Start-Job 사용하여 작업을 시작하고 작업 개체를 $job 변수에 저장합니다.

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

예제 2: Keep 매개 변수 사용

$job = Start-Job -ScriptBlock {Get-Service dhcp, fakeservice}
$job | Receive-Job -Keep

Cannot find any service with service name 'fakeservice'.
    + CategoryInfo          : ObjectNotFound: (fakeservice:String) [Get-Service], ServiceCommandException
    + FullyQualifiedErrorId : NoServiceFoundForGivenName,Microsoft.PowerShell.Commands.GetServiceCommand
    + PSComputerName        : localhost

Status   Name               DisplayName
------   ----               -----------
Running  dhcp               DHCP Client

$job | Receive-Job -Keep

Cannot find any service with service name 'fakeservice'.
    + CategoryInfo          : ObjectNotFound: (fakeservice:String) [Get-Service], ServiceCommandException
    + FullyQualifiedErrorId : NoServiceFoundForGivenName,Microsoft.PowerShell.Commands.GetServiceCommand
    + PSComputerName        : localhost

Status   Name               DisplayName
------   ----               -----------
Running  dhcp               DHCP Client

다음은 작업을 $job 변수에 저장하고 작업을 Receive-Job cmdlet으로 파이프하는 예제입니다. 또한 -Keep 매개 변수를 사용하여 집계된 모든 스트림 데이터를 첫 번째 보기 후에 다시 검색할 수 있습니다.

예제 3: 여러 백그라운드 작업의 결과 가져오기

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

또한 AsJob사용하면 PowerShell은 시작된 각 작업에 대한 자식 작업이 포함된 하나의 작업 개체를 반환합니다. 이 경우 작업 개체에는 각 원격 컴퓨터의 각 작업에 대해 하나씩 3개의 자식 작업이 포함됩니다.

# Use the Invoke-Command cmdlet with the -AsJob parameter to start a background job that runs a Get-Service command on three remote computers.
# Store the resulting job object in the $j variable
$j = Invoke-Command -ComputerName Server01, Server02, Server03 -ScriptBlock {Get-Service} -AsJob
# Display the value of the **ChildJobs** property of the job object in $j.
# The display shows that the command created three child jobs, one for the job on each remote computer.
# You could also use the -IncludeChildJobs parameter of the Get-Job cmdlet.
$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

# Use the Receive-Job cmdlet to get the results of just the Job3 child job that ran on the Server02 computer.
# Use the *Keep* parameter to allow you to view the aggregated stream data more than once.
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

예제 4: 여러 원격 컴퓨터에서 백그라운드 작업 결과 가져오기

# Use the New-PSSession cmdlet to create three user-managed PSSessions on three servers, and save the sessions in the $s variable.
$s = New-PSSession -ComputerName Server01, Server02, Server03
# Use Invoke-Command run a Start-Job command in each of the PSSessions in the $s variable.
# The job outputs the ComputerName of each server.
# Save the job objects in the $j variable.
$j = Invoke-Command -Session $s -ScriptBlock {Start-Job -ScriptBlock {$env:COMPUTERNAME}}
# To confirm that these job objects are from the remote machines, run Get-Job to show no local jobs running.
Get-Job



# Display the three job objects in $j.
# Note that the Localhost location is not the local computer, but instead localhost as it relates to the job on each Server.
$j

Id   Name     State      HasMoreData   Location   Command
--   ----     -----      -----------   --------   -------
1    Job1     Completed  True          Localhost  $env:COMPUTERNAME
2    Job2     Completed  True          Localhost  $env:COMPUTERNAME
3    Job3     Completed  True          Localhost  $env:COMPUTERNAME

# Use Invoke-Command to run a Receive-Job command in each of the sessions in the $s variable and save the results in the $Results variable.
# The Receive-Job command must be run in each session because the jobs were run locally on each server.
$results = Invoke-Command -Session $s -ScriptBlock {Receive-Job -Job $Using:j}

Server01
Server02
Server03

이 예제에서는 세 개의 원격 컴퓨터에서 실행되는 백그라운드 작업의 결과를 가져오는 방법을 보여줍니다. 이전 예제와 달리 Invoke-Command 사용하여 Start-Job 명령을 실행하면 실제로 세 대의 컴퓨터 각각에서 3개의 독립적인 작업이 시작되었습니다. 결과적으로 이 명령은 세 개의 다른 컴퓨터에서 로컬로 실행되는 세 개의 작업을 나타내는 세 개의 작업 개체를 반환했습니다.

예제 5: 자식 작업 액세스

-Keep 매개 변수는 다시 볼 수 있도록 작업의 집계된 스트림 상태를 유지합니다. 이 매개 변수가 없으면 작업이 수신될 때 집계된 모든 스트림 데이터가 지워집니다. 자세한 내용은 about_Job_Details 참조하세요.

Start-Job -Name TestJob -ScriptBlock {dir C:\, Z:\}
# Without the Keep parameter, aggregated child job data is displayed once.
# Then destroyed.
Receive-Job -Name TestJob

Directory: C:\

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-r---        1/24/2019   7:11 AM                Program Files
d-r---        2/13/2019   8:32 AM                Program Files (x86)
d-r---        10/3/2018  11:47 AM                Users
d-----         2/7/2019   1:52 AM                Windows
Cannot find drive. A drive with the name 'Z' does not exist.
    + CategoryInfo          : ObjectNotFound: (Z:String) [Get-ChildItem], DriveNotFoundException
    + FullyQualifiedErrorId : DriveNotFound,Microsoft.PowerShell.Commands.GetChildItemCommand
    + PSComputerName        : localhost

# It would seem that the child job data is gone.
Receive-Job -Name TestJob



# Using the object model, you can still retrieve child job data and streams.
$job = Get-Job -Name TestJob
$job.ChildJobs[0].Error

Cannot find drive. A drive with the name 'Z' does not exist.
    + CategoryInfo          : ObjectNotFound: (Z:String) [Get-ChildItem], DriveNotFoundException
    + FullyQualifiedErrorId : DriveNotFound,Microsoft.PowerShell.Commands.GetChildItemCommand
    + PSComputerName        : localhost

매개 변수

-AutoRemoveJob

-ComputerName

-Force

-Id

-InstanceId

-Job

-Keep

-Location

-Name

-NoRecurse

-Session

-Wait

-WriteEvents

-WriteJobInResults

입력

Job

작업 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

PSObject

이 cmdlet은 작업의 명령 결과를 반환합니다.

관련 링크

• Get-Job
• Invoke-Command
• Remove-Job
• Resume-Job
• Start-Job
• Stop-Job
• Suspend-Job
• Wait-Job