Sdílet prostřednictvím

Remove-JobTrigger

  • Reference
Modul:
PSScheduledJob

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

Syntax

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

Description

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

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

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

Remove-JobTrigger je 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ématech O produktu v modulu PSScheduledJob. Importujte modul PSScheduledJob a zadejte: Get-Help about_Scheduled* nebo se podívejte about_Scheduled_Jobs.

Tato rutina byla zavedena v Windows PowerShell 3.0.

Příklady

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

PS C:\> Remove-JobTrigger -Name "Test*"

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

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

PS C:\> 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ů úloh AtStartup ze všech naplánovaných úloh

PS C:\> 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 úloh AtStartup ze všech úloh v místním počítači. Pokud chcete funkci použít, spusťte ji v relaci a zadejte Delete-AtStartup.

Funkce Delete-AtStartup obsahuje jeden příkaz. Příkaz použije rutinu Get-ScheduledJob k získání naplánovaných úloh v místním počítači. Operátor kanálu (|) odešle naplánované úlohy do rutiny Get-JobTrigger, která získá všechny triggery úloh z každé z plánovaných úloh. Operátor kanálu odešle triggery úlohy do rutiny Where-Object, která vybere triggery úloh, u kterých se hodnota vlastnosti Frequency triggeru úlohy rovná AtStartup.

JobTrigger objekty 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 ForEach-Object, která spustí příkaz Remove-JobTrigger na každém triggeru AtStartup. Hodnota parametru InputObjectRemove-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

PS C:\> 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 ke spuštění rutiny Remove-JobTrigger na počítači Server01. Rutina Remove-JobTrigger používá parametr ID k identifikaci naplánované úlohy 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ázev.

Parametry

-Id

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

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

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

-InputObject

Určuje naplánované úlohy. Zadejte proměnnou, která obsahuje 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é nasměrovat na Remove-JobTrigger.

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

-Name

Určuje názvy naplánovaných úloh. Remove-JobTrigger odstraní triggery úloh ze zadaných naplánovaných úloh. Jsou podporovány zástupné é ho.

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

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

-TriggerId

Odstraní pouze zadané triggery ú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 triggerů úloh.

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

Type:Int32[]
Position:Named
Default value:All triggers
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

ScheduledJobDefinition

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

Výstupy

None

Rutina negeneruje žádný výstup.