Sdílet prostřednictvím

Remove-JobTrigger

  • Reference
Modul:
PSScheduledJob

Odstraňte triggery úloh z naplánovaných úloh.

Syntaxe

Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-InputObject] <ScheduledJobDefinition[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Id] <Int32[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Name] <String[]>
      [<CommonParameters>]

Description

Rutina Remove-JobTrigger odstraní triggery úloh z naplánovaných úloh.

Trigger úlohy definuje opakovaný plán nebo podmínky pro spuštění naplánované úlohy. Ke správě triggerů úloh použijte rutiny New-JobTrigger, Add-JobTrigger, Set-JobTrigger a Set-ScheduledJob Rutiny.

Pomocí parametrů Remove-JobTrigger Name, ID nebo InputObject identifikujte naplánované úlohy, ze kterých jsou triggery odebrány. Pomocí parametru TriggerID identifikujte triggery úlohy, které se mají odstranit. Ve výchozím nastavení Remove-JobTrigger odstraní všechny triggery úloh naplánované úlohy.

Remove-JobTrigger 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. Naimportujte modul PSScheduledJob a zadejte: Get-Help about_Scheduled* nebo se podívejte na about_Scheduled_Jobs.

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

Příklad 1: Odstranění všech triggerů úloh

Remove-JobTrigger -Name "Test*"

Tento příkaz odstraní všechny triggery úloh z naplánované úlohy, které mají názvy začínající testem.

Příklad 2: Odstranění vybraných triggerů úloh

Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Tento příkaz odstraní pouze třetí trigger (ID = 3) z naplánované úlohy BackupArchive.

Příklad 3: Odstranění triggerů úlohy AtStartup ze všech naplánovaných úloh

function Delete-AtStartup
{
    Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.Frequency -eq "AtStartup"} | ForEach-Object { Remove-JobTrigger -InputObject $_.JobDefinition -TriggerID $_.ID}
}

Tato funkce odstraní všechny triggery úlohy AtStartup ze všech úloh v místním počítači. Chcete-li použít funkci, spusťte funkci v relaci a zadejte Delete-AtStartup.

Funkce Delete-AtStartup obsahuje jeden příkaz. Příkaz pomocí rutiny Get-ScheduledJob získá naplánované úlohy na místním počítači. Operátor kanálu (|) odešle naplánované úlohy do Get-JobTrigger rutiny, která získá všechny aktivační události úlohy z každé naplánované úlohy. Operátor kanálu odešle aktivační události úlohy do Where-Object rutiny, která vybere aktivační události úlohy, kde hodnota frequency vlastnosti triggeru úlohy se rovná AtStartup.

Objekty JobTrigger mají JobDefinition vlastnost, která obsahuje naplánovanou úlohu, kterou aktivují. Zbývající část příkazu používá tuto cennou funkci.

Operátor kanálu odešle triggery úlohy AtStartup do rutiny, která spustí Remove-JobTrigger příkaz na každém triggeru ForEach-Object AtStartup. Hodnota InputObject parametru Remove-JobTrigger je naplánovaná úloha ve vlastnosti JobDefinition triggeru úlohy. Hodnota parametru TriggerID je identifikátor ve vlastnosti ID triggeru úlohy.

Příklad 4: Odstranění triggeru úlohy ze vzdálené naplánované úlohy

Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

Tento příkaz odstraní první aktivační událost úlohy z úlohy Inventory na počítači Server01.

Příkaz používá rutinu Invoke-Command Remove-JobTrigger ke spuštění rutiny na počítači Server01. Rutina Remove-JobTrigger pomocí parametru ID identifikuje naplánovanou úlohu Inventory a parametr TriggerID k určení prvního triggeru. Parametr ID je užitečný zejména v případech, kdy má více naplánovaných úloh stejné nebo podobné názvy.

Parametry

-Id

Určuje identifikační čísla naplánovaných úloh. Remove-JobTrigger odstraní triggery úloh ze zadaných naplánovaných úloh.

K získání identifikačního počtu naplánovaných úloh na místním počítači nebo vzdáleném počítači použijte rutinu Get-ScheduledJob .

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ánované úlohy. Zadejte proměnnou obsahující objekty ScheduledJob nebo zadejte příkaz nebo výraz, který získá objekty ScheduledJob , například Get-ScheduledJob příkaz. Objekty ScheduledJob můžete také převést na Remove-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

Určuje názvy naplánovaných úloh. Remove-JobTrigger odstraní aktivační události úlohy ze zadaných naplánovaných úloh. Podporují se zástupné kóty.

Názvy naplánovaných úloh získáte na místním počítači nebo ve vzdáleném počítači pomocí rutiny Get-ScheduledJob .

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

-TriggerId

Odstraní pouze zadané aktivační události úlohy. Ve výchozím nastavení Remove-JobTrigger odstraní všechny triggery z naplánovaných úloh. Tento parametr použijte, pokud mají naplánované úlohy více aktivačních událostí úlohy.

Zadejte ID aktivační události jedné nebo více aktivačních událostí úlohy naplánované úlohy. Pokud zadáte více naplánovaných úloh, Remove-JobTrigger odstraní trigger úlohy se zadaným ID ze všech naplánovaných úloh.

Typ:Int32[]
Position:Named
Default value:None
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.