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

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.

Используйте параметры имени, идентификатораили inputObjectRemove-JobTrigger, чтобы определить запланированные задания, из которых удаляются триггеры. Используйте параметр 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

Эта команда удаляет только третий триггер (ID = 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. Значение параметра InputObjectRemove-JobTrigger является запланированным заданием в свойстве JobDefinition триггера задания. Значение параметра triggerID — это идентификатор в свойстве идентификатора триггера задания.

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

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

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

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

Параметры

-Id

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

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

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

-InputObject

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

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

-Name

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

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

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

-TriggerId

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

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

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

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

ScheduledJobDefinition

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

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

None

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