Get-Job

Ссылка

Модуль:: Microsoft.PowerShell.Core

Возвращает фоновые задания PowerShell, выполняемые в текущем сеансе.

Синтаксис

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [[-Id] <Int32[]>]
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Command <String[]>]
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-InstanceId] <Guid[]>
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Name] <String[]>
   [<CommonParameters>]

Get-Job
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-State] <JobState>
   [<CommonParameters>]

Get-Job
   [-Filter] <Hashtable>
   [<CommonParameters>]

Описание

Командлет Get-Job получает объекты, представляющие фоновые задания, запущенные в текущем сеансе. Вы можете использовать Get-Job для получения заданий, которые были запущены с помощью командлета Start-Job или с помощью параметра AsJob любого командлета.

Без параметров Get-Job команда получает все задания в текущем сеансе. Параметры можно использовать для получения определенных заданий Get-Job .

Объект задания, возвращаемый Get-Job , содержит полезные сведения о задании, но не содержит результаты задания. Чтобы получить результаты, используйте Receive-Job командлет.

Фоновое задание Windows PowerShell — это команда, которая выполняется в фоновом режиме без взаимодействия с текущим сеансом. Как правило, для выполнения сложной команды, которая занимает много времени, используется фоновое задание. Дополнительные сведения о фоновых заданиях в Windows PowerShell см. в about_Jobs.

Начиная с Windows PowerShell 3.0, Get-Job командлет также получает пользовательские типы заданий, такие как задания рабочего процесса и экземпляры запланированных заданий. Чтобы найти тип задания, используйте свойство PSJobTypeName задания.

Чтобы включить Get-Job получение пользовательского типа задания, импортируйте модуль, поддерживающий настраиваемый тип задания, в сеанс перед выполнением Get-Job команды с помощью командлета или с помощью Import-Module командлета или получения командлета в модуле. Дополнительные сведения о определенных пользовательских типах заданий см. в разделе документации о данной функции.

Примеры

Пример 1. Получение всех фоновых заданий, запущенных в текущем сеансе

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

Get-Job

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Job1            BackgroundJob   Completed     True            localhost             $env:COMPUTERNAME

Пример 2. Остановка задания с помощью идентификатора экземпляра

Эти команды показывают, как получить идентификатор экземпляра задания, а затем с его помощью остановить задание. В отличие от имени задания, идентификатор экземпляра уникален.

Первая команда использует Get-Job командлет для получения задания. Он использует параметр Name для идентификации задания. Команда сохраняет объект задания, Get-Job который возвращается в переменной $j . В этом примере существует только одно задание с указанным именем. Вторая команда получает свойство InstanceId объекта в переменной $j и сохраняет его в переменной $ID . Третья команда отображает значение переменной $ID . Четвертая команда использует Stop-Job командлет для остановки задания. Он использует параметр InstanceId для идентификации задания и $ID переменной для представления идентификатора экземпляра задания.

$j = Get-Job -Name Job1
$ID = $j.InstanceID
$ID

Guid
----
03c3232e-1d23-453b-a6f4-ed73c9e29d55

Stop-Job -InstanceId $ID

Пример 3. Получение заданий, включающих определенную команду

Эта команда получает задания в системе, включающую Get-Process команду. Команда использует параметр Command для Get-Job ограничения полученных заданий. Команда использует подстановочные знаки (*) для получения заданий Get-Process , включающих команду в любой точке командной строки.

Get-Job -Command "*Get-Process*"

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
3      Job3            BackgroundJob   Running       True            localhost            Get-Process

Пример 4. Получение заданий, включающих определенную команду с помощью конвейера

Как и команда в предыдущем примере, эта команда получает задания в системе, включающую Get-Process команду. Команда использует оператор конвейера (|) для отправки PSCustomObject с помощью команды NoteProperty в Get-Job командлет. Это равносильно предыдущей команде.

[pscustomobject]@{Command='*Get-Process*'} | Get-Job

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
3      Job3            BackgroundJob   Running       True            localhost            Get-Process

Пример 5. Получение заданий, которые не были запущены

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

Get-Job -State NotStarted

Пример 6. Получение заданий, которые не были назначены имени

Эта команда получает все задания с именами заданий, начинающимися с задания. Так как job<number> это имя задания по умолчанию, эта команда получает все задания, которые не имеют явно назначенного имени.

Get-Job -Name Job*

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
1      Job1            BackgroundJob   Completed     True            localhost             $env:COMPUTERNAME

Пример 7. Использование объекта задания для представления задания в команде

В этом примере показано, как использовать Get-Job для получения объекта задания, а затем показано, как использовать объект задания для представления задания в команде.

Первая команда использует Start-Job командлет для запуска фонового задания, выполняющего Get-Process команду на локальном компьютере. Команда использует параметр Name для Start-Job назначения понятного имени заданию. Вторая команда используется Get-Job для получения задания. Он использует параметр Name для идентификации Get-Job задания. Команда сохраняет полученный объект задания в переменной $j . Третья команда отображает значение объекта задания в переменной $j . Значение свойства State показывает, что задание завершено. Значение свойства HasMoreData показывает, что из задания доступны результаты, которые еще не извлечены. Четвертая команда использует Receive-Job командлет для получения результатов задания. Он использует объект задания в переменной $j для представления задания. Для отправки объекта Receive-Jobзадания также можно использовать оператор конвейера.

Start-Job -ScriptBlock {Get-Process} -Name MyJob
$j = Get-Job -Name MyJob
$j

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
6      MyJob           BackgroundJob   Completed     True            localhost            Get-Process

Receive-Job -Job $j

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    124       4    13572      12080    59            1140 audiodg
    783      16    11428      13636   100             548 CcmExec
     96       4     4252       3764    59            3856 ccmsetup
...

Пример 8. Получение всех заданий, включая задания, запущенные другим методом

В этом примере показано, что Get-Job командлет может получить все задания, запущенные в текущем сеансе, даже если они были запущены с помощью различных методов.

Первая команда использует Start-Job командлет для запуска задания на локальном компьютере. Вторая команда использует параметр AsJob командлета Invoke-Command для запуска задания на компьютере S1. Несмотря на то, что команды в задании выполняются на удаленном компьютере, объект задания создается на локальном компьютере, поэтому для управления заданием используются локальные команды. Третья команда использует Invoke-Command командлет для выполнения Start-Job команды на компьютере S2. С помощью этого метода объект задания создается на удаленном компьютере, поэтому для управления заданием используются удаленные команды. Четвертая команда используется Get-Job для получения заданий, хранящихся на локальном компьютере. Свойство PSJobTypeName заданий, представленное в Windows PowerShell 3.0, показывает, что локальное задание, запущенное с помощью командлета, является фоновым заданием, а задание, запущенное в удаленном сеансе с помощью Start-Job Invoke-Command командлета, является удаленным заданием. Пятая, шестая и седьмая команда использует New-PSSession командлет для создания PSSession, подключенного к компьютеру S2, используется Invoke-Command для запуска задания на удаленном компьютере с помощью PSSession и параметра session . Затем он получает задание с помощью Get-Job команды на компьютере S2 с помощью PSSession. В примере выходных Get-Job данных показаны результаты команды. На компьютере S2 задание, как представляется, является локальным заданием. Имя компьютера — localhost, а тип задания — фоновое задание. Дополнительные сведения о выполнении фоновых заданий на удаленных компьютерах см. в about_Remote_Jobs.

Start-Job -ScriptBlock {Get-EventLog -LogName System}
Invoke-Command -ComputerName S1 -ScriptBlock {Get-EventLog -LogName System} -AsJob
Invoke-Command -ComputerName S2 -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog -LogName System}}
Get-Job

Id     Name       PSJobTypeName   State         HasMoreData     Location        Command
--     ----       -------------   -----         -----------     --------        -------
1      Job1       BackgroundJob   Running       True            localhost       Get-EventLog System
2      Job2       RemoteJob       Running       True            S1              Get-EventLog System

$Session = New-PSSession -ComputerName S2
Invoke-Command -Session $Session -ScriptBlock {Start-Job -ScriptBlock {Get-EventLog -LogName System}}
Invoke-Command -Session $Session -ScriptBlock {Get-Job}

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command                   PSComputerName
--     ----            -------------   -----         -----------     --------             -------                   --------------
1      Job1            BackgroundJob   Running       True            localhost            Get-EventLog -LogName Sy… S2

Пример 9. Исследование неудачного задания

Эта команда показывает, как использовать объект задания, возвращающийся Get-Job для изучения причины сбоя задания. Она также показывает, как получить дочерние задания каждого задания.

Первая команда использует Start-Job командлет для запуска задания на локальном компьютере. Объект задания, возвращающий Start-Job , показывает, что задание завершилось сбоем. Значение свойства State — Failed.

Вторая команда использует Get-Job командлет для получения задания. Команда использует метод dot для получения значения свойства JobStateInfo объекта. Он использует оператор конвейера для отправки объекта в свойстве Format-List JobStateInfo командлету, который форматирует все свойства объекта (*) в списке. Результат Format-List команды показывает, что значение свойства Reason задания пусто.

Третья команда изучает больше. Он использует Get-Job команду для получения задания, а затем использует оператор конвейера для отправки всего объекта Format-List задания командлету, который отображает все свойства задания в списке. Отображение всех свойств в объекте задания показывает, что задание содержит дочернее задание с именем Job2.

Четвертая команда используется Get-Job для получения объекта задания, представляющего дочернее задание Job2. Это задание, в котором фактически выполнялась команда. Он использует метод dot для получения свойства Reason свойства JobStateInfo . В результате показано, что задание завершилось сбоем из-за ошибки "Отказано в доступе". В этом случае пользователь забыл использовать параметр "Запуск от имени администратора" при запуске Windows PowerShell.Так как фоновые задания используют функции удаленного взаимодействия Windows PowerShell, компьютер должен быть настроен для удаленного взаимодействия для запуска задания, даже если задание выполняется на локальном компьютере. Сведения о требованиях к удаленному взаимодействию в Windows PowerShell см. в about_Remote_Requirements. Советы по устранению неполадок см. в about_Remote_Troubleshooting.

PS> Start-Job -ScriptBlock {Get-Process}
Id     Name       PSJobTypeName   State       HasMoreData     Location             Command
--     ----       -------------   -----       -----------     --------             -------
1      Job1       BackgroundJob   Failed      False           localhost            Get-Process

PS> (Get-Job).JobStateInfo | Format-List -Property *
State  : Failed
Reason :

PS> Get-Job | Format-List -Property *
HasMoreData   : False
StatusMessage :
Location      : localhost
Command       : get-process
JobStateInfo  : Failed
Finished      : System.Threading.ManualReset
EventInstanceId    : fb792295-1318-4f5d-8ac8-8a89c5261507
Id            : 1
Name          : Job1
ChildJobs     : {Job2}
Output        : {}
Error         : {}
Progress      : {}
Verbose       : {}
Debug         : {}
Warning       : {}
StateChanged  :

PS> (Get-Job -Name job2).JobStateInfo.Reason
Connecting to remote server using WSManCreateShellEx api failed. The async callback gave the
following error message: Access is denied.

Пример 10. Получение отфильтрованных результатов

В этом примере показано, как использовать параметр фильтра для получения задания рабочего процесса. Параметр фильтра , представленный в Windows PowerShell 3.0, действителен только для пользовательских типов заданий, таких как задания рабочего процесса и запланированные задания.

Первая команда использует ключевое слово Workflow для создания рабочего процесса WFProcess. Вторая команда использует параметр AsJob рабочего процесса WFProcess для запуска рабочего процесса в качестве фонового задания. Он использует параметр JobName рабочего процесса для указания имени задания и параметра PSPrivateMetadata рабочего процесса для указания пользовательского идентификатора. Третья команда использует параметр filter для Get-Job получения задания по пользовательскому идентификатору, указанному в параметре PSPrivateMetadata .

PS> Workflow WFProcess {Get-Process}
PS> WFProcess -AsJob -JobName WFProcessJob -PSPrivateMetadata @{MyCustomId = 92107}
PS> Get-Job -Filter @{MyCustomId = 92107}
Id     Name            State         HasMoreData     Location             Command
--     ----            -----         -----------     --------             -------
1      WFProcessJob    Completed     True            localhost            WFProcess

Пример 11. Получение сведений о дочерних заданиях

В этом примере показан эффект использования параметров IncludeChildJob и ChildJobState командлета Get-Job .

Первая команда получает задания в текущем сеансе. Выходные данные включают фоновое задание, удаленное задание и несколько экземпляров запланированного задания. Удаленное задание, задание4, как представляется, завершилось сбоем. Вторая команда использует параметр Get-JobIncludeChildJob . Выходные данные добавляют дочерние задания всех заданий, имеющих дочерние задания. В этом случае измененные выходные данные показывают, что не удалось выполнить только дочернее задание Job5 job4. Третья команда использует параметр ChildJobState со значением Failed.Выходные данные включают все родительские задания и только дочерние задания, которые не удалось выполнить. Пятая команда использует свойство JobStateInfo заданий и его свойство Reason для обнаружения причины сбоя Job5.

PS> Get-Job

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
2      Job2            BackgroundJob   Completed     True            localhost            .\Get-Archive.ps1
4      Job4            RemoteJob       Failed        True            Server01, Server02   .\Get-Archive.ps1
7      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
8      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
9      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
10     UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help

PS> Get-Job -IncludeChildJob

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
2      Job2            BackgroundJob   Completed     True            localhost           .\Get-Archive.ps1
3      Job3                            Completed     True            localhost           .\Get-Archive.ps1
4      Job4            RemoteJob       Failed        True            Server01, Server02  .\Get-Archive.ps1
5      Job5                            Failed        False           Server01            .\Get-Archive.ps1
6      Job6                            Completed     True            Server02            .\Get-Archive.ps1
7      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
8      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
9      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
10     UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help

PS> Get-Job -Name Job4 -ChildJobState Failed

Id     Name            PSJobTypeName   State         HasMoreData     Location             Command
--     ----            -------------   -----         -----------     --------             -------
2      Job2            BackgroundJob   Completed     True            localhost           .\Get-Archive.ps1
4      Job4            RemoteJob       Failed        True            Server01, Server02  .\Get-Archive.ps1
5      Job5                            Failed        False           Server01            .\Get-Archive.ps1
7      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
8      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
9      UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help
10     UpdateHelpJob   PSScheduledJob  Completed     True            localhost            Update-Help

PS> (Get-Job -Name Job5).JobStateInfo.Reason

Connecting to remote server Server01 failed with the following error message:
Access is denied.

Дополнительные сведения см. в разделе справки about_Remote_Troubleshooting .

Параметры

-After

Возвращает выполненные задания, которые завершились после указанных даты и времени. Введите объект DateTime, например один, возвращаемый командлетом Get-Date или строкой, которая может быть преобразована в объект DateTime, например Dec 1, 2012 2:00 AM или11/06.

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

Этот параметр впервые появился в Windows PowerShell 3.0.

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Before

Возвращает выполненные задания, которые завершились до указанных даты и времени. Введите объект DateTime.

Этот параметр впервые появился в Windows PowerShell 3.0.

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ChildJobState

Возвращает только те дочерние задания, которые находятся в указанном состоянии. Допустимые значения для этого параметра:

NotStarted
Выполняется
Завершено
Неудачно
Остановлено
Заблокировано
Приостановлена
Отключено
Приостановка
Остановка

По умолчанию Get-Job не получает дочерние задания. Используя параметр IncludeChildJob , Get-Job получает все дочерние задания. Если вы используете параметр ChildJobState , параметр IncludeChildJob не действует.

Этот параметр впервые появился в Windows PowerShell 3.0.

Тип:	JobState
Допустимые значения:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Command

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

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	True

-Filter

Задает хэш-таблицу условий. Этот командлет получает задания, удовлетворяющие всем условиям. Введите хэш-таблицу, где ключи являются свойствами заданий, а значения — значениями этих свойств.

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

Этот параметр впервые появился в Windows PowerShell 3.0.

Тип:	Hashtable
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-HasMoreData

Указывает, получает ли этот командлет только задания, имеющие указанное значение свойства HasMoreData . Свойство HasMoreData указывает, получены ли все результаты задания в текущем сеансе. Чтобы получить задания с большим количеством результатов, укажите значение $True. Чтобы получить задания, у которых нет дополнительных результатов, укажите значение $False.

Чтобы получить результаты задания, используйте Receive-Job командлет.

При использовании Receive-Job командлета он удаляет из памяти хранилище для конкретного сеанса, возвращаемое результатом. Когда он вернул все результаты задания в текущем сеансе, он задает значение свойства HasMoreData задания в значение ), чтобы указать, что он больше не имеет результатов для задания $Falseв текущем сеансе. Используйте параметр Keep, Receive-Job чтобы предотвратить Receive-Job удаление результатов и изменение значения свойства HasMoreData. Для получения дополнительных сведений введите Get-Help Receive-Job.

Свойство HasMoreData зависит от текущего сеанса. Если результаты настраиваемого типа задания сохраняются вне сеанса, например запланированный тип задания, который сохраняет результаты задания на диске, можно использовать Receive-Job командлет в другом сеансе, чтобы снова получить результаты задания, даже если значение HasMoreData равно $False. Подробнее см. в разделах справки по настраиваемому типу задания.

Этот параметр впервые появился в Windows PowerShell 3.0.

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Id

Задает массив идентификаторов заданий, которые получает этот командлет.

Идентификатор — это целое число, которое однозначно идентифицирует задание в текущем сеансе. Проще помнить и вводить идентификатор экземпляра, но он является уникальным только в текущем сеансе. Можно ввести один или несколько идентификаторов, разделенных запятыми. Чтобы найти идентификатор задания, введите Get-Job без параметров.

Тип:	Int32[]
Position:	0
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-IncludeChildJob

Указывает, что этот командлет возвращает дочерние задания в дополнение к родительским заданиям.

Этот параметр особенно полезен для изучения заданий рабочих процессов, для которых Get-Job возвращает родительское задание контейнера и сбои заданий, так как причина сбоя сохраняется в свойстве дочернего задания.

Этот параметр впервые появился в Windows PowerShell 3.0.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InstanceId

Задает массив идентификаторов экземпляров заданий, которые получает этот командлет. По умолчанию останавливаются все задания.

Идентификатор экземпляра — это GUID, который однозначно определяет задание на компьютере. Чтобы найти идентификатор экземпляра задания, используйте Get-Job.

Тип:	Guid[]
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Name

Задает массив понятных имен экземпляров заданий, которые получает этот командлет. Введите имя задания или используйте подстановочные знаки для ввода шаблона имени задания. По умолчанию Get-Job получает все задания в текущем сеансе.

Тип:	String[]
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	True

-Newest

Указывает ряд заданий для получения. Этот командлет получает задания, завершившиеся последними.

Новый параметр не сортирует или не возвращает новейшие задания в порядке окончания времени. Чтобы отсортировать выходные Sort-Object данные, используйте командлет.

Этот параметр впервые появился в Windows PowerShell 3.0.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-State

Указывает состояние задания. Этот командлет получает только задания в указанном состоянии. Допустимые значения для этого параметра:

NotStarted
Выполняется
Завершено
Неудачно
Остановлено
Заблокировано
Приостановлена
Отключено
Приостановка
Остановка

По умолчанию Get-Job получает все задания в текущем сеансе.

Дополнительные сведения о состояниях заданий см. в разделе "Перечисление JobState".

Тип:	JobState
Допустимые значения:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	0
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

Входные данные

None

Невозможно передать объекты в этот командлет.

Выходные данные

System.Management.Automation.RemotingJob

Этот командлет возвращает объекты, представляющие задания в сеансе.

Примечания

Windows PowerShell включает следующие псевдонимы для Get-Job:

gjb

Свойство PSJobTypeName заданий указывает тип задания. Значение свойства определяется автором типа задания. Ниже приведен список распространенных типов заданий.

BackgroundJob. Локальное задание, начатое с помощью Start-Job.
RemoteJob. Задание началось в PSSession с помощью параметра AsJob командлета Invoke-Command .
PSWorkflowJob. Задание началось с помощью общего параметра AsJob рабочих процессов.

Поделиться через

Get-Job

Синтаксис

Описание

Примеры

Пример 1. Получение всех фоновых заданий, запущенных в текущем сеансе

Пример 2. Остановка задания с помощью идентификатора экземпляра

Пример 3. Получение заданий, включающих определенную команду

Пример 4. Получение заданий, включающих определенную команду с помощью конвейера

Пример 5. Получение заданий, которые не были запущены

Пример 6. Получение заданий, которые не были назначены имени

Пример 7. Использование объекта задания для представления задания в команде

Пример 8. Получение всех заданий, включая задания, запущенные другим методом

Пример 9. Исследование неудачного задания

Пример 10. Получение отфильтрованных результатов

Пример 11. Получение сведений о дочерних заданиях

Параметры

-After

-Before

-ChildJobState

-Command

-Filter

-HasMoreData

-Id

-IncludeChildJob

-InstanceId

-Name

-Newest

-State

Входные данные

Выходные данные

Примечания

Дополнительные ресурсы

Поделиться через

Get-Job

Синтаксис

Описание

Примеры

Пример 1. Получение всех фоновых заданий, запущенных в текущем сеансе

Пример 2. Остановка задания с помощью идентификатора экземпляра

Пример 3. Получение заданий, включающих определенную команду

Пример 4. Получение заданий, включающих определенную команду с помощью конвейера

Пример 5. Получение заданий, которые не были запущены

Пример 6. Получение заданий, которые не были назначены имени

Пример 7. Использование объекта задания для представления задания в команде

Пример 8. Получение всех заданий, включая задания, запущенные другим методом

Пример 9. Исследование неудачного задания

Пример 10. Получение отфильтрованных результатов

Пример 11. Получение сведений о дочерних заданиях

Параметры

-After

-Before

-ChildJobState

-Command

-Filter

-HasMoreData

-Id

-IncludeChildJob

-InstanceId

-Name

-Newest

-State

Входные данные

Выходные данные

Примечания

Связанные ссылки

Дополнительные ресурсы