Remove-JobTrigger

  • Referentie
Module:
PSScheduledJob

Taaktriggers verwijderen uit geplande taken.

Syntax

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 Cmdlets.

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

Remove-JobTrigger is een van een 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: 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 uit in uw sessie en typt Delete-AtStartupu .

De Delete-AtStartup functie bevat één opdracht. De opdracht gebruikt 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 Frequency van de taaktrigger gelijk is aan AtStartup.

JobTrigger-objecten hebben een JobDefinition-eigenschap 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 ForEach-Object cmdlet, 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 gebruikt de Invoke-Command cmdlet om de Remove-JobTrigger cmdlet uit te voeren op de Server01-computer. De Remove-JobTrigger cmdlet gebruikt de id-parameter om de geplande inventaristaak en de TriggerID-parameter te identificeren 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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

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

-Name

Hiermee geeft u de namen van de geplande taken. Remove-JobTrigger verwijdert 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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TriggerId

Hiermee verwijdert u alleen de opgegeven taaktriggers. Verwijdert standaard 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, Remove-JobTrigger verwijdert u de taaktrigger met de opgegeven id uit alle geplande taken.

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

Invoerwaarden

ScheduledJobDefinition

U kunt een geplande taak doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.