Add-JobTrigger
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.
Typ: | Int32[] |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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
.
Typ: | ScheduledJobDefinition[] |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | 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.
Typ: | String[] |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | 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
.
Typ: | ScheduledJobTrigger[] |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Sie können einen Auftragstrigger an dieses Cmdlet weiterleiten.
Sie können einen geplanten Auftrag an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Ähnliche Themen
- Add-JobTrigger
- Disable-JobTrigger
- Disable-ScheduledJob
- Enable-JobTrigger
- Enable-ScheduledJob
- Get-JobTrigger
- Get-ScheduledJob
- Get-ScheduledJobOption
- New-JobTrigger
- New-ScheduledJobOption
- Register-ScheduledJob
- Remove-JobTrigger
- Set-JobTrigger
- Set-ScheduledJob
- Set-ScheduledJobOption
- Unregister-ScheduledJob