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 для получения результатов конкретного задания. Первая команда запускает задание, выполняющее команду "Get-Process", с помощью командлета Start-Job. Команда использует оператор присваивания (=) для сохранения результирующего объекта задания в переменной $job.

Вторая команда использует командлет Receive-Job для получения результатов задания. Для указания задания используется параметр Job.

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

C:\PS> $job | receive-job

Описание
-----------
Этот пример очень напоминает пример 2, отличие заключается в использовании оператора конвейера (|) для отправки объекта задания командлету Receive-Job. В результате операции команде не обязательно использовать параметра 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

Описание
-----------
Эти команды используют параметр Name командлета команды Receive-Job для получения результатов одного из нескольких фоновых заданий, выполняющихся на удаленных компьютерах. 

Первая команда с помощью командлета Invoke-Command запускает на трех удаленных компьютерах фоновое задание, выполняющее команду Get-Service. Параметр AsJob используется для выполнения команды в качестве фонового задания. Полученный объект задания сохраняется в переменной $j.

При использовании параметра AsJob командлета Invoke-Command для запуска задания объект задания создается на локальном компьютере, даже если само задание выполняется на удаленных компьютерах. Поэтому для управления заданием можно использовать локальные команды.

Также при использовании AsJob Windows PowerShell возвращает один объект задания, содержащий дочернее задание для каждого из запущенных заданий. В этом случае объект задания содержит три дочерних задания, по одному для каждого из заданий на каждом из удаленных компьютеров.

Вторая команда использует обращение через точку для отображения значения свойства ChildJobs объекта задания, сохраненного в переменной $j. Выходные данные показывают, что команда создала три дочерних задания, по одному заданию на каждом из удаленных компьютеров.
 
Третья команда использует командлет Receive-Job для получения результатов дочернего задания Job3, которое выполняется на компьютере Server02. Параметр 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 для создания трех сеансов PSSession, по одному на каждом из удаленных серверов, указанных в команде. Она сохраняет сеансы PSSession в переменной $s.

Вторая команда использует командлет Invoke-Command для выполнения команды Start-Job в каждом из сеансов PSSession, заданных в переменной $s. Задание выполняет команду Get-Eventlog, которая получает события из журнала системных событий. Результаты сохраняются в переменной $j.

Поскольку команда использует командлет Invoke-Command для выполнения команды Start-Job, на трех компьютерах запускаются три независимых задания. Таким образом, команда возвращает три объекта задания, представляющие три задания, которые выполняются на трех разных компьютерах.

Третья команда выводит три объекта задания, сохраненные в переменной $j.  

Четвертая команда использует командлет Invoke-Command для выполнения команды Receive-Job в каждом из сеансов PSSession, заданных в переменной $s, и сохранения результатов в переменной $results.

Поскольку переменная $j является локальной, блок скрипта использует ключевое слово "param" для объявления переменных в команде и параметр ArgumentList для задания значения переменной $j.