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

Remove-JobTrigger

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

Удаление триггеров заданий из запланированных заданий.

Синтаксис

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

Описание

Командлет Remove-JobTrigger удаляет триггеры заданий из запланированных заданий.

Триггер задания определяет повторяющееся расписание или условия запуска запланированного задания. Для управления триггерами заданий используйте командлеты New-JobTrigger, Add-JobTrigger, Set-JobTrigger и Set-ScheduledJob командлеты.

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

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

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

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

Примеры

Пример 1. Удаление всех триггеров задания

Remove-JobTrigger -Name "Test*"

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

Пример 2. Удаление выбранных триггеров задания

Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Эта команда удаляет только третий триггер (с идентификатором 3) из запланированного задания BackupArchive.

Пример 3. Удаление триггеров заданий AtStartup из всех запланированных заданий

function Delete-AtStartup
{
    Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.Frequency -eq "AtStartup"} | ForEach-Object { Remove-JobTrigger -InputObject $_.JobDefinition -TriggerID $_.ID}
}

Эта функция удаляет все триггеры задания AtStartup из всех заданий на локальном компьютере. Чтобы использовать функцию, запустите функцию в сеансе и введите Delete-AtStartup.

Функция Delete-AtStartup содержит одну команду. Команда использует Get-ScheduledJob командлет для получения запланированных заданий на локальном компьютере. Оператор конвейера (|) отправляет запланированные задания командлету, который получает все триггеры задания Get-JobTrigger из каждого запланированного задания. Оператор конвейера отправляет триггеры задания командлету, который выбирает триггеры Where-Object задания, где значение свойства Frequency триггера задания равно AtStartup.

Объекты JobTrigger имеют свойство JobDefinition , содержащее запланированное задание, которое они активируют. Остальная часть команды использует эту функцию.

Оператор конвейера отправляет триггеры задания AtStartup командлету ForEach-Object , который выполняет Remove-JobTrigger команду на каждом триггере AtStartup. Значение параметра Remove-JobTrigger InputObject является запланированным заданием в свойстве JobDefinition триггера задания. Значение параметра TriggerID — это идентификатор в свойстве идентификатора триггера задания.

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

Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

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

Команда использует Invoke-Command командлет для запуска командлета Remove-JobTrigger на компьютере Server01. Командлет Remove-JobTrigger использует параметр идентификаторадля идентификации запланированного задания инвентаризации и параметра TriggerID, чтобы указать первый триггер. Параметр идентификатора особенно полезен, если несколько запланированных заданий имеют одинаковые или аналогичные имена.

Параметры

-Id

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

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

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

-InputObject

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

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

-Name

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

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

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

-TriggerId

Удаляет только указанные триггеры задания. По умолчанию Remove-JobTrigger удаляет все триггеры из запланированных заданий. Используйте этот параметр, если запланированные задания имеют несколько триггеров задания.

Введите идентификаторы триггеров одного или нескольких запланированных заданий. При указании нескольких запланированных заданий Remove-JobTrigger удаляет триггер задания с указанным идентификатором из всех запланированных заданий.

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

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

ScheduledJobDefinition

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

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

None

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