Freigeben über

Add-JobTrigger

  • Referenz
Modul:
PSScheduledJob

Fügt geplanten Aufträgen Auftragstrigger hinzu.

Syntax

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<CommonParameters>]

Beschreibung

Das Add-JobTrigger Cmdlet fügt Auftragstrigger zu geplanten Aufträgen hinzu. Sie können es verwenden, um mehreren geplanten Aufträgen mehrere Trigger hinzuzufügen.

Ein Auftragstrigger startet einen geplanten Auftrag in einem einmaligen oder wiederkehrenden Zeitplan oder wenn ein Ereignis auftritt.

Verwenden Sie den Trigger-Parameter , Add-JobTrigger um die hinzuzufügenden Auftragstrigger zu identifizieren. Verwenden Sie die Parameter Name, ID oder InputObject , um Add-JobTrigger den geplanten Auftrag zu identifizieren, dem die Trigger hinzugefügt werden.

Um Auftragstrigger für den Wert des Trigger-Parameters zu erstellen, verwenden Sie das New-JobTrigger Cmdlet, oder verwenden Sie eine Hashtabelle, um den Auftragstrigger anzugeben.

Add-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: Hinzufügen eines Auftragstriggers zu einem geplanten Auftrag

$Daily = New-JobTrigger -Daily -At 3AMPS
Add-JobTrigger -Trigger $Daily -Name "TestJob"

Diese Befehle fügen dem geplanten Auftrag TestJob den Daily-Auftragstrigger hinzu.

Der erste Befehl verwendet das New-JobTrigger Cmdlet, um einen Auftragstrigger zu erstellen, der jeden Tag um 3:00 Uhr einen geplanten Auftrag startet. Der Befehl speichert den Auftragstrigger in der $Daily Variablen.

Der zweite Befehl verwendet das Add-JobTrigger Cmdlet, um den Auftragstrigger in der $Startup Variablen zum geplanten Auftrag TestJob hinzuzufügen.

Beispiel 2: Hinzufügen eines Auftragstriggers zu mehreren geplanten Aufträgen

Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

Dieser Befehl fügt allen geplanten Aufträgen auf dem lokalen Computer einen AtStartup-Auftragstrigger hinzu. Es verwendet die Get-ScheduledJob , um alle geplanten Aufträge auf dem Computer abzurufen. Es verwendet einen Pipelineoperator (|), um die Aufträge an das Add-JobTrigger Cmdlet zu senden, wodurch der Auftragstrigger zu jedem der geplanten Aufträge hinzugefügt wird. Der Wert des Trigger-Parameters ist ein New-JobTrigger Befehl, der den AtStartup-Auftragstrigger erstellt.

Beispiel 3: Kopieren eines Auftragstriggers

$T = Get-JobTrigger -Name "BackupArchives"
Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

Diese Befehle kopieren den Auftragstrigger aus dem geplanten Auftrag BackupArchives und fügen ihn den geplanten Aufträgen TestBackup und BackupLogs hinzu.

Der erste Befehl verwendet das Get-JobTrigger Cmdlet, um den Auftragstrigger des geplanten Auftrags der BackupArchives abzurufen. Der Befehl speichert den Trigger in der $t-Variablen.

Der zweite Befehl verwendet das Add-JobTrigger Cmdlet, um den Auftragstrigger in $t den geplanten Aufträgen "TestBackup" und "BackupLogs" hinzuzufügen.

Parameter

-Id

Gibt die IDs der geplanten Aufträge an. Add-JobTrigger fügt den Auftragtrigger zu den angegebenen geplanten Aufträgen hinzu.

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 Add-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. Add-JobTrigger fügt die Auftragstrigger zu den angegebenen geplanten Aufträgen hinzu. 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

-Trigger

Gibt die hinzuzufügenden Auftragstrigger an. Geben Sie eine Hashtabelle ein, die Auftragstrigger oder eine Variable angibt, die ScheduledJobTrigger-Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der ScheduledJobTrigger-Objekte wie einen Get-JobTrigger Befehl abruft. Sie können auch ScheduledJobTrigger-Objekte an Add-JobTrigger.

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

Eingaben

ScheduledJobTrigger

Sie können einen Auftragstrigger an dieses Cmdlet weiterleiten.

ScheduledJobDefinition

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

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.