Disable-JobTrigger
Отключает триггеры задания для запланированных заданий.
Синтаксис
Disable-JobTrigger
[-InputObject] <ScheduledJobTrigger[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Disable-JobTrigger
временно отключает триггеры задания запланированных заданий. При отключении сохраняются все свойства триггера задания, однако запрещается запуск запланированного задания триггером задания.
Чтобы использовать этот командлет, используйте Get-JobTrigger
командлет для получения триггеров задания. Затем переведите триггеры задания в Disable-JobTrigger
параметр InputObject или используйте его параметр InputObject .
Чтобы отключить триггер задания, Disable-JobTrigger
командлет задает для свойства Enabled триггера задания значение $False
. Чтобы повторно включить триггер задания, используйте Enable-JobTrigger
командлет, который задает свойство Enabled триггера задания $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
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Задает отключаемый триггер задания. Введите переменную, содержащую объекты ScheduledJobTrigger, или введите команду или выражение, которое получает объекты ScheduledJobTrigger, например Get-JobTrigger
команду. Вы также можете передать объект Disable-JobTrigger
ScheduledJobTrigger в .
Type: | ScheduledJobTrigger[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
Возвращает объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не создает выходные данные.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Триггер задания можно передать этому командлету.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
Disable-JobTrigger
не создает ошибки или предупреждения, если отключить триггер задания, который уже отключен.
Связанные ссылки
- Add-JobTrigger
- Disable-JobTrigger
- Disable-ScheduledJob
- Enable-JobTrigger
- Enable-ScheduledJob
- Get-JobTrigger
- Get-ScheduledJob
- Get-ScheduledJobOption
- New-JobTrigger
- New-ScheduledJobOption
- Register-ScheduledJob
- Remove-JobTrigger
- Set-JobTrigger
- Set-ScheduledJob
- Set-ScheduledJobOption
- Unregister-ScheduledJob
PowerShell
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по