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

Add-JobTrigger

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

Добавляет триггеры задания в запланированные задания.

Синтаксис

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<CommonParameters>]

Описание

Командлет Add-JobTrigger добавляет триггеры заданий в запланированные задания. Его можно использовать для добавления нескольких триггеров в несколько запланированных заданий.

Триггер задания запускает запланированное задание в однократном или повторяющемся расписании или при возникновении события.

Используйте параметр триггера для идентификации Add-JobTrigger триггеров задания для добавления. Используйте параметры Name, ID или InputObject, Add-JobTrigger чтобы определить запланированное задание, в которое добавляются триггеры.

Чтобы создать триггеры задания для значения параметра Trigger , используйте командлет или используйте New-JobTrigger хэш-таблицу для указания триггера задания.

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

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

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

Примеры

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

$Daily = New-JobTrigger -Daily -At 3AMPS
Add-JobTrigger -Trigger $Daily -Name "TestJob"

Эти команды добавляют триггер задания Daily в запланированное задание TestJob.

Первая команда использует New-JobTrigger командлет для создания триггера задания, запускающего запланированное задание каждый день в 3:00 утра. Команда сохраняет триггер задания в переменной $Daily .

Вторая команда использует Add-JobTrigger командлет для добавления триггера задания в переменную $Startup в запланированное задание TestJob.

Пример 2. Добавление триггера задания в несколько запланированных заданий

Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

Эта команда добавляет триггер задания AtStartup во все запланированные задания на локальном компьютере. Он используется Get-ScheduledJob для получения всех запланированных заданий на компьютере. Он использует оператор конвейера (|) для отправки заданий Add-JobTrigger командлету, который добавляет триггер задания к каждому из запланированных заданий. Значение параметра Trigger — это New-JobTrigger команда, которая создает триггер задания AtStartup.

Пример 3. Копирование триггера задания

$T = Get-JobTrigger -Name "BackupArchives"
Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

Эти команды копируют триггер задания из запланированного задания BackupArchives и добавляют его в запланированные задания TestBackup и BackupLogs.

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

Вторая команда использует Add-JobTrigger командлет для добавления триггера задания в $t запланированных заданий TestBackup и BackupLogs.

Параметры

-Id

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

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

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

-InputObject

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

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

-Name

Задает имена запланированных заданий. Add-JobTrigger добавляет триггеры задания в указанные запланированные задания. Поддерживаются подстановочные знаки.

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

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

-Trigger

Указывает триггеры задания для добавления. Введите хэш-таблицу, указывающую триггеры задания или переменную, содержащую объекты ScheduledJobTrigger, или введите команду или выражение, которое получает объекты ScheduledJobTrigger, например Get-JobTrigger команду. Можно также передать объекты Add-JobTriggerScheduledJobTrigger в .

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

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

ScheduledJobTrigger

Триггер задания можно передать этому командлету.

ScheduledJobDefinition

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

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

None

Этот командлет не возвращает выходные данные.