about_Job_Details
Краткое описание
Содержит сведения о фоновых заданиях на локальных и удаленных компьютерах.
Подробное описание
В этом разделе объясняется концепция фонового задания и технические сведения о работе фоновых заданий в PowerShell.
Этот раздел является дополнением к темам about_Jobs, about_Thread_Jobs и about_Remote_Jobs .
О фоновых заданиях
Фоновое задание выполняет команду или выражение асинхронно. Он может выполнять командлет, функцию, скрипт или любую другую задачу на основе команд. Он предназначен для выполнения команд, которые занимают длительный период времени, но его можно использовать для выполнения любой команды в фоновом режиме.
Когда выполняется синхронная команда, командная строка PowerShell подавляется до завершения команды. Но фоновое задание не подавляет запрос PowerShell. Команда для запуска фонового задания возвращает объект задания. Запрос возвращается немедленно, чтобы вы могли работать над другими задачами во время выполнения фонового задания.
Однако при запуске фонового задания результаты не получаются сразу, даже если задание выполняется очень быстро. Возвращаемый объект задания содержит полезные сведения о задании, но не содержит результатов задания. Чтобы получить результаты задания, необходимо выполнить отдельную команду. Вы также можете выполнить команды, чтобы остановить задание, дождаться завершения задания и удалить задание.
Чтобы сделать время фонового задания независимо от других команд, каждое фоновое задание выполняется в собственном сеансе PowerShell. Однако это может быть временное соединение, созданное только для запуска задания и затем уничтоженное, или это может быть постоянное подключение PSSession , которое можно использовать для выполнения нескольких связанных заданий или команд.
Использование командлетов заданий
Используйте команду, чтобы запустить фоновое Start-Job задание на локальном компьютере.
Start-Job возвращает объект задания. Можно также получить объекты, представляющие задания, запущенные на локальном компьютере, с помощью командлета Get-Job .
Чтобы получить результаты задания, используйте Receive-Job команду. Если задание не завершено, Receive-Job возвращает частичные результаты. Командлет можно также использовать Wait-Job для подавления командной строки до тех пор, пока не будет завершено одно или все задания, которые были запущены в сеансе.
Чтобы остановить фоновое задание, используйте Stop-Job командлет. Чтобы удалить задание, используйте Remove-Job командлет.
Дополнительные сведения о работе командлетов см. в разделе справки для каждого командлета и about_Jobs.
Запуск фоновых заданий на удаленных компьютерах
Вы можете создавать фоновые задания и управлять ими на локальном или удаленном компьютере. Для удаленного выполнения фонового задания используйте параметр AsJob для командлета, например Invoke-Commandкомандлет, или используйте Invoke-Command командлет для удаленного Start-Job выполнения команды. Вы также можете запустить фоновое задание в интерактивном сеансе.
Дополнительные сведения о удаленных фоновых заданиях см. в about_Remote_Jobs.
Дочерние задания
Каждое фоновое задание состоит из родительского задания и одного или нескольких дочерних заданий. В заданиях, запущенных с помощью Start-Job или параметра Invoke-CommandAsJob, родительское задание является исполнительным. Он не выполняет никаких команд или не возвращает результаты. Команды фактически выполняются дочерними заданиями. Задания, запущенные с помощью других командлетов, могут работать по-другому.
Дочерние задания хранятся в свойстве ChildJobs родительского объекта задания. Свойство ChildJobs может содержать один или несколько дочерних объектов задания. Дочерние объекты задания имеют имя, идентификатор и идентификатор экземпляра , которые отличаются от родительского задания, чтобы управлять родительскими и дочерними заданиями по отдельности или как единицей.
Чтобы получить родительские и дочерние задания задания задания, используйте параметр IncludeChildJobs командлета Get-Job . Параметр IncludeChildJob появился в Windows PowerShell 3.0.
PS> Get-Job -IncludeChildJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 RemoteJob Failed True localhost Get-Process
2 Job2 Completed True Server01 Get-Process
3 Job3 Failed False localhost Get-Process
Чтобы получить родительское задание и только дочерние задания с определенным значением состояния , используйте параметр ChildJobState командлета Get-Job . Параметр ChildJobState появился в Windows PowerShell 3.0.
PS> Get-Job -ChildJobState Failed
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
1 Job1 RemoteJob Failed True localhost Get-Process
3 Job3 Failed False localhost Get-Process
Чтобы получить дочерние задания задания во всех версиях PowerShell, используйте свойство ChildJob родительского задания.
PS> (Get-Job Job1).ChildJobs
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 Job2 Completed True Server01 Get-Process
3 Job3 Failed False localhost Get-Process
Вы также можете использовать Get-Job команду в дочернем задании, как показано в следующей команде:
PS> Get-Job Job3
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
3 Job3 Failed False localhost Get-Process
Конфигурация дочернего задания зависит от команды, используемой для запуска задания.
При запуске
Start-Jobзадания на локальном компьютере задание состоит из исполнительного родительского задания и дочернего задания, выполняющего команду.При использовании параметра
Invoke-CommandAsJob для запуска задания на одном или нескольких компьютерах задание состоит из исполнительного родительского задания и дочернего задания для каждого задания, выполняемого на каждом компьютере.При выполнении
Invoke-CommandStart-Jobкоманды на одном или нескольких удаленных компьютерах результат совпадает с локальной командой, выполняемой на каждом удаленном компьютере. Команда возвращает объект задания для каждого компьютера. Объект задания состоит из исполнительного родительского задания и одного дочернего задания, выполняющего команду.
Родительское задание представляет все дочерние задания. При управлении родительским заданием вы также управляете связанными дочерними заданиями. Например, если остановить родительское задание, все дочерние задания будут остановлены. Если вы получите результаты родительского задания, вы получите результаты всех дочерних заданий.
Однако вы также можете управлять дочерними заданиями по отдельности. Это наиболее полезно, если вы хотите изучить проблему с заданием или получить результаты только одного из нескольких дочерних заданий, запущенных с помощью параметра Invoke-CommandAsJob.
Следующая команда использует параметр AsJob для Invoke-Command запуска фоновых заданий на локальном компьютере и двух удаленных компьютерах. Команда сохраняет задание в переменной $j .
PS> $j = Invoke-Command -ComputerName localhost, Server01, Server02 `
-Command {Get-Date} -AsJob
При отображении свойств задания Name и ChildJob в нем показано, что команда вернула объект задания $jс тремя дочерними заданиями, по одному для каждого компьютера.
PS> $j | Format-List Name, ChildJobs
Name : Job3
ChildJobs : {Job4, Job5, Job6}
При отображении родительского задания он показывает, что задание завершилось сбоем.
PS> $j
Id Name PSJobTypeName State HasMoreData Location
-- ---- ------------- ----- ----------- --------
3 Job3 RemotingJob Failed False localhost,Server...
Но при выполнении Get-Job команды, которая получает дочерние задания, выходные данные показывают, что не удалось выполнить только одно дочернее задание.
PS> Get-Job -IncludeChildJobs
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
3 Job3 RemotingJob Failed False localhost,Server...
4 Job4 Completed True localhost Get-Date
5 Job5 Failed False Server01 Get-Date
6 Job6 Completed True Server02 Get-Date
Чтобы получить результаты всех дочерних заданий, используйте Receive-Job командлет, чтобы получить результаты родительского задания. Но вы также можете получить результаты определенного дочернего задания, как показано в следующей команде.
PS> Receive-Job -Name Job6 -Keep | Format-Table ComputerName,
>> DateTime -AutoSize
ComputerName DateTime
------------ --------
Server02 Thursday, March 13, 2008 4:16:03 PM
Функция дочерних заданий фоновых заданий PowerShell позволяет более контролировать выполняемые задания.
Типы должностей
PowerShell поддерживает различные типы заданий для различных задач. Начиная с Windows PowerShell 3.0 разработчики могут писать "адаптеры источника заданий", которые добавляют новые типы заданий в PowerShell и включают исходные адаптеры заданий в модули. При импорте модуля можно использовать новый тип задания в сеансе.
Например, модуль PSScheduledJob добавляет запланированные задания, а модуль PSWorkflow добавляет задания рабочего процесса.
Пользовательские типы заданий могут значительно отличаться от стандартных фоновых заданий PowerShell. Например, запланированные задания сохраняются на диске; они не существуют только в определенном сеансе. Задания рабочего процесса можно приостановить и возобновить.
Командлеты, используемые для управления пользовательскими заданиями, зависят от типа задания. Для некоторых из этих командлетов используются стандартные командлеты заданий, например Get-Job и Start-Job. Другие приходят с специализированными командлетами, которые управляют только определенным типом задания. Подробные сведения о пользовательских типах заданий см. в разделах справки о типе задания.
Чтобы найти тип задания, используйте Get-Job командлет. Get-Job возвращает различные объекты заданий для различных типов заданий. Значение свойства PSJobTypeName объектов задания, возвращающих Get-Job тип задания.
В следующей таблице перечислены типы заданий, которые входят в PowerShell.
| Тип вакансии | Description |
|---|---|
| Фоновое задание | Начало работы с командлетом Start-Job . |
| RemoteJob | Начало работы с параметром AsJob объекта |
Invoke-Command. |
|
| PSWorkflowJob | Начал использовать параметр AsJob рабочего процесса. |
| PSScheduledJob | Экземпляр запланированного задания, запущенного триггером задания. |
| CIMJob | Начало работы с параметром AsJob командлета из |
| Модуль CDXML. | |
| WMIJob | Начало работы с параметром AsJob командлета из |
| Модуль WMI. | |
| PSEventJob | Создано с помощьюRegister-ObjectEvent и указанием |
| действие с параметром Action . |
ПРИМЕЧАНИЕ. Прежде чем использовать Get-Job командлет для получения заданий определенного типа, убедитесь, что модуль, добавляющий тип задания, импортируется в текущий сеанс.
Get-Job В противном случае не получает задания этого типа.
Примеры
Следующие команды создают локальное фоновое задание, удаленное фоновое задание, задание рабочего процесса и запланированное задание. Затем он использует Get-Job командлет для получения заданий. Get-Job не получает запланированное задание, но получает все экземпляры запланированного задания.
Запустите фоновое задание на локальном компьютере.
PS> Start-Job -Name LocalData {Get-Process}
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 LocalData BackgroundJob Running True localhost Get-Process
Запустите фоновое задание, которое выполняется на удаленном компьютере.
PS> Invoke-Command -ComputerName Server01 {Get-Process} `
-AsJob -JobName RemoteData
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 RemoteData RemoteJob Running True Server01 Get-Process
Создание запланированного задания
PS> Register-ScheduledJob -Name ScheduledJob -ScriptBlock `
{Get-Process} -Trigger (New-JobTrigger -Once -At "3 PM")
Id Name JobTriggers Command Enabled
-- ---- ----------- ------- -------
1 ScheduledJob 1 Get-Process True
Создайте рабочий процесс.
PS> workflow Test-Workflow {Get-Process}
Запустите рабочий процесс в качестве задания.
PS> Test-Workflow -AsJob -JobName TestWFJob
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 TestWFJob PSWorkflowJob NotStarted True localhost Get-Process
Получение заданий. Команда Get-Job не получает запланированные задания, но получает экземпляры запланированного задания, запущенного.
PS> Get-Job
Id Name PSJobTypeName State HasMoreData Location Command
-- ---- ------------- ----- ----------- -------- -------
2 LocalData BackgroundJob Completed True localhost Get-Process
4 RemoteData RemoteJob Completed True Server01 Get-Process
6 TestWFJob PSWorkflowJob Completed True localhost WorkflowJob
8 ScheduledJob PSScheduledJob Completed True localhost Get-Process
Чтобы получить запланированные задания, используйте Get-ScheduledJob командлет.
PS> Get-ScheduledJob
Id Name JobTriggers Command Enabled
-- ---- ----------- ------- -------
1 ScheduledJob 1 Get-Process True
См. также
PowerShell