Unregister-ScheduledJob

Reference

Modul:: PSScheduledJob

Odstraní naplánované úlohy v místním počítači.

Syntaxe

Unregister-ScheduledJob
          [-InputObject] <ScheduledJobDefinition[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Unregister-ScheduledJob
          [-Id] <Int32[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Unregister-ScheduledJob
          [-Name] <String[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

Rutina Unregister-ScheduledJob odstraní naplánované úlohy z místního počítače.

Když odstraní nebo zruší registraci naplánované úlohy, Unregister-ScheduledJob odstraní adresář pro naplánovanou úlohu (v $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directory), který obsahuje soubor XML, který definuje naplánovanou úlohu, historii provádění úlohy a všechny výsledky úlohy. Tato akce také odstraní úlohu z Plánovače úloh.

Unregister-ScheduledJob odstraní pouze naplánované úlohy vytvořené pomocí rutiny Register-ScheduledJob. Neodstraní naplánované úlohy vytvořené v Plánovači úloh.

Parametry Unregister-ScheduledJob můžete použít k odstranění plánovaných úloh podle ID nebo názvu nebo kanálu naplánovaných úloh z Get-ScheduledJob do Unregister-ScheduledJob.

Unregister-ScheduledJob je jednou z kolekcí rutin plánování úloh v modulu PSScheduledJob, který je součástí Windows PowerShellu.

Další informace o naplánovaných úlohách naleznete v tématu o tématech v modulu PSScheduledJob. Importujte modul PSScheduledJob a zadejte: Get-Help about_Scheduled* nebo viz about_Scheduled_Jobs.

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

Příklad 1: Odstranění naplánované úlohy

Unregister-ScheduledJob TestJob

Tento příkaz odstraní naplánovanou úlohu TestJob na místním počítači.

Příklad 2: Odstranění všech naplánovaných úloh

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

Tento příklad ukazuje dva různé příkazy, které odstraní všechny naplánované úlohy v místním počítači.

První příkaz používá rutinu Get-ScheduledJob k získání všech naplánovaných úloh na místním počítači. Operátor kanálu (|) odešle naplánované úlohy do Unregister-ScheduleJob, které je odstraní.

Druhý příkaz používá parametr NameUnregister-ScheduledJob s hodnotou všech (*) k odstranění všech naplánovaných úloh.

Oba příkazy používají parametr Force, který odstraní naplánovanou úlohu i v případě, že je spuštěná instance úlohy.

Příklad 3: Odstranění naplánované úlohy na vzdáleném počítači

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

Tento příkaz odstraní naplánované úlohy s názvy, které začínají testem na vzdáleném počítači Serveru01. Příkaz používá rutinu Invoke-Command ke spuštění příkazu Unregister-ScheduledJob na počítači se serverem 02.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

Odstraní naplánovanou úlohu i v případě, že je spuštěná instance úlohy. Ve výchozím nastavení Unregister-ScheduledJob nepřeruší spuštěné úlohy.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Id

Odstraní naplánované úlohy se zadanými identifikačními čísly (ID). Zadejte ID naplánovaných úloh v počítači.

Typ:	Int32[]
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

Určuje naplánovanou úlohu. Zadejte proměnnou, která obsahuje ScheduledJob objekty, nebo zadejte příkaz nebo výraz, který získá ScheduledJob objekty, například Get-ScheduledJob příkaz. Můžete také ScheduledJob objekty Unregister-JobTrigger.

Typ:	ScheduledJobDefinition[]
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

Odstraní naplánované úlohy se zadanými názvy. Zadejte názvy jedné nebo více naplánovaných úloh v počítači. Podporují se zástupné kóty.

Typ:	String[]
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

ScheduledJobDefinition

Do této rutiny můžete převést naplánovanou úlohu.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Sdílet prostřednictvím