Delen via

Remove-JobTrigger

  • Referentie
Module:
PSScheduledJob

Taaktriggers verwijderen uit geplande taken.

Syntaxis

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

Description

De Remove-JobTrigger cmdlet verwijdert taaktriggers uit geplande taken.

Een taaktrigger definieert een terugkerend schema of voorwaarden voor het starten van een geplande taak. Als u taaktriggers wilt beheren, gebruikt u de cmdlets New-JobTrigger, Add-JobTrigger, Set-JobTrigger en Set-ScheduledJob.

Gebruik de parameters Name, IDof InputObject parameters van Remove-JobTrigger om de geplande taken te identificeren waaruit de triggers worden verwijderd. Gebruik de parameter TriggerID om de taaktriggers te identificeren die moeten worden verwijderd. Standaard verwijdert Remove-JobTrigger alle taaktriggers van een geplande taak verwijdert.

Remove-JobTrigger is een van een verzameling jobplannings-cmdlets in de PSScheduledJob-module die is opgenomen in Windows PowerShell.

Zie de onderwerpen Over geplande taken in de PSScheduledJob-module voor meer informatie over geplande taken. Importeer de PSScheduledJob-module en typ vervolgens: Get-Help about_Scheduled* of zie about_Scheduled_Jobs.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

Voorbeelden

Voorbeeld 1: Alle taaktriggers verwijderen

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

Met deze opdracht worden alle taaktriggers verwijderd uit geplande taak met namen die beginnen met Testen.

Voorbeeld 2: Geselecteerde taaktriggers verwijderen

PS C:\> Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Met deze opdracht verwijdert u alleen de derde trigger (ID = 3) uit de geplande BackupArchive-taak.

Voorbeeld 3: AtStartup-taaktriggers verwijderen uit alle geplande taken

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

Met deze functie worden alle AtStartup-taaktriggers verwijderd uit alle taken op de lokale computer. Als u de functie wilt gebruiken, voert u de functie in uw sessie uit en typt u Delete-AtStartup.

De functie Delete-AtStartup bevat één opdracht. De opdracht maakt gebruik van de Get-ScheduledJob cmdlet om de geplande taken op de lokale computer op te halen. Een pijplijnoperator (|) verzendt de geplande taken naar de cmdlet Get-JobTrigger, waarmee alle taaktriggers van elk van de geplande taken worden opgehaald. Een pijplijnoperator verzendt de taaktriggers naar de Where-Object cmdlet, die taaktriggers selecteert waarbij de waarde van de eigenschap Frequentie van de taaktrigger gelijk is aan AtStartup.

JobTrigger-objecten een eigenschap JobDefinition bevat die de geplande taak bevat die ze activeren. De rest van de opdracht maakt gebruik van die waardevolle functie.

Een pijplijnoperator verzendt de AtStartup-taaktriggers naar de cmdlet ForEach-Object, waarmee een opdracht Remove-JobTrigger op elke AtStartup-trigger wordt uitgevoerd. De waarde van de parameter InputObject van Remove-JobTrigger is de geplande taak in de eigenschap JobDefinition van de taaktrigger. De waarde van de parameter TriggerID is de id in de id-eigenschap van de taaktrigger.

Voorbeeld 4: Een taaktrigger verwijderen uit een externe geplande taak

PS C:\> Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

Met deze opdracht wordt de eerste taaktrigger verwijderd uit de inventaristaak op de Server01-computer.

De opdracht gebruikt de cmdlet Invoke-Command om de cmdlet Remove-JobTrigger uit te voeren op de Server01-computer. De Remove-JobTrigger cmdlet gebruikt de parameter ID om de geplande inventaristaak te identificeren en de parameter TriggerID om de eerste trigger op te geven. De -id parameter is vooral handig wanneer meerdere geplande taken dezelfde of vergelijkbare namen hebben.

Parameters

-Id

Hiermee geeft u de identificatienummers van de geplande taken op. Remove-JobTrigger verwijdert taaktriggers uit de opgegeven geplande taken.

Gebruik de Get-ScheduledJob-cmdlet om het identificatienummer van geplande taken op de lokale computer of een externe computer op te halen.

Type:Int32[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u de geplande taken op. Voer een variabele in die ScheduledJob objecten bevat of typ een opdracht of expressie die ScheduledJob objecten, zoals een Get-ScheduledJob opdracht. U kunt ook objecten ScheduledJob doorsluisen naar Remove-JobTrigger-.

Type:ScheduledJobDefinition[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de namen van de geplande taken. Remove-JobTrigger verwijdert u de taaktriggers uit de opgegeven geplande taken. Jokertekens worden ondersteund.

Gebruik de Get-ScheduledJob-cmdlet om de namen van geplande taken op de lokale computer of een externe computer op te halen.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TriggerId

Hiermee verwijdert u alleen de opgegeven taaktriggers. Standaard verwijdert Remove-JobTrigger alle triggers uit de geplande taken verwijdert. Gebruik deze parameter wanneer de geplande taken meerdere taaktriggers hebben.

Voer de trigger-id's in van een of meer taaktriggers van een geplande taak. Als u meerdere geplande taken opgeeft, Remove-JobTrigger de taaktrigger verwijdert met de opgegeven id van alle geplande taken.

Type:Int32[]
Position:Named
Default value:All triggers
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

ScheduledJobDefinition

U kunt geplande taken doorsluisen naar de Remove-JobTrigger cmdlet.

Uitvoerwaarden

None

De cmdlet genereert geen uitvoer.