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

Disable-JobTrigger

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

Отключает триггеры задания запланированных заданий.

Синтаксис

Disable-JobTrigger
       [-InputObject] <ScheduledJobTrigger[]>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Описание

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

Чтобы использовать этот командлет, используйте командлет Get-JobTrigger для получения триггеров задания. Затем переведите триггеры задания, чтобы Disable-JobTrigger или использовать его параметр InputObject.

Чтобы отключить триггер задания, командлет Disable-JobTrigger задает свойство Enabled триггера задания $False. Чтобы повторно включить триггер задания, используйте командлет Enable-JobTrigger, который задает включено свойство триггера задания $True. Отключение триггера задания не отключает запланированное задание, например, выполняется командлетом Disable-ScheduledJob, но если отключить все триггеры заданий, эффект такой же, как отключение запланированного задания.

Если вы отключите запланированное задание или отключите все триггеры заданий запланированного задания, вы по-прежнему можете запустить задание с помощью командлета Start-Job или использовать отключенное запланированное задание в качестве шаблона.

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

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

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

Примеры

Пример 1. Отключение триггера задания

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

PS C:\> Get-JobTrigger -Name "Backup-Archives" -TriggerID 1 | Disable-JobTrigger

Команда использует командлет Get-JobTrigger для получения триггера задания. Оператор конвейера (|)отправляет триггер задания в командлет Disable-JobTrigger, который отключает его.

Пример 2. Отключение всех триггеров задания

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

Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
1  Weekly    9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
2  Daily     9/29/2011 1:00:00 AM              False   Backup-Archive
1  Weekly    10/20/2011 11:00:00 PM {Friday}   False   Inventory
1  Weekly    11/2/2011 2:00:00 PM   {Monday}   False   Inventory

Первая команда использует командлет Get-ScheduledJob для получения запланированных заданий Backup-Archives и инвентаризации. Оператор конвейера (|) отправляет запланированные задания в командлет Get-JobTrigger, который получает все триггеры заданий запланированных заданий. Другой оператор конвейера отправляет триггеры задания в командлет Disable-JobTrigger, который отключает их. Первая команда использует командлет Get-ScheduledJob для получения заданий, так как его параметр Name принимает несколько имен.

Вторая команда отображает результаты. Команда повторяет команду Get-ScheduledJob и Get-JobTrigger. Оператор конвейера отправляет триггеры задания в командлет Format-Table, который отображает триггеры задания в таблице. Команда Format-Table добавляет свойство JobName, отображающее значение свойства Name запланированного задания в свойстве JobDefinition объекта триггера задания.

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

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

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

Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "Daily"} | Disable-JobTrigger}

Команда использует командлет Invoke-Command для выполнения команд на компьютере Server01. Удаленная команда использует командлет Get-JobTrigger для получения триггеров задания запланированного задания DeployPackage. Оператор конвейера отправляет триггеры задания в командлет Where-Object, который возвращает только ежедневные триггеры заданий. Оператор конвейера отправляет ежедневные триггеры заданий в командлет Disable-JobTrigger, который отключает их.

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

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

-InputObject

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

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

-PassThru

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

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

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

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

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

ScheduledJobTrigger

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

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

None

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

Примечания

  • Disable-JobTrigger не создает ошибки или предупреждения, если вы отключаете триггер задания, который уже отключен.