Set-JobTrigger

Syntax

Set-JobTrigger
   [-InputObject] <ScheduledJobTrigger[]>
   [-DaysInterval <Int32>]
   [-WeeksInterval <Int32>]
   [-RandomDelay <TimeSpan>]
   [-At <DateTime>]
   [-User <String>]
   [-DaysOfWeek <DayOfWeek[]>]
   [-AtStartup]
   [-AtLogOn]
   [-Once]
   [-RepetitionInterval <TimeSpan>]
   [-RepetitionDuration <TimeSpan>]
   [-RepeatIndefinitely]
   [-Daily]
   [-Weekly]
   [-PassThru]
   [<CommonParameters>]

Beschreibung

Das Set-JobTrigger Cmdlet ändert die Eigenschaften der Auftragsauslöser von geplanten Aufträgen. Mit dem Cmdlet können Sie ändern, wann oder wie häufig Aufträge gestartet werden, oder von zeitbasierten Zeitplänen zu Zeitplänen wechseln, die durch einen Anmelde- oder Startvorgang ausgelöst werden.

Ein Auftragstrigger definiert einen wiederkehrenden Zeitplan oder bedingungen für das Starten eines geplanten Auftrags. Obwohl Auftragstrigger nicht auf dem Datenträger gespeichert werden, können Sie die Auftragstrigger geplanter Aufträge ändern, die auf dem Datenträger gespeichert werden.

Um einen Auftragstrigger eines geplanten Auftrags zu ändern, verwenden Sie zunächst das Get-JobTrigger Cmdlet, um den Auftragstrigger eines geplanten Auftrags abzurufen. Übergeben Sie dann den Trigger an Set-JobTrigger den Trigger, oder speichern Sie den Trigger in einer Variablen, und verwenden Sie den InputObject-Parameter des Set-JobTrigger Cmdlets, um den Trigger zu identifizieren. Verwenden Sie zum Ändern des Auftragstriggers die Parameter Set-JobTrigger zum Erneuten Standard.

Wenn Sie den Typ eines Auftragstriggers ändern, z. B. das Ändern eines Auftragstriggers von einem täglichen oder wöchentlichen Trigger in einen AtLogon-Trigger , werden die ursprünglichen Triggereigenschaften gelöscht. Wenn Sie jedoch die Werte des Triggers, aber nicht dessen Typ ändern, also z. B. die Tage in einem Weekly-Trigger, werden nur die Eigenschaften geändert, die Sie angeben. Alle anderen Eigenschaften des ursprünglichen Auftragstriggers werden beibehalten.

Set-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: Ändern der Tage in einem Auftragstrigger

Dieses Beispiel zeigt, wie die Tage in einem Weekly-Auftragstrigger geändert werden.

Get-JobTrigger -Name "DeployPackage"

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Weekly          9/29/2011 12:00:00 AM  {Wednesday, Saturday}   True

Get-JobTrigger -Name "DeployPackage" | Set-JobTrigger -DaysOfWeek "Wednesday", "Sunday" -Passthru

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Weekly          9/29/2011 12:00:00 AM  {Wednesday, Sunday}     True

Der erste Befehl verwendet das Get-JobTrigger Cmdlet, um den Auftragstrigger des DeployPackage geplanten Auftrags abzurufen. Die Ausgabe zeigt, dass der Trigger den Auftrag mittwochs und samstags um Mitternacht startet.

Der zweite Befehl verwendet das Get-JobTrigger Cmdlet, um den Auftragstrigger des DeployPackage geplanten Auftrags abzurufen. Ein Pipelineoperator (|) sendet den Trigger an das Set-JobTrigger Cmdlet, wodurch der Auftragsauslöser geändert wird, sodass er den DeployPackage Auftrag an Mittwochs und Sonntagen startet. Der Befehl verwendet den Passthru-Parameter , um den Trigger nach der Änderung zurückzugeben.

Dieser Befehl ist nicht erforderlich. Er soll lediglich die Auswirkung der Triggeränderung veranschaulichen.

Beispiel 2: Ändern des Auftragstriggertyps

In diesem Beispiel wird veranschaulicht, wie der Typ des Auftragstriggers geändert wird, der einen Auftrag startet. Die Befehle in diesem Beispiel ersetzen einen AtStartup Auftragstrigger durch einen wöchentlichen Trigger.

Get-JobTrigger -Name "Inventory"

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           9/27/2011 11:00:00 PM                          True
2          AtStartup                                                      True

Get-JobTrigger -Name "Inventory" -TriggerID 2 | Set-JobTrigger -Weekly -WeeksInterval 4 -DaysOfWeek Monday -At "12:00 AM"

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           9/27/2011 11:00:00 PM                          True
2          Weekly          10/31/2011 12:00:00 AM {Monday}                True

Der erste Befehl verwendet das Get-JobTrigger Cmdlet, um den Auftragstrigger des Inventory geplanten Auftrags abzurufen. Die Ausgabe zeigt, dass der Auftrag zwei Trigger für einen täglichen Trigger und einen AtStartup-Trigger hat.

Der zweite Befehl verwendet das Get-JobTrigger Cmdlet, um den AtStartup-Auftragstrigger des Inventory Auftrags abzurufen. Der Befehl verwendet den TriggerID-Parameter , um den Auftragstrigger zu identifizieren. Ein Pipelineoperator (|) sendet den Auftragstrigger an das Set-JobTrigger Cmdlet, wodurch er in einen wöchentlichen Auftragstrigger geändert wird, der alle vier Wochen am Montag um Mitternacht ausgeführt wird. Der Befehl verwendet den Passthru-Parameter , um den Trigger nach der Änderung zurückzugeben.

Dieser Befehl ist nicht erforderlich. Er soll lediglich die Auswirkung der Triggeränderung veranschaulichen.

Beispiel 3: Ändern des Benutzers in einem Remoteauftragsauslöser

Invoke-Command -ComputerName "Server01" -ScriptBlock {Get-ScheduledJob | Get-JobTrigger | Where-Object {$_.User} | Set-JobTrigger -User "Domain01/Admin02"}

Dieser Befehl ändert den Benutzer in allen AtLogon-Auftragsauslösern von geplanten Aufträgen auf dem Server01-Computer.

Der Befehl verwendet das Invoke-Command Cmdlet, um einen Befehl auf dem Server01-Computer auszuführen.

Der Remotebefehl beginnt mit einem Get-ScheduledJob Befehl, der alle geplanten Aufträge auf dem Computer abruft. Die geplanten Aufträge werden an das Get-JobTrigger Cmdlet weitergeleitet, das die Auftragsauslöser der geplanten Aufträge abruft. Jeder Auftragstrigger enthält eine JobDefinition-Eigenschaft, die den geplanten Auftrag enthält, sodass der Trigger erneut Standard dem geplanten Auftrag zugeordnet ist, auch wenn er geändert wird.

Die Auftragstrigger werden an das Where-Object Cmdlet weitergeleitet, das Auftragstrigger mit der User-Eigenschaft abruft. Die ausgewählten Auftragstrigger werden an das Set-JobTrigger Cmdlet weitergeleitet, das den Benutzer in Domain01\Admin02.

Beispiel 4: Ändern eines von vielen Auftragstriggern

Get-JobTrigger -Name "SecurityCheck"

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           4/24/2013 3:00:00 AM                           True
2          Weekly          4/24/2013 4:00:00 PM   {Sunday}                True
3          Once            4/24/2013 4:00:00 PM                           True

Get-JobTrigger -Name "SecurityCheck" -TriggerID 3 | Format-List -Property *

At                 : 4/24/2012 4:00:00 PM
DaysOfWeek         :
Interval           : 1
Frequency          : Once
RandomDelay        : 00:00:00
RepetitionInterval : 01:00:00
RepetitionDuration : 1.00:00:00
User               :
Id                 : 3
Enabled            : True
JobDefinition      : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Get-JobTrigger -Name "SecurityCheck" -TriggerId 3 | Set-JobTrigger -RepetitionInterval (New-TimeSpan -Minutes 90)
Get-JobTrigger -Name "SecurityCheck" -TriggerID 3 | Format-List -Property *

At                 : 4/24/2012 4:00:00 PM
DaysOfWeek         :
Interval           : 1
Frequency          : Once
RandomDelay        : 00:00:00
RepetitionInterval : 01:30:00
RepetitionDuration : 1.00:00:00
User               :
Id                 : 3
Enabled            : True
JobDefinition      : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Die Befehle in diesem Beispiel ändern das Wiederholungsintervall des Einmalauftragsauslöser des SecurityCheck geplanten Auftrags von alle 60 Minuten in alle 90 Minuten. Der SecurityCheck geplante Auftrag verfügt über drei Auftragstrigger, sodass die Befehle den TriggerId-Parameter des Get-JobTrigger Cmdlets verwenden, um den Auftragsauslöser zu identifizieren, der geändert wird.

Der erste Befehl verwendet das Get-JobTrigger Cmdlet, um alle Auftragstrigger des SecurityCheck geplanten Auftrags abzurufen. Die Ausgabe, in der die IDs des Auftragsauslöser angezeigt werden, zeigt an, dass der Einmalauftragstrigger über eine ID von 3verfügt.

Der zweite Befehl verwendet den TriggerID-Parameter des Get-JobTrigger Cmdlets, um den Once-Trigger des SecurityCheck geplanten Auftrags abzurufen. Mit dem Befehl wird der Trigger an das Format-List Cmdlet weitergeleitet, der alle Eigenschaften des Einmalauftragsauslöser anzeigt. Die Ausgabe zeigt, dass der Trigger den Auftrag einmal pro Stunde startet (RepetitionInterval ist 1 Stunde) für einen Tag (Wiederholungsduration ist 1 Tag).

Der dritte Befehl ändert das Wiederholungsintervall des Auftragstriggers von einer Stunde auf 90 Minuten. Der Befehl gibt keine Ausgabe zurück.

Der vierte Befehl zeigt den Effekt der Änderung an. Die Ausgabe zeigt, dass der Trigger den Auftrag einmal alle 90 Minuten startet (WiederholungInterval beträgt 1 Stunde, 30 Minuten) für einen Tag (Wiederholungsduration ist 1 Tag).

Parameter

-At

-AtLogOn

-AtStartup

-Daily

-DaysInterval

-DaysOfWeek

-InputObject

-Once

-PassThru

-RandomDelay

-RepeatIndefinitely

-RepetitionDuration

-RepetitionInterval

-User

-Weekly

-WeeksInterval

Eingaben

ScheduledJobTrigger

Sie können einen Auftragstrigger an dieses Cmdlet weiterleiten.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

ScheduledJobTrigger

Wenn Sie den Parameter "PassThru " verwenden, gibt dieses Cmdlet den Auftrag aus, der geändert wurde.

Hinweise

• Auftragstrigger verfügen über eine JobDefinition-Eigenschaft , die sie dem geplanten Auftrag zuordnet. Wenn Sie den Auftragstrigger eines geplanten Auftrags ändern, wird der Auftrag geändert. Sie müssen keinen Befehl verwenden Set-ScheduledJob , um den geänderten Trigger auf den geplanten Auftrag anzuwenden.

Ä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