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

Get-JobTrigger

  • Ссылка
Модуль:
PSScheduledJob

Получает триггеры задания для запланированных заданий.

Синтаксис

Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Id] <Int32>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Name] <String>
   [<CommonParameters>]

Описание

Командлет Get-JobTrigger получает триггеры задания запланированных заданий. Эта команда используется для проверки триггеров задания или их передачи в другие командлеты.

Триггер задания определяет повторяющееся расписание или условия запуска запланированного задания. Триггеры задания не сохраняются на диск независимо; они являются частью запланированного задания. Чтобы получить триггер задания, укажите запланированное задание, запускаемое триггером.

Используйте параметры командлета для идентификации Get-JobTrigger запланированных заданий. Вы можете определить запланированные задания по именам или идентификаторам, а также путем ввода или подключения объектов ScheduledJob , таких как те, которые возвращаются командлетом Get-ScheduledJob , в Get-JobTrigger.

Get-JobTrigger — одна из коллекций командлетов планирования заданий в модуле PSScheduledJob, включенном в Windows PowerShell.

Дополнительные сведения о запланированных заданиях см. в разделах описания в модуле PSScheduledJob. Импортируйте модуль PSScheduledJob, а затем введите Get-Help about_Scheduled* или просмотрите about_Scheduled_Jobs.

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

Примеры

Пример 1. Получение триггера задания по имени запланированного задания

Get-JobTrigger -Name "BackupJob"

Команда использует параметр Name для Get-JobTrigger получения триггеров задания запланированного BackupJob задания.

Пример 2. Получение триггера задания по идентификатору

В примере используется параметр идентификатора Get-JobTrigger для получения триггеров задания запланированного задания.

Get-ScheduledJob

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProjects {1}             \\Server\Share\Archive-Projects.ps1      True
2          Backup          {1,2}           \\Server\Share\Run-Backup.ps1            True
3          Test-HelpFiles  {1}             \\Server\Share\Test-HelpFiles.ps1        True
4          TestJob         {}              \\Server\Share\Run-AllTests.ps1          True

Get-JobTrigger -ID 3

Первая команда использует Get-ScheduledJob командлет для отображения запланированных заданий на локальном компьютере. Отображение включает идентификаторы запланированных заданий.

Вторая команда использует Get-JobTrigger командлет для получения триггера задания для Test-HelpFiles задания (идентификатор которого является3).

Пример 3. Получение триггеров задания путем подключения задания

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

Get-ScheduledJob -Name *Backup*, *Archive* | Get-JobTrigger

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

Пример 4. Получение триггера задания на удаленном компьютере

Этот пример получает триггеры запланированного задания на удаленном компьютере.

Invoke-Command -ComputerName Server01 { Get-ScheduledJob Backup | Get-JobTrigger -TriggerID 2 }

Команда использует Invoke-Command командлет для выполнения команды на компьютере Server01. Он использует Get-ScheduledJob командлет для получения запланированного Backup задания, который он передает командлету Get-JobTrigger . Он использует параметр TriggerID для получения только второго триггера.

Пример 5. Получение всех триггеров задания

Этот пример получает все триггеры заданий всех запланированных заданий на локальном компьютере.

Get-ScheduledJob | Get-JobTrigger |
    Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="ScheduledJob";Expression={$_.JobDefinition.Name}} -AutoSize

Id Frequency At                    DaysOfWeek Enabled ScheduledJob
-- --------- --                    ---------- ------- ------------
1    Weekly  9/28/2011 3:00:00 AM  {Monday}   True    Backup
1    Daily   9/27/2011 11:00:00 PM            True    Test-HelpFiles

Эта команда используется Get-ScheduledJob для получения запланированных заданий на локальном компьютере и передает их Get-JobTriggerв , который получает триггер задания для каждого запланированного задания (при наличии).

Чтобы добавить имя запланированного задания в отображение триггера задания, команда использует функцию вычисляемого свойства командлета Format-Table . Помимо свойств триггера задания, отображаемых по умолчанию, команда создает новое свойство ScheduledJob , отображающее имя запланированного задания.

Пример 6. Получение свойства триггера задания запланированного задания

В этом примере показаны различные методы для просмотра свойства JobTrigger запланированного задания.

(Get-ScheduledJob Test-HelpFiles).JobTriggers
Get-ScheduledJob | foreach {$_.JobTriggers}

Первая команда использует Get-ScheduledJob командлет для получения запланированного Test-HelpFiles задания. Затем он использует метод dot (.) для получения свойства JobTriggers запланированного Test-HelpFiles задания.

Вторая команда использует Get-ScheduledJob командлет для получения всех запланированных заданий на локальном компьютере. Он использует ForEach-Object командлет для получения значения свойства JobTriggers каждого запланированного задания.

Триггеры заданий запланированного задания хранятся в свойстве JobTriggers задания. В этом примере показаны альтернативные варианты использования командлета Get-JobTrigger для получения триггеров задания. Результаты идентичны использованию командлета Get-JobTrigger , а методы можно использовать взаимозаменяемо.

Пример 7. Сравнение триггеров задания

Get-ScheduledJob -Name ArchiveProjects | Get-JobTrigger | Tee-Object -Variable t1

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

Get-ScheduledJob -Name "Test-HelpFiles" | Get-JobTrigger | Tee-Object -Variable t2

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

$t1| Get-Member -Type Property | ForEach-Object { Compare-Object $t1 $t2 -Property $_.Name}

RandomDelay                                                 SideIndicator
-----------                                                 -------------
00:00:00                                                    =>
00:03:00                                                    <=

Первая команда получает триггер задания запланированного ArchiveProjects задания. Командная строка передает триггер Tee-Object задания командлету, который сохраняет триггер задания в переменной $t1 и отображает его в командной строке.

Вторая команда получает триггер задания запланированного Test-HelpFiles задания. Командная строка передает триггер Tee-Object задания командлету, который сохраняет триггер задания в переменной $t2 и отображает его в командной строке.

Третья команда сравнивает триггеры задания в $t1 переменных и $t 2. Он использует Get-Member командлет для получения свойств триггера задания в переменной $t 1. Он передает свойства ForEach-Object командлету, который сравнивает каждое свойство со свойствами триггера задания в переменной $t2 по имени. Затем команда передает различные свойства командлету Format-List , который отображает их в списке. Выходные данные указывают на то, что, хотя триггеры задания, как представляется, совпадают, HelpFiles триггер задания включает случайную задержку в три (3) минуты.

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

Параметры

-Id

Задает идентификационный номер запланированного задания. Get-JobTrigger возвращает триггер задания указанного запланированного задания.

Чтобы получить идентификационный номер запланированных заданий на локальном компьютере или удаленном компьютере, используйте Get-ScheduledJob командлет.

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

-InputObject

Указывает запланированное задание. Введите переменную, содержащую объекты ScheduledJob или введите команду или выражение, которое получает объекты ScheduledJob, например Get-ScheduledJob команду. Можно также передать объекты Get-JobTriggerScheduledJob в .

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

-Name

Указывает имя запланированного задания. Get-JobTrigger возвращает триггер задания указанного запланированного задания. Поддерживаются подстановочные знаки.

Чтобы получить имена запланированных заданий на локальном компьютере или удаленном компьютере, используйте Get-ScheduledJob командлет.

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

-TriggerId

Возвращает указанные триггеры задания. Введите идентификаторы триггеров одного или нескольких запланированных заданий. Используйте этот параметр, если запланированное задание, указанное параметрами Name, ID или InputObject , имеет несколько триггеров заданий.

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

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

ScheduledJobDefinition

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

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

ScheduledJobTrigger

Этот командлет возвращает триггер запланированного задания.