Remove-JobTrigger

  • Referenz
Modul:
PSScheduledJob

Löschen von Auftragstriggern aus geplanten Aufträgen.

Syntax

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

Beschreibung

Das Remove-JobTrigger Cmdlet löscht Auftragsauslöser 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 New-JobTrigger-, Add-JobTrigger-, Set-JobTrigger- und Set-ScheduledJob Cmdlets.

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

Remove-JobTrigger ist eine Sammlung von Auftragsplanungs-Cmdlets im PSScheduledJob-Modul, das in Windows PowerShell enthalten ist.

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

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Löschen aller Auftragstrigger

Remove-JobTrigger -Name "Test*"

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

Beispiel 2: Löschen ausgewählter Auftragsauslöser

Remove-JobTrigger -Name "BackupArchive" -TriggerID 3

Dieser Befehl löscht nur den dritten Trigger (ID = 3) aus dem geplanten Auftrag BackupArchive.

Beispiel 3: Löschen von AtStartup-Auftragsauslösern aus allen geplanten Aufträgen

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-Auftragstrigger 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 Delete-AtStartupdann ein.

Die Delete-AtStartup Funktion enthält einen einzelnen Befehl. Der Befehl verwendet das Get-ScheduledJob Cmdlet, um die geplanten Aufträge auf dem lokalen Computer abzurufen. Ein Pipelineoperator (|) sendet die geplanten Aufträge an das Get-JobTrigger Cmdlet, das alle Auftragstrigger aus jedem der geplanten Aufträge abruft. Ein Pipelineoperator sendet die Auftragstrigger an das Where-Object Cmdlet, wodurch der Auftragsauslöser ausgewählt wird, wobei der Wert der Frequency-Eigenschaft des Auftragstriggers "AtStartup" entspricht.

JobTrigger-Objekte verfügen über eine JobDefinition-Eigenschaft , die den geplanten Auftrag enthält, den sie auslösen. Im übrigen Teil des Befehls wird dieses hilfreiche Feature verwendet.

Ein Pipelineoperator sendet die AtStartup-Auftragstrigger an das ForEach-Object Cmdlet, 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 TriggerID-Parameters ist der Bezeichner in der ID-Eigenschaft des Auftragstriggers.

Beispiel 4: Löschen eines Auftragstriggers aus einem remote geplanten Auftrag

Invoke-Command -ComputerName "Server01" { Remove-JobTrigger -ID 38 -TriggerID 1 }

Dieser Befehl löscht den ersten Auftragstrigger aus dem Inventurauftrag auf dem Computer Server01.

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

Parameter

-Id

Gibt die IDs der geplanten Aufträge an. Remove-JobTrigger löscht Auftragsauslöser aus den angegebenen geplanten Aufträgen.

Verwenden Sie das Get-ScheduledJob Cmdlet, um die Identifikationsnummer der geplanten Aufträge auf dem lokalen Computer oder einem Remotecomputer abzurufen.

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

-InputObject

Gibt die geplanten Aufträge an. Geben Sie eine Variable ein, die ScheduledJob-Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der ScheduledJob-Objekte abruft, z. B. einen Get-ScheduledJob Befehl. Sie können auch ScheduledJob-Objekte an Remove-JobTrigger.

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

-Name

Gibt die Namen geplanter Aufträge an. Remove-JobTrigger löscht die Auftragsauslöser aus den angegebenen geplanten Aufträgen. Platzhalter werden unterstützt.

Verwenden Sie das Get-ScheduledJob Cmdlet, um die Namen der geplanten Aufträge auf dem lokalen Computer oder einem Remotecomputer abzurufen.

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

-TriggerId

Löscht nur die angegebenen Auftragstrigger. Remove-JobTrigger Standardmäßig werden alle Auslöser aus den geplanten Aufträgen gelöscht. Verwenden Sie diesen Parameter, wenn die geplanten Aufträge mehrere Auftragstrigger aufweisen.

Geben Sie die Trigger-ID mindestens eines Auftragstriggers eines geplanten Auftrags ein. Wenn Sie mehrere geplante Aufträge angeben, Remove-JobTrigger löscht der Auftragsauslöser mit der angegebenen ID aus allen geplanten Aufträgen.

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

Eingaben

ScheduledJobDefinition

Sie können einen geplanten Auftrag an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.