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

Unregister-ScheduledJob

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

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

Синтаксис

Unregister-ScheduledJob
          [-InputObject] <ScheduledJobDefinition[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Id] <Int32[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Name] <String[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Описание

Командлет Unregister-ScheduledJob удаляет запланированные задания с локального компьютера.

При удалении или отмене регистрации запланированного задания удаляет каталог запланированного задания (в файле$HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directory), который содержит XML-файл, определяющий запланированное заданиеUnregister-ScheduledJob, журнал выполнения задания и все результаты задания. Это действие также удаляет задание из планировщика заданий.

Unregister-ScheduledJob удаляет только запланированные задания, созданные с помощью командлета Register-ScheduledJob . Он не удаляет запланированные задания, созданные в планировщике заданий.

Параметры можно использовать для удаления запланированных Unregister-ScheduledJob заданий по идентификатору или имени или конвейеру запланированных заданий в Get-ScheduledJobUnregister-ScheduledJob.

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

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

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

Примеры

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

Unregister-ScheduledJob TestJob

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

Пример 2. Удаление всех запланированных заданий

Get-ScheduledJob | Unregister-ScheduledJob -Force
Unregister-ScheduledJob -Name "*" -Force

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

Первая команда использует Get-ScheduledJob командлет для получения всех запланированных заданий на локальном компьютере. Оператор конвейера (|) отправляет запланированные задания Unregister-ScheduleJob, в которые удаляются.

Вторая команда использует параметр Unregister-ScheduledJob Name со значением всех (*) для удаления всех запланированных заданий.

Обе команды используют параметр Force , который удаляет запланированное задание, даже если выполняется экземпляр задания.

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

Invoke-Command -ComputerName "Server01" { Unregister-ScheduledJob -Name "Test*"}

Эта команда удаляет запланированные задания с именами, начинающимися с тестирования на удаленном компьютере Server01. Команда использует Invoke-Command командлет для выполнения Unregister-ScheduledJob команды на компьютере Server02.

Параметры

-Confirm

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

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

-Force

Удаляет запланированное задание, даже если выполняется его экземпляр. По умолчанию Unregister-ScheduledJob не прерывает выполнение заданий.

Type:SwitchParameter
Position:Named
Default value:None
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

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

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

-WhatIf

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

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

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

ScheduledJobDefinition

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

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

None

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