about_Jobs
Краткое описание
Предоставляет сведения о том, как фоновые задания PowerShell выполняют команду или выражение в фоновом режиме без взаимодействия с текущим сеансом.
Подробное описание
PowerShell одновременно выполняет команды и сценарии с помощью заданий. Существует три типа заданий, предоставляемых PowerShell для поддержки параллелизма.
RemoteJob
— команды и скрипты выполняются в удаленном сеансе. Дополнительные сведения см. в about_Remote_Jobs.BackgroundJob
— Команды и скрипты выполняются в отдельном процессе на локальном компьютере.PSTaskJob
илиThreadJob
— команды и скрипты выполняются в отдельном потоке в одном процессе на локальном компьютере. Дополнительные сведения см. в about_Thread_Jobs.
Выполнение скриптов удаленно на отдельном компьютере или отдельном процессе обеспечивает большую изоляцию. Любые ошибки, возникающие в удаленном задании, не влияют на другие выполняемые задания или родительский сеанс, который запустил задание. Однако уровень удаленного взаимодействия добавляет дополнительные расходы, включая сериализацию объектов. Все объекты сериализуются и десериализируются при передаче между родительским сеансом и удаленным (заданием). Сериализация больших сложных объектов данных может использовать большие объемы вычислительных ресурсов и памяти и передавать большие объемы данных в сеть.
Задания на основе потоков не так надежны, как удаленные и фоновые задания, так как они выполняются в одном процессе в разных потоках. Если одно задание имеет критическое сообщение об ошибке, которая завершает процесс, все остальные задания в процессе завершаются.
Однако для заданий на основе потоков требуется меньше затрат. Они не используют уровень удаленного взаимодействия или сериализацию. Результирующий объект возвращается в виде ссылок на динамические объекты в текущем сеансе. Без этой нагрузки задания на основе потоков выполняются быстрее и используют меньше ресурсов, чем другие типы заданий.
Внимание
Родительский сеанс, созданный заданием, также отслеживает состояние задания и собирает данные конвейера. Дочерний процесс задания завершается родительским процессом после того, как задание достигнет готового состояния. Если родительский сеанс завершается, все выполняемые дочерние задания завершаются вместе со своими дочерними процессами.
Существует два способа обойти эту ситуацию:
- Используется
Invoke-Command
для создания заданий, выполняемых в отключенных сеансах. Дополнительные сведения см. в about_Remote_Jobs. - Используется
Start-Process
для создания нового процесса, а не задания. Дополнительные сведения см. в статье Start-Process.
Командлеты заданий
Start-Job
— запускает фоновое задание на локальном компьютере.Get-Job
— Получает фоновые задания, запущенные в текущем сеансе.Receive-Job
— возвращает результаты фоновых заданий.Stop-Job
— останавливает фоновое задание.Wait-Job
— подавляет командную строку до завершения одного или всех заданий.Remove-Job
— удаляет фоновое задание.Invoke-Command
— Параметр AsJob создает фоновое задание на удаленном компьютере. Вы можете использоватьInvoke-Command
для удаленного выполнения любой команды задания, в том числеStart-Job
.
Запуск задания на локальном компьютере
Чтобы запустить фоновое задание на локальном компьютере, используйте Start-Job
командлет.
Чтобы написать Start-Job
команду, заключите команду, которая выполняется заданием в фигурных скобках ({}
). Используйте параметр ScriptBlock, чтобы указать команду.
Следующая команда запускает фоновое задание, которое запускает Get-Process
команду на локальном компьютере.
Start-Job -ScriptBlock {Get-Process}
При запуске фонового задания командная строка немедленно возвращается, даже если задание занимает длительное время. Пока задание выполняется, можно продолжать работу с данным сеансом.
Команда Start-Job
возвращает объект, представляющий задание. Объект задания содержит полезные сведения о задании, но он не содержит результаты задания.
Объект задания можно сохранить в переменной, а затем использовать его с другими командлетами задания для управления фоновым заданием. Следующая команда запускает объект задания и сохраняет полученный объект задания в переменной $job
.
$job = Start-Job -ScriptBlock {Get-Process}
Получение объектов задания
Командлет Get-Job
возвращает объекты, представляющие фоновые задания, запущенные в текущем сеансе. Без параметров Get-Job
возвращает все задания, запущенные в текущем сеансе.
Get-Job
Объект задания содержит состояние задания, указывающее, завершено ли задание. Готовое задание имеет состояние "Завершено " или "Не выполнено". Задание также может быть заблокировано или запущено.
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Complete True localhost Get-Process
Объект задания можно сохранить в переменной и использовать его для представления задания в следующей команде. Следующая команда получает задание с идентификатором 1 и сохраняет его в переменной $job
.
$job = Get-Job -Id 1
Получение результатов задания
При запуске фонового задания результаты не отображаются немедленно. Чтобы получить результаты фонового задания, используйте Receive-Job
командлет.
В следующем примере Receive-Job
командлет получает результаты задания с помощью объекта задания в переменной $job
.
Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
668 7 2672 6168 104 32.26 488 csrss
...
Результаты задания можно сохранить в переменной. Следующая команда сохраняет результаты задания в $job
переменной $results
.
$results = Receive-Job -Job $job
Получение и сохранение частичных результатов задания
Командлет Receive-Job
получает результаты фонового задания. Если задание завершено, Receive-Job
возвращает все результаты задания. Если задание по-прежнему выполняется, Receive-Job
получает результаты, созданные до сих пор. Чтобы получить оставшиеся результаты, можно снова выполнить Receive-Job
команды.
По умолчанию удаляет результаты из кэша, Receive-Job
в котором хранятся результаты задания. При повторном запуске Receive-Job
вы получите только новые результаты, полученные после первого запуска.
В следующих командах отображаются результаты Receive-Job
выполнения команд до завершения задания.
C:\PS> Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
C:\PS> Receive-Job -Job $job
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
68 3 2632 664 29 0.36 1388 ccmsetup
749 22 21468 19940 203 122.13 3644 communicator
905 7 2980 2628 34 197.97 424 csrss
1121 25 28408 32940 174 430.14 3048 explorer
Используйте параметр Keep, чтобы предотвратить Receive-Job
удаление возвращаемых результатов задания. В следующих командах показан эффект использования параметра Keep в задании, которое еще не завершено.
C:\PS> Receive-Job -Job $job -Keep
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
C:\PS> Receive-Job -Job $job -Keep
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
103 4 11328 9692 56 1176 audiodg
804 14 12228 14108 100 101.74 1740 CcmExec
68 3 2632 664 29 0.36 1388 ccmsetup
749 22 21468 19940 203 122.13 3644 communicator
905 7 2980 2628 34 197.97 424 csrss
1121 25 28408 32940 174 430.14 3048 explorer
Ожидание результатов
При выполнении команды, которая занимает много времени, можно использовать свойства объекта задания для определения завершения задания. Следующая команда использует Get-Job
объект для получения всех фоновых заданий в текущем сеансе.
Get-Job
Результаты отображаются в таблице. Состояние задания отображается в столбце State .
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Complete True localhost Get-Process
2 Job2 BackgroundJob Running True localhost Get-EventLog -Log ...
3 Job3 BackgroundJob Complete True localhost dir -Path C:\* -Re...
В этом случае свойство State показывает, что задание 2 по-прежнему выполняется. Если вы использовали Receive-Job
командлет для получения результатов задания сейчас, результаты будут неполными. Командлет можно многократно использовать Receive-Job
для получения всех результатов. Используйте свойство State для определения завершения задания.
Можно также использовать параметр Wait командлета Receive-Job
. При использовании этого параметра командлет не возвращает командную строку, пока задание не будет завершено, и все результаты будут доступны.
Можно также использовать Wait-Job
командлет для ожидания любого или всех результатов задания. Wait-Job
позволяет ждать одного или нескольких конкретных заданий или всех заданий.
Следующая команда использует командлет для ожидания задания с идентификатором Wait-Job
10.
Wait-Job -ID 10
В результате запрос PowerShell подавляется до завершения задания.
Вы также можете ждать предопределенного периода времени. Эта команда использует параметр Timeout , чтобы ограничить ожидание до 120 секунд. По истечении срока действия командная строка возвращается, но задание продолжает выполняться в фоновом режиме.
Wait-Job -ID 10 -Timeout 120
Остановка задания
Чтобы остановить фоновое задание, используйте Stop-Job
командлет. Следующая команда запускает задание, чтобы получить каждую запись в журнале событий системы. Он сохраняет объект задания в переменной $job
.
$job = Start-Job -ScriptBlock {Get-EventLog -Log System}
Следующая команда останавливает задание. Он использует оператор конвейера (|
) для отправки $job
задания в переменную Stop-Job
.
$job | Stop-Job
Удаление задания
Чтобы удалить фоновое задание, используйте Remove-Job
командлет. Следующая команда удаляет задание в переменной $job
.
Remove-Job -Job $job
Исследование неудачного задания
Задания могут завершиться сбоем по многим причинам. Объект задания содержит свойство Reason , содержащее сведения о причине сбоя.
В следующем примере запускается задание без необходимых учетных данных.
$job = Start-Job -ScriptBlock {New-Item -Path HKLM:\Software\MyCompany}
Get-Job $job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 BackgroundJob Failed False localhost New-Item -Path HKLM:...
Проверьте свойство Reason, чтобы найти ошибку, из-за которой задание завершилось сбоем.
$job.ChildJobs[0].JobStateInfo.Reason
В этом случае задание завершилось ошибкой, так как удаленный компьютер требует явных учетных данных для выполнения команды. Свойство Reason содержит следующее сообщение:
Подключение сбой удаленного сервера со следующим сообщением об ошибке: "Доступ запрещен".
См. также
PowerShell