Remove-JobTrigger

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

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

Remove-JobTrigger
    [-Id] <Int32[]>
    [-TriggerId <Int32[]>]
    [<CommonParameters>]

Das Cmdlet Remove-JobTrigger löscht Auftragstrigger aus geplanten Aufträgen.

Ein Auftragstrigger definiert einen wiederkehrenden Zeitplan oder bedingungen für das Starten eines geplanten Auftrags. Verwenden Sie zum Verwalten von Auftragstriggern die Cmdlets New-JobTrigger, Add-JobTrigger, Set-JobTrigger und Set-ScheduledJob.

Verwenden Sie die Parameter Name, ID oder InputObject von Remove-JobTrigger , um die geplanten Aufträge zu identifizieren, aus denen die Trigger entfernt werden. Verwenden Sie den parameter TriggerID, um die zu löschenden Auftragsauslöser zu identifizieren. Standardmäßig löscht Remove-JobTrigger alle Auftragstrigger eines geplanten Auftrags.

Remove-JobTrigger gehört zu einer Sammlung von Cmdlets für die Auftragsplanung im PSScheduledJob-Modul, das in Windows PowerShell enthalten ist.

Weitere Informationen zu geplanten Aufträgen finden Sie in den Themen "Info" im PSScheduledJob-Modul. Importieren Sie das PSScheduledJob-Modul, und geben Sie dann Folgendes ein: Get-Help about_Scheduled* oder about_Scheduled_Jobs anzeigen.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

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

Mit diesem Befehl werden alle Auftragstrigger aus dem geplanten Auftrag gelöscht, deren Namen mit "Test" beginnen.

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

Mit diesem Befehl wird nur der dritte Trigger (ID = 3) aus dem geplanten Auftrag "BackupArchive" gelöscht.

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

Diese Funktion löscht alle AtStartup-Auftragsauslöser aus allen Aufträgen auf dem lokalen Computer. Um die Funktion zu verwenden, führen Sie die Funktion in Ihrer Sitzung aus, und geben Sie dann Delete-AtStartupein.

Die Funktion Delete-AtStartup enthält einen einzigen Befehl. Der Befehl verwendet das Cmdlet Get-ScheduledJob, um die geplanten Aufträge auf dem lokalen Computer abzurufen. Ein Pipelineoperator (|) sendet die geplanten Aufträge an das Cmdlet Get-JobTrigger, das alle Auftragstrigger von jedem der geplanten Aufträge abruft. Ein Pipelineoperator sendet die Auftragstrigger an das Cmdlet Where-Object, das Auftragstrigger auswählt, bei denen der Wert der Frequency-Eigenschaft des Auftragstriggers AtStartup entspricht.

JobTrigger- Objekte verfügen über eine JobDefinition- Eigenschaft, die den von ihnen ausgelösten geplanten Auftrag enthält. Der Rest des Befehls verwendet dieses wertvolle Feature.

Ein Pipelineoperator sendet die AtStartup-Auftragstrigger an das Cmdlet ForEach-Object, das einen Remove-JobTrigger-Befehl für jeden AtStartup-Trigger ausführt. Der Wert des InputObject-Parameters von Remove-JobTrigger ist der geplante Auftrag in der JobDefinition-Eigenschaft des Auftragstriggers. Der Wert des parameters TriggerID ist der Bezeichner in der ID-Eigenschaft des Auftragstriggers.

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

Mit diesem Befehl wird der erste Auftragsauslöser aus dem Inventarauftrag auf dem Server01-Computer gelöscht.

Der Befehl verwendet das Cmdlet Invoke-Command, um das Cmdlet Remove-JobTrigger auf dem Computer Server01 auszuführen. Das Cmdlet Remove-JobTrigger verwendet den ID-Parameter, um den geplanten Inventurauftrag zu identifizieren, und den TriggerID-Parameter, um den ersten Trigger anzugeben. Die ID Parameter ist besonders nützlich, wenn mehrere geplante Aufträge dieselben oder ähnliche Namen haben.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können geplante Aufträge über die Pipeline an das Cmdlet Remove-JobTrigger übergeben.

Das Cmdlet generiert keine Ausgabe.