about_Remote_Jobs
Краткое описание
Описание запуска заданий на удаленных компьютерах.
Подробное описание
PowerShell одновременно выполняет команды и сценарии с помощью заданий. Существует три типа заданий, предоставляемых PowerShell для поддержки параллелизма.
RemoteJob
— команды и скрипты выполняются в удаленном сеансе.BackgroundJob
— Команды и скрипты выполняются в отдельном процессе на локальном компьютере. См. дополнительные сведения о заданиях.PSTaskJob
илиThreadJob
— команды и скрипты выполняются в отдельном потоке в одном процессе на локальном компьютере. Дополнительные сведения см. в about_Thread_Jobs.
Удаленное выполнение скриптов на отдельном компьютере или отдельном процессе обеспечивает большую изоляцию. Любые ошибки, возникающие в удаленном задании, не влияют на другие выполняемые задания или родительский сеанс, который запустил задание. Однако уровень удаленного взаимодействия добавляет дополнительные расходы, включая сериализацию объектов. Все объекты сериализуются и десериализируются при передаче между родительским сеансом и удаленным (заданием). Сериализация больших сложных объектов данных может использовать большие объемы вычислительных ресурсов и памяти и передавать большие объемы данных в сеть.
Внимание
Родительский сеанс, созданный заданием, также отслеживает состояние задания и собирает данные конвейера. Дочерний процесс задания завершается родительским процессом после того, как задание достигнет готового состояния. Если родительский сеанс завершается, все выполняемые дочерние задания завершаются вместе со своими дочерними процессами.
Существует два способа обойти эту ситуацию:
- Используется
Invoke-Command
для создания заданий, выполняемых в отключенных сеансах. См. раздел об отсоединяемых процессах этой статьи. - Используется
Start-Process
для создания нового процесса, а не задания. Дополнительные сведения см. в статье Start-Process.
Удаленные задания
Задания можно запускать на удаленных компьютерах с помощью трех различных методов.
Запустите интерактивный сеанс на удаленном компьютере. Затем запустите задание в интерактивном сеансе. Эти процедуры совпадают с выполнением локального задания, хотя все действия выполняются на удаленном компьютере.
Запустите задание на удаленном компьютере, который возвращает результаты на локальный компьютер. Используйте этот метод, если вы хотите собрать результаты заданий и сохранить их в центральном расположении на локальном компьютере.
Запустите задание на удаленном компьютере, который сохраняет результаты на удаленном компьютере. Используйте этот метод, если данные задания более безопасно сохраняются на исходном компьютере.
Запуск задания в интерактивном сеансе
Вы можете запустить интерактивный сеанс с удаленным компьютером, а затем запустить задание во время интерактивного сеанса. Дополнительные сведения об интерактивных сеансах см. в about_Remote и см. в статье Enter-PSSession
.
Процедура запуска задания в интерактивном сеансе почти идентична процедуре запуска фонового задания на локальном компьютере. Однако все операции выполняются на удаленном компьютере, а не на локальном компьютере.
Enter-PSSession
Используйте командлет для запуска интерактивного сеанса с удаленным компьютером. Параметр ComputerNameEnter-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
был запущен.
См. также
PowerShell