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

Disable-ScheduledJob

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

Отключает запланированное задание.

Синтаксис

Disable-ScheduledJob
       [-InputObject] <ScheduledJobDefinition>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-ScheduledJob
       [-Id] <Int32>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-ScheduledJob
       [-Name] <String>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Описание

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

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

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

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

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

Примеры

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

Этот пример отключает запланированное задание на локальном компьютере.

Disable-ScheduledJob -ID 2 -Passthru

Эта команда отключает запланированное задание с идентификатором 2 на локальном компьютере.

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

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

Get-ScheduledJob | Disable-ScheduledJob -Passthru

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        False
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    False
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     False
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       False

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

Можно повторно включить запланированное задание с помощью Enable-ScheduledJob командлета и запустить отключенное запланированное задание с помощью командлета Start-Job .

Disable-ScheduledJob не создает предупреждения или ошибки, если вы отключаете запланированное задание, которое уже отключено, поэтому вы можете отключить все запланированные задания без условий.

Пример 3. Отключение выбранных запланированных заданий

В этом примере отключено запланированное задание не включает учетные данные.

Get-ScheduledJob | Where-Object {!$_.Credential} | Disable-ScheduledJob

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

Команда использует Get-ScheduledJob командлет для получения всех запланированных заданий на компьютере. Оператор конвейера отправляет запланированные задания командлету Where-Object , который выбирает запланированные задания, у которых нет учетных данных. Команда использует оператор not (!) и ссылается на свойство Credential запланированного задания. Другой оператор конвейера отправляет выбранные запланированные задания командлету Disable-ScheduledJob , который отключает их.

Пример 4. Отключение запланированных заданий на удаленном компьютере

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

Invoke-Command -ComputerName Srv01, Srv10 -ScriptBlock {Disable-ScheduledJob -Name TestJob}

Команда использует Invoke-Command командлет для выполнения Disable-ScheduledJob команды на компьютерах Srv01 и Srv10. Команда использует параметр Name для выбора запланированного Disable-ScheduledJob задания TestJob на каждом компьютере.

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

В этих примерах показано, как отключить запланированное задание с помощью его глобального идентификатора. Значением свойства GlobalID запланированного задания является уникальный идентификатор (GUID). Используйте значение GlobalID, когда необходима точность, например при отключении запланированных заданий на нескольких компьютерах.

Get-ScheduledJob | Format-Table -Property Name, GlobalID, Command -Autosize

Name             GlobalId                             Command
----             --------                             -------
ArchiveProjects1 a26a0b3d-b4e6-44d3-8b95-8706ef621f7c C:\Scripts\Archive-DxProjects.ps1
Inventory        3ac37e5d-84c0-4a8f-9661-7e88ebb8f914 \\Srv01\Scripts\Get-FullInventory.ps1
Backup-Scripts   4d0cc6be-c082-48d1-baec-1bd8278f3c81  Copy-Item C:\CurrentScripts\*.ps1 -Destination C:\BackupScripts
Test-HelpFiles   d77020ca-f20d-42be-86c8-fc64df97db90 .\Test-HelpFiles.ps1
Test-HelpFiles   2f1606d2-c6cf-4bef-8b1c-ae36a9cc9934 .\Test-DomainHelpFiles.ps1

Get-ScheduledJob | Where-Object {$_.GlobalID = d77020ca-f20d-42be-86c8-fc64df97db90} | Disable-ScheduledJob

Первая команда демонстрирует один из способов поиска GlobalID запланированного задания. Команда использует Get-ScheduledJob командлет для получения запланированных заданий на компьютере. Оператор конвейера (|) отправляет запланированные задания командлету Format-Table , в котором отображаются свойства Name, GlobalID и Command каждого задания в таблице.

Вторая команда использует Get-ScheduledJob командлет для получения запланированных заданий на компьютере. Оператор конвейера (|) отправляет запланированные задания Where-Object командлету, который выбирает запланированное задание с указанным глобальным идентификатором. Другой оператор конвейера отправляет задание командлету Disable-ScheduledJob , который отключает его.

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Отключает запланированное задание с указанным идентификационным номером (идентификатором). Введите идентификатор запланированного задания.

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

-InputObject

Задает отключаемое запланированное задание. Введите переменную, содержащую объекты ScheduledJobDefinition или введите команду или выражение, которое получает объекты ScheduledJobDefinition , например Get-ScheduledJob команду. Можно также передать объект Disable-ScheduledJobScheduledJobDefinition в .

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

-Name

Отключает запланированные задания с указанными именами. Введите имя запланированного задания. Поддерживаются подстановочные знаки.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
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

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

ScheduledJobDefinition

Вы можете передать запланированное задание Disable-ScheduledJobв .

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

None

По умолчанию этот командлет не возвращает выходные данные.

ScheduledJobDefinition

При использовании параметра PassThru этот командлет возвращает запланированное задание, которое отключено.

Примечания

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