about_Remote_Jobs

Статья
10/04/2023

Краткое описание

Описывается, как выполнять фоновые задания на удаленных компьютерах.

Подробное описание

PowerShell одновременно выполняет команды и сценарии с помощью заданий. Существует три типа заданий, предоставляемых PowerShell для поддержки параллелизма.

RemoteJob — команды и скрипты выполняются в удаленном сеансе.
BackgroundJob — Команды и скрипты выполняются в отдельном процессе на локальном компьютере. См. дополнительные сведения о заданиях.
PSTaskJob или ThreadJob — команды и скрипты выполняются в отдельном потоке в одном процессе на локальном компьютере. Дополнительные сведения см. в about_Thread_Jobs.

Удаленное выполнение скриптов на отдельном компьютере или отдельном процессе обеспечивает большую изоляцию. Любые ошибки, возникающие в удаленном задании, не влияют на другие выполняемые задания или родительский сеанс, который запустил задание. Однако уровень удаленного взаимодействия добавляет дополнительные расходы, включая сериализацию объектов. Все объекты сериализуются и десериализируются при передаче между родительским сеансом и удаленным (заданием). Сериализация больших сложных объектов данных может использовать большие объемы вычислительных ресурсов и памяти и передавать большие объемы данных в сеть.

Внимание

Родительский сеанс, созданный заданием, также отслеживает состояние задания и собирает данные конвейера. Дочерний процесс задания завершается родительским процессом после того, как задание достигнет готового состояния. Если родительский сеанс завершается, все выполняемые дочерние задания завершаются вместе со своими дочерними процессами.

Существует два способа обойти эту ситуацию:

Используется Invoke-Command для создания заданий, выполняемых в отключенных сеансах. См. раздел об отсоединяемых процессах этой статьи.
Используется Start-Process для создания нового процесса, а не задания. Дополнительные сведения см. в статье Start-Process.

Удаленные задания

Задания можно запускать на удаленных компьютерах с помощью трех различных методов.

Запустите интерактивный сеанс на удаленном компьютере. Затем запустите задание в интерактивном сеансе. Эти процедуры совпадают с выполнением локального задания, хотя все действия выполняются на удаленном компьютере.
Запустите задание на удаленном компьютере, который возвращает результаты на локальный компьютер. Используйте этот метод, если вы хотите собрать результаты заданий и сохранить их в центральном расположении на локальном компьютере.
Запустите задание на удаленном компьютере, который сохраняет результаты на удаленном компьютере. Используйте этот метод, если данные задания более безопасно сохраняются на исходном компьютере.

Запуск задания в интерактивном сеансе

Вы можете запустить интерактивный сеанс с удаленным компьютером, а затем запустить задание во время интерактивного сеанса. Дополнительные сведения об интерактивных сеансах см. в about_Remote и см. в статье Enter-PSSession.

Процедура запуска задания в интерактивном сеансе почти идентична процедуре запуска фонового задания на локальном компьютере. Однако все операции выполняются на удаленном компьютере, а не на локальном компьютере.

Enter-PSSession Используйте командлет для запуска интерактивного сеанса с удаленным компьютером. Параметр ComputerName Enter-PSSession можно использовать для установления временного подключения для интерактивного сеанса. Также можно использовать параметр сеанса для запуска интерактивного сеанса в сеансе PowerShell (PSSession).

Следующая команда запускает интерактивный сеанс на компьютере Server01.
```
C:\PS> Enter-PSSession -computername Server01
```
Командная строка изменится, чтобы показать, что вы подключены к компьютеру Server01.
```
Server01\C:>
```
Чтобы запустить удаленное задание в сеансе, используйте Start-Job командлет. Следующая команда запускает удаленное задание, которое получает события в журнале событий Windows PowerShell на компьютере Server01. Командлет Start-Job возвращает объект, представляющий задание.

Эта команда сохраняет объект задания в переменной $job .
```
Server01\C:> $job = Start-Job -scriptblock {
  Get-Eventlog "Windows PowerShell"
}
```
Во время выполнения задания можно использовать интерактивный сеанс для выполнения других команд, включая другие задания. Однако интерактивный сеанс должен оставаться открытым, пока задание не будет завершено. Если завершить сеанс, задание прерывается и результаты теряются.
Чтобы узнать, завершено ли задание, отобразите значение переменной $job или используйте Get-Job командлет для получения задания. Следующая команда использует Get-Job командлет для отображения задания.
```
Server01\C:> Get-Job $job

SessionId  Name  State      HasMoreData  Location   Command
---------  ----  -----      -----------  --------   -------
1          Job1  Complete   True         localhost  Get-Eventlog "Windows...
```
В Get-Job выходных данных показано, что задание выполняется на компьютере localhost, так как задание было запущено и запущено на том же компьютере (в данном случае Server01).
Чтобы получить результаты задания, используйте Receive-Job командлет. Вы можете отобразить результаты в интерактивном сеансе или сохранить их в файле на удаленном компьютере. Следующая команда получает результаты задания в переменной $job. Команда использует оператор перенаправления (>) для сохранения результатов задания в файле PsLog.txt на компьютере Server01.
```
Server01\C:> Receive-Job $job > c:\logs\PsLog.txt
```
Чтобы завершить интерактивный сеанс, используйте Exit-PSSession командлет. Командная строка изменится, чтобы показать, что вы вернулись в исходный сеанс на локальном компьютере.
```
Server01\C:> Exit-PSSession
C:\PS>
```
Чтобы просмотреть содержимое PsLog.txt файла на компьютере Server01 в любое время, запустите другой интерактивный сеанс или выполните удаленную команду. Этот тип команды лучше всего запускать в PSSession (постоянное подключение), если вы хотите использовать несколько команд для изучения данных в PsLog.txt файле и управления ими. Дополнительные сведения о PSSessions см. в about_PSSessions.

Следующие команды используют New-PSSession командлет для создания PSSession , подключенного к компьютеру Server01, и они используют Invoke-Command командлет для выполнения Get-Content команды в PSSession для просмотра содержимого файла.
```
$s = New-PSSession -computername Server01
Invoke-Command -session $s -scriptblock {
  Get-Content c:\logs\pslog.txt}
```

Запустите удаленное задание, которое возвращает результаты на локальный компьютер (AsJob)

Чтобы запустить задание на удаленном компьютере, который возвращает результаты команды локальному компьютеру, используйте параметр AsJob командлета, Invoke-Command например командлета.

При использовании параметра AsJob объект задания фактически создается на локальном компьютере, даже если задание выполняется на удаленном компьютере. После завершения задания результаты возвращаются на локальный компьютер.

Можно использовать командлеты, содержащие существительное задание (командлеты заданий) для управления любым заданием, созданным любым командлетом. Многие командлеты с параметрами AsJob не используют удаленное взаимодействие PowerShell, поэтому их можно использовать даже на компьютерах, которые не настроены для удаленного взаимодействия и не соответствуют требованиям для удаленного взаимодействия.

Следующая команда использует параметр Invoke-Command AsJob для запуска задания на компьютере Server01. Задание выполняет Get-Eventlog команду, которая получает события в системном журнале. Параметр JobName можно использовать для назначения отображаемого имени заданию.
```
Invoke-Command -computername Server01 -scriptblock {
  Get-Eventlog system} -AsJob
```
Результаты команды похожи на следующие примеры выходных данных.
```
SessionId   Name   State    HasMoreData   Location   Command
---------   ----   -----    -----------   --------   -------
1           Job1   Running  True          Server01   Get-Eventlog system
```
При использовании параметра AsJob возвращает тот же тип объекта задания, Invoke-Command который Start-Job возвращается. Объект задания можно сохранить в переменной или использовать Get-Job команду для получения задания.

Обратите внимание, что значение свойства Location показывает, что задание запущено на компьютере Server01.
Чтобы управлять заданием, запущенным с помощью параметра Invoke-Command AsJob командлета, используйте командлеты задания. Так как объект задания, представляющий удаленное задание, находится на локальном компьютере, вам не нужно запускать удаленные команды для управления заданием.

Чтобы определить, завершено ли задание, используйте Get-Job команду. Следующая команда получает все задания, запущенные в текущем сеансе.
```
Get-Job
```
Так как удаленное задание было запущено в текущем сеансе, локальная Get-Job команда получает задание. Свойство State объекта задания показывает, что команда выполнена успешно.
```
SessionId   Name   State      HasMoreData   Location   Command
---------   ----   -----      -----------   --------   -------
1           Job1   Completed  True          Server01   Get-Eventlog system
```
Чтобы получить результаты задания, используйте Receive-Job командлет. Так как результаты задания автоматически возвращаются на компьютер, где находится объект задания, можно получить результаты с помощью локальной Receive-Job команды.

Следующая команда использует Receive-Job командлет для получения результатов задания. Он использует идентификатор сеанса для идентификации задания. Эта команда сохраняет задание в результате $results переменной. Вы также можете перенаправить результаты в файл.
```
$results = Receive-Job -id 1
```

Запуск удаленного задания, которое сохраняет результаты на удаленном компьютере

Чтобы запустить задание на удаленном компьютере, который сохраняет результаты команды на удаленном компьютере, используйте Invoke-Command командлет для выполнения Start-Job команды на удаленном компьютере. Этот метод можно использовать для запуска заданий на нескольких компьютерах.

При удаленном Start-Job выполнении команды объект задания создается на удаленном компьютере, а результаты задания сохраняются на удаленном компьютере. С точки зрения задания все операции являются локальными. Вы просто выполняете команды удаленно для управления локальным заданием на удаленном компьютере.

Invoke-Command Используйте командлет для выполнения Start-Job команды на удаленном компьютере.

Для этой команды требуется psSession (постоянное подключение). Если вы используете параметр Invoke-Command ComputerName для установления временного подключения, Invoke-Command команда считается завершенной при возврате объекта задания. В результате временное подключение закрыто, а задание отменено.

Следующая команда использует New-PSSession командлет для создания PSSession, подключенного к компьютеру Server01. Команда сохраняет PSSession в переменной $s .
```
$s = New-PSSession -computername Server01
```
Следующая команда использует Invoke-Command командлет для выполнения Start-Job команды в PSSession. Команда Start-Job и Get-Eventlog команда заключены в фигурные скобки.
```
Invoke-Command -session $s -scriptblock {
  Start-Job -scriptblock {Get-Eventlog system}}
```
Результаты похожи на приведенные ниже выходные данные.
```
Id       Name    State      HasMoreData     Location   Command
--       ----    -----      -----------     --------   -------
2        Job2    Running    True            Localhost  Get-Eventlog system
```
При удаленном Start-Job выполнении команды возвращает тот же тип объекта задания, Invoke-Command который Start-Job возвращается. Объект задания можно сохранить в переменной или использовать Get-Job команду для получения задания.

Обратите внимание, что значение свойства Location показывает, что задание запущено на локальном компьютере, известном как LocalHost, даже если задание запущено на компьютере Server01. Так как объект задания создается на компьютере Server01 и задание выполняется на том же компьютере, оно считается локальным фоновым заданием.
Для управления удаленным заданием используйте командлеты задания . Так как объект задания находится на удаленном компьютере, необходимо выполнить удаленные команды для получения, остановки, ожидания или получения результатов задания.

Чтобы узнать, завершено ли задание, используйте Invoke-Command команду для выполнения Get-Job команды в PSSession, подключенной к компьютеру Server01.
```
Invoke-Command -session $s -scriptblock {Get-Job}
```
Команда возвращает объект задания. Свойство State объекта задания показывает, что команда выполнена успешно.
```
SessionId   Name  State      HasMoreData   Location   Command
---------   ----  -----      -----------   --------   -------
2           Job2  Completed  True          LocalHost   Get-Eventlog system
```
Чтобы получить результаты задания, используйте Invoke-Command командлет для выполнения Receive-Job команды в PSSession, подключенной к компьютеру Server01.

Следующая команда использует Receive-Job командлет для получения результатов задания. Он использует идентификатор сеанса для идентификации задания. Эта команда сохраняет задание в переменной $results . Он использует параметр Keep для Receive-Job сохранения результата в кэше заданий на удаленном компьютере.
```
$results = Invoke-Command -session $s -scriptblock {
  Receive-Job -SessionId 2 -Keep
}
```
Вы также можете перенаправить результаты в файл на локальном или удаленном компьютере. Следующая команда использует оператор перенаправления для сохранения результатов в файле на компьютере Server01.
```
Invoke-Command -session $s -command {
  Receive-Job -SessionId 2 > c:\logs\pslog.txt
}
```

Запуск в качестве отсоединяемого процесса

Как и ранее упоминание, при завершении родительского сеанса все выполняемые дочерние задания завершаются вместе со своими дочерними процессами. Для выполнения заданий, которые не подключены к текущему сеансу PowerShell, можно использовать удаленное взаимодействие на локальном компьютере.

Создайте новый сеанс PowerShell на локальном компьютере. Использование Invoke-Command для запуска задания в этом сеансе. Invoke-Command позволяет отключить удаленный сеанс и завершить родительский сеанс. Позже вы можете запустить новый сеанс PowerShell и подключиться к ранее отключенном сеансу, чтобы возобновить мониторинг задания. Однако все данные, возвращенные исходному сеансу PowerShell, теряются при завершении этого сеанса. При повторном подключении возвращаются только новые объекты данных, созданные после отключения.

# Create remote session on local machine
PS> $session = New-PSSession -cn localhost

# Start remote job
PS> $job = Invoke-Command -Session $session -ScriptBlock { 1..60 | % { sleep 1; "Output $_" } } -AsJob
PS> $job

Id     Name     PSJobTypeName   State         HasMoreData     Location      Command
--     ----     -------------   -----         -----------     --------      -------
1      Job1     RemoteJob       Running       True            localhost     1..60 | % { sleep 1; ...

# Disconnect the job session
PS> Disconnect-PSSession $session

Id Name         Transport ComputerName    ComputerType    State         ConfigurationName     Availability
-- ----         --------- ------------    ------------    -----         -----------------     ------------
1 Runspace1     WSMan     localhost       RemoteMachine   Disconnected  Microsoft.PowerShell          None

PS> $job

Id     Name     PSJobTypeName   State         HasMoreData     Location      Command
--     ----     -------------   -----         -----------     --------      -------
1      Job1     RemoteJob       Disconnected  True            localhost     1..60 | % { sleep 1;

# Reconnect the session to a new job object
PS> $jobNew = Receive-PSSession -Session $session -OutTarget Job
PS> $job | Wait-Job | Receive-Job
Output 9
Output 10
Output 11
...

В этом примере задания по-прежнему присоединяются к родительскому сеансу PowerShell. Однако родительский сеанс не является исходным сеансом PowerShell, где Invoke-Command был запущен.