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>]
   [-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
   [-IncludeChildJob]
   [-ChildJobState <JobState>]
   [-HasMoreData <Boolean>]
   [-Before <DateTime>]
   [-After <DateTime>]
   [-Newest <Int32>]
   [-Command <String[]>]
   [<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 с командлетомGet-Job NoteProperty. Это равносильно предыдущей команде.

[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 для получения задания. Для идентификации Get-Job задания используется параметр Name . Команда сохраняет результирующий объект задания в переменной $j . Третья команда отображает значение объекта задания в переменной $j . Значение свойства State показывает, что задание завершено. Значение свойства HasMoreData показывает, что есть результаты задания, которые еще не были получены. Четвертая команда использует Receive-Job командлет для получения результатов задания. Он использует объект 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 командлет для получения задания. С помощью точечной нотации извлекается значение свойства JobStateInfo объекта. Он использует оператор конвейера для отправки объекта в свойстве JobStateInfo командлету Format-List , который форматирует все свойства объекта (*) в списке. Результат 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. Получение отфильтрованных результатов

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

Первая команда использует ключевое слово рабочего процесса для создания рабочего процесса 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 .

Первая команда возвращает задания в текущем сеансе. Выходные данные включают в себя фоновое задание, удаленное задание и несколько экземпляров запланированного задания. Удаленное задание Job4, по-видимому, завершилось сбоем. Вторая команда использует параметр IncludeChildJob для Get-Job. Выходные данные добавляют дочерние задания всех заданий, имеющих дочерние задания. В этом случае измененные выходные данные показывают, что только дочернее задание 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.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Before

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

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ChildJobState

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

NotStarted
Запущен
Завершено
Сбой
Остановлена
Блокировано
Приостановлена
Отключено
Приостановка
Остановка

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

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

Type:	JobState
Accepted values:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-Filter

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

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

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

Type:	Hashtable
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

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

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

Type:	Int32[]
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeChildJob

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

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

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstanceId

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

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

Type:	Guid[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-Newest

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

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

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-State

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

NotStarted
Запущен
Завершено
Сбой
Остановлена
Блокировано
Приостановлена
Отключено
Приостановка
Остановка

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

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

Type:	JobState
Accepted values:	NotStarted, Running, Completed, Failed, Stopped, Blocked, Suspended, Disconnected, Suspending, Stopping, AtBreakpoint
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

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

None

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

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

System.Management.Automation.RemotingJob

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

Примечания

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

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

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

Примечания

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

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