Freigeben über

Add-JobTrigger

Modul:
PSScheduledJob Module

Fügt Auftragstrigger zu geplanten Aufträgen hinzu.

Syntax

JobDefinition (Standard) 

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-InputObject] <ScheduledJobDefinition[]>
    [<CommonParameters>]

JobDefinitionName 

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-Name] <String[]>
    [<CommonParameters>]

JobDefinitionId 

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-Id] <Int32[]>
    [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Add-JobTrigger werden geplanten Aufträgen Auftragstrigger hinzugefügt. Sie können es verwenden, um mehrere Trigger zu mehreren geplanten Aufträgen hinzuzufügen.

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

Verwenden Sie den Trigger-Parameter von Add-JobTrigger , um die hinzuzufügenden Auftragstrigger zu identifizieren. Verwenden Sie die Parameter Name, ID oder InputObject von Add-JobTrigger , um 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 Cmdlet New-JobTrigger, oder verwenden Sie eine Hashtabelle, um den Auftragstrigger anzugeben.

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

Beispiele

Beispiel 1: Hinzufügen eines Auftragstriggers zu einem geplanten Auftrag

PS C:\> $Daily = New-JobTrigger -Daily -At 3AMPS
PS C:\> Add-JobTrigger -Trigger $Daily -Name "TestJob"

Diese Befehle fügen den Täglichen Auftragstrigger zum geplanten TestJob-Auftrag hinzu.

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

Im zweiten Befehl wird das Cmdlet Add-JobTrigger verwendet, um den Auftragstrigger in der Variablen $Startup dem geplanten TestJob-Auftrag hinzuzufügen.

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

PS C:\> Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

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

Beispiel 3: Kopieren eines Auftragstriggers

PS C:\> $T = Get-JobTrigger -Name "BackupArchives"
PS C:\> Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

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

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

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

Parameter

-Id

Gibt die Identifikationsnummern der geplanten Aufträge an. Add-JobTrigger fügt den Auftragstrigger den angegebenen geplanten Aufträgen hinzu.

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

Parametereigenschaften

Typ:

Int32[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

JobDefinitionId
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 ScheduledJob-Objekte auch über die Pipeline an Add-JobTrigger übergeben.

Parametereigenschaften

Typ:

ScheduledJobDefinition[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

JobDefinition
Position:0
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt die Namen der geplanten Aufträge an. Add-JobTrigger fügt die Auftragstrigger den angegebenen geplanten Aufträgen hinzu. Platzhalter werden unterstützt.

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

JobDefinitionName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 abruft, z. B. einen Get-JobTrigger Befehl. Sie können ScheduledJobTrigger-Objekte auch über die Pipeline an Add-JobTrigger übergeben.

Parametereigenschaften

Typ:

ScheduledJobTrigger[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

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.

Eingaben

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger, Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Sie können Auftragstrigger oder geplante Aufträge über die Pipeline an Add-JobTrigger übergeben.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.