Remove-JobTrigger

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

Syntax

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 plánovaných úloh.

Trigger úlohy definuje opakující se 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-JobTriggerName, ID nebo InputObject identifikujte naplánované úlohy, ze kterých jsou triggery odebrány. Pomocí parametru TriggerID identifikujte aktivační události úlohy, které se mají odstranit. Ve výchozím nastavení Remove-JobTrigger odstraní všechny triggery úloh naplánované úlohy.

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

Další informace o naplánovaných úlohách najdete v tématu Témata v modulu PSScheduledJob. Importujte modul PSScheduledJob a zadejte: Get-Help about_Scheduled* nebo si prohlédněte about_Scheduled_Jobs.

Tato rutina byla zavedena v Windows PowerShell 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 aktivačních událostí úlohy

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 na místním počítači. Chcete-li tuto funkci použít, spusťte funkci v relaci a zadejte Delete-AtStartup.

Funkce Delete-AtStartup obsahuje jeden příkaz. Příkaz používá rutinu Get-ScheduledJob k získání naplánovaných úloh 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 triggery ú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 vlastnosti Frekvence aktivační události úlohy se rovná AtStartup.

Objekty JobTrigger mají vlastnost JobDefinition , která obsahuje naplánovanou úlohu, kterou aktivují. Zbytek 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 parametru Remove-JobTriggerInputObject 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í trigger úlohy z úlohy Inventory na počítači Server01.

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

Parametry

-Id

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

Pokud chcete získat identifikační počet naplánovaných úloh v místním počítači nebo vzdáleném počítači, použijte rutinu Get-ScheduledJob .

Type:Int32[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Určuje názvy naplánovaných úloh. Remove-JobTrigger odstraní triggery úlohy ze zadaných naplánovaných úloh. Podporují se zástupné cardy.

Pokud chcete získat názvy naplánovaných úloh na místním počítači nebo vzdáleném počítači, použijte rutinu Get-ScheduledJob .

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TriggerId

Odstraní pouze zadané triggery úloh. Ve výchozím nastavení Remove-JobTrigger odstraní všechny triggery z plá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 plánovaných úloh.

Type:Int32[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Naplánované úlohy můžete do rutiny Remove-JobTrigger převést.

Výstupy

None

Rutina negeneruje žádný výstup.