Delen via

Remove-JobTrigger

  • Referentie
Module:
PSScheduledJob

Taaktriggers verwijderen uit geplande taken.

Syntaxis

Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-InputObject] <ScheduledJobDefinition[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Id] <Int32[]>
      [<CommonParameters>]
Remove-JobTrigger
      [-TriggerId <Int32[]>]
      [-Name] <String[]>
      [<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.

Remove-JobTrigger is een van de verzameling cmdlets voor taakplanning 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

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

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

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 Get-JobTrigger-cmdlet, 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 Remove-JobTrigger opdracht wordt uitgevoerd op elke AtStartup-trigger. 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

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 maakt gebruik van de Invoke-Command cmdlet om de Remove-JobTrigger cmdlet uit te voeren op de Server01-computer. De Remove-JobTrigger-cmdlet gebruikt de parameter -id om de geplande inventaristaak en de parameter TriggerID op te geven 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 ScheduledJob objecten 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. 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, verwijdert Remove-JobTrigger de taaktrigger met de opgegeven id uit alle geplande taken.

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

Invoerwaarden

ScheduledJobDefinition

U kunt een geplande taak doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.