Set-JobTrigger

Odwołanie

Moduł:: PSScheduledJob

Zmienia wyzwalacz zadania zaplanowanego.

Składnia

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>]

Opis

Polecenie cmdlet Set-JobTrigger zmienia właściwości wyzwalaczy zadań zaplanowanych. Można go użyć do zmiany czasu lub częstotliwości, w której zadania są uruchamiane lub zmieniane z harmonogramów opartych na czasie na harmonogramy wyzwalane przez logowanie lub uruchamianie.

Wyzwalacz zadania definiuje cykliczny harmonogram lub warunki uruchamiania zaplanowanego zadania. Mimo że wyzwalacze zadań nie są zapisywane na dysku, można zmienić wyzwalacze zadań zaplanowanych, które są zapisywane na dysku.

Aby zmienić wyzwalacz zadania zaplanowanego zadania, zacznij od użycia polecenia cmdlet Get-JobTrigger w celu pobrania wyzwalacza zadania zaplanowanego zadania. Następnie należy przekazać potok wyzwalacza do polecenia Set-JobTrigger lub zapisać wyzwalacz w zmiennej i użyć parametru InputObject polecenia cmdlet Set-JobTrigger w celu zidentyfikowania wyzwalacza. Użyj pozostałych parametrów polecenia Set-JobTrigger , aby zmienić wyzwalacz zadania.

Po zmianie typu wyzwalacza zadania, takiego jak zmiana wyzwalacza zadania z wyzwalacza dziennego lub tygodniowego na wyzwalacz AtLogon , oryginalne właściwości wyzwalacza zostaną usunięte. Jeśli jednak zmienisz wartości wyzwalacza, ale nie jego typ, taki jak zmiana dni w wyzwalaczu tygodniowym, zostaną zmienione tylko określone właściwości. Wszystkie inne właściwości oryginalnego wyzwalacza zadania są zachowywane.

Set-JobTrigger jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który jest uwzględniony w Windows PowerShell.

Aby uzyskać więcej informacji na temat zaplanowanych zadań, zobacz temat Informacje w module PSScheduledJob. Zaimportuj moduł PSScheduledJob, a następnie wpisz polecenie: Get-Help about_Scheduled* lub zobacz about_Scheduled_Jobs.

To polecenie cmdlet zostało wprowadzone w Windows PowerShell 3.0.

Przykłady

Przykład 1. Zmiana dni w wyzwalaczu zadania

PS C:\> Get-JobTrigger -Name "DeployPackage"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Weekly          9/29/2011 12:00:00 AM  {Wednesday, Saturday}   True

The second command uses the Get-JobTrigger cmdlet to get the job trigger of the DeployPackage scheduled job. A pipeline operator (|) sends the trigger to the **Set-JobTrigger** cmdlet, which changes the job trigger so that it starts the DeployPackage job on Wednesdays and Sundays. The command uses the *Passthru* parameter to return the trigger after the change.
PS C:\> 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

W tym przykładzie pokazano, jak zmienić dni w wyzwalaczu zadania tygodniowego.

Pierwsze polecenie używa polecenia cmdlet Get-JobTrigger, aby uzyskać wyzwalacz zadania zaplanowanego zadania DeployPackage. Dane wyjściowe pokazują, że wyzwalacz uruchamia zadanie o północy w środy i soboty.

To polecenie nie jest wymagane; jest uwzględniana tylko w celu pokazania efektu zmiany wyzwalacza.

Przykład 2. Zmiana typu wyzwalacza zadania

PS C:\> Get-JobTrigger -Name "Inventory"
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
1          Daily           9/27/2011 11:00:00 PM                          True
2          AtStartup                                                      True

The second command uses the **Get-JobTrigger** cmdlet to get the *AtStartup* job trigger of the Inventory job. The command uses the *TriggerID* parameter to identify the job trigger. A pipeline operator (|) sends the job trigger to the **Set-JobTrigger** cmdlet, which changes it to a weekly job trigger that runs every four weeks on Monday at midnight. The command uses the *Passthru* parameter to return the trigger after the change.
PS C:\> 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

W tym przykładzie pokazano, jak zmienić typ wyzwalacza zadania, który uruchamia zadanie. Polecenia w tym przykładzie zastępują wyzwalacz zadania AtStartup wyzwalaczem tygodniowym.

Pierwsze polecenie używa polecenia cmdlet Get-JobTrigger, aby uzyskać wyzwalacz zadania zaplanowanego zadania spisu. Dane wyjściowe pokazują, że zadanie ma dwa wyzwalacze codziennego wyzwalacza i wyzwalacz AtStartup .

To polecenie nie jest wymagane; jest uwzględniana tylko w celu pokazania efektu zmiany wyzwalacza.

Przykład 3. Zmiana użytkownika w wyzwalaczu zadania zdalnego

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

To polecenie zmienia użytkownika we wszystkich wyzwalaczach zadań zaplanowanych na komputerze Server01.

Polecenie używa polecenia cmdlet Invoke-Command do uruchomienia polecenia na komputerze Server01.

Polecenie zdalne rozpoczyna się od polecenia Get-ScheduledJob, które pobiera wszystkie zaplanowane zadania na komputerze. Zaplanowane zadania są przesyłane potokami do polecenia cmdlet Get-JobTrigger, które pobiera wyzwalacze zadań zaplanowanych. Każdy wyzwalacz zadania zawiera właściwość JobDefinition zawierającą zaplanowane zadanie, więc wyzwalacz pozostaje skojarzony z zaplanowanym zadaniem nawet wtedy, gdy zostanie zmieniony.

Wyzwalacze zadania są przesyłane potokiem do polecenia cmdlet Where-Object, które pobiera wyzwalacze zadań, które mają właściwość User. Wybrane wyzwalacze zadania są przesyłane potokowo do polecenia cmdlet Set-JobTrigger , które zmienia użytkownika na Domain01\Admin02.

Przykład 4. Zmiana jednego z wielu wyzwalaczy zadań

PS C:\> 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

The second command uses the **TriggerID** parameter of the **Get-JobTrigger** cmdlet to get the *Once* trigger of the SecurityCheck scheduled job. The command pipes the trigger to the Format-List cmdlet, which displays all of the properties of the *Once* job trigger.The output shows that the trigger starts the job once every hour (RepetitionInterval = 1 hour) for one day (RepetitionDuration = 1 day).
PS C:\> 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

The third command changes the repetition interval of the job trigger from one hour to 90 minutes. The command does not return any output.
PS C:\> Get-JobTrigger -Name "SecurityCheck" -TriggerId 3 | Set-JobTrigger -RepetitionInterval (New-TimeSpan -Minutes 90)

The fourth command displays the effect of the change.The output shows that the trigger starts the job once every 90 minutes (RepetitionInterval = 1 hour, 30 minutes) for one day (RepetitionDuration = 1 day).
PS C:\> 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

Polecenia w tym przykładzie zmieniają interwał powtórzeń wyzwalacza Po uruchomieniu zadania SecurityCheck zaplanowanego zadania z co 60 minut do co 90 minut. Zaplanowane zadanie SecurityCheck ma trzy wyzwalacze zadań, więc polecenia używają parametru TriggerId polecenia cmdlet Get-JobTrigger w celu zidentyfikowania wyzwalacza zadania, który jest zmieniany.

Pierwsze polecenie używa polecenia cmdlet Get-JobTrigger , aby pobrać wszystkie wyzwalacze zadań zaplanowanego zadania SecurityCheck. Dane wyjściowe, które wyświetlają identyfikatory wyzwalaczy zadania, ujawniają, że wyzwalacz Po zadaniu ma identyfikator 3.

Parametry

-At

Uruchamia zadanie o określonej dacie i godzinie. Wprowadź obiekt DateTime , taki jak obiekt zwracany przez polecenie cmdlet Get-Date lub ciąg, który można przekonwertować na godzinę, taki jak "19 kwietnia 2012 15:00", "12/31/2013 9:00 PM" lub "3am".

Jeśli nie określisz elementu obiektu DateTime , takiego jak sekundy, ten element wyzwalacza zadania nie zostanie zmieniony. Jeśli oryginalny wyzwalacz zadania nie zawierał obiektu DateTime i pominięto element, wyzwalacz zadania zostanie utworzony przy użyciu odpowiedniego elementu z bieżącej daty i godziny.

W przypadku używania parametru Raz ustaw wartość parametru At na określoną datę i godzinę. Ponieważ domyślna data w obiekcie DateTime jest bieżącą datą, ustawienie godziny przed bieżącą godziną bez jawnej daty powoduje wyzwolenie zadania dla godziny w przeszłości.

Obiekty dateTime i ciągi konwertowane na obiekty DateTime są automatycznie dostosowywane tak, aby były zgodne z formatami daty i godziny wybranymi dla komputera lokalnego w regionie i języku w Panel sterowania.

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AtLogOn

Uruchamia zaplanowane zadanie, gdy określeni użytkownicy logują się do komputera. Aby określić użytkownika, użyj parametru Użytkownik .

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AtStartup

Uruchamia zaplanowane zadanie po uruchomieniu systemu Windows.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Daily

Określa cykliczny harmonogram codziennych zadań. Użyj innych parametrów w ustawieniu parametru Daily , aby określić szczegóły harmonogramu.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysInterval

Określa liczbę dni między wystąpieniami zgodnie z harmonogramem dziennym. Na przykład wartość 3 uruchamia zaplanowane zadanie w dniach 1, 4, 7 itd. Wartość domyślna to 1.

Type:	Int32
Position:	Named
Default value:	1
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysOfWeek

Określa dni tygodnia, w których jest uruchamiane cotygodniowe zaplanowane zadanie. Wprowadź nazwy dni, takie jak poniedziałek, czwartek, liczba całkowita 0-6, gdzie 0 reprezentuje niedzielę lub gwiazdkę (*) do reprezentowania każdego dnia. Ten parametr jest wymagany w zestawie parametrów Co tydzień.

Nazwy dni są konwertowane na ich wartości całkowite w wyzwalaczu zadania. Po ujęciu nazw dni w cudzysłowie w poleceniu należy ująć nazwę każdego dnia w oddzielnych cudzysłowach, takich jak "poniedziałek", "wtorek". W przypadku ujęć wiele nazw dni w parze pojedynczego cudzysłowu odpowiednie wartości całkowite są sumowane. Na przykład wartość "Poniedziałek, wtorek" (1, 2) powoduje wyświetlenie wartości "Środa" (3).

Type:	DayOfWeek[]
Accepted values:	Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Określa wyzwalacze zadania. Wprowadź zmienną zawierającą obiekty ScheduledJobTrigger lub wpisz polecenie lub wyrażenie, które pobiera obiekty ScheduledJobTrigger , takie jak polecenie Get-JobTrigger. Możesz również przekazać potok obiektu ScheduledJobTrigger do elementu Set-JobTrigger.

Jeśli określisz wiele wyzwalaczy zadań, funkcja Set-JobTrigger wprowadza te same zmiany we wszystkich wyzwalaczach zadań.

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

-Once

Określa harmonogram niecykliczny (jednorazowy).

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Zwraca wyzwalacze zadania, które uległy zmianie. Domyślnie to polecenie cmdlet nie generuje żadnego wyniku.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RandomDelay

Włącza losowe opóźnienie rozpoczynające się w zaplanowanym czasie rozpoczęcia i ustawia maksymalną wartość opóźnienia. Długość opóźnienia jest ustawiana pseudo-losowo dla każdego początku i różni się od opóźnienia do czasu określonego przez wartość tego parametru. Wartość domyślna, zero (00:00:00), wyłącza losowe opóźnienie.

Wprowadź obiekt przedziału czasu, taki jak jeden zwrócony przez polecenie cmdlet New-TimeSpan, lub wprowadź wartość w <formacie hours>:minutes>:<<seconds>, który jest automatycznie konwertowany na obiekt przedziału czasu.

Type:	TimeSpan
Position:	Named
Default value:	00:00:00
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RepeatIndefinitely

Ten parametr, dostępny od Windows PowerShell 4.0, eliminuje konieczność określenia wartości TimeSpan.MaxValue dla parametru RepetitionDuration do wielokrotnego uruchamiania zaplanowanego zadania przez nieokreślony okres.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RepetitionDuration

Powtarza zadanie do momentu wygaśnięcia określonego czasu. Częstotliwość powtórzeń jest określana przez wartość parametru RepetitionInterval . Jeśli na przykład wartość Parametr PowtarzanieInterval wynosi 5 minut, a wartość parametru RepetitionDuration wynosi 2 godziny, zadanie jest wyzwalane co pięć minut przez dwie godziny.

Wprowadź obiekt przedziału czasu, taki jak ten, który polecenie cmdlet New-TimeSpan zwraca lub ciąg, który można przekonwertować na obiekt przedziału czasu, taki jak "1:05:30".

Aby uruchomić zadanie na czas nieokreślony, zamiast tego dodaj parametr RepeatIndefinitely .

Aby zatrzymać zadanie przed wygaśnięciem czasu trwania powtórzenia zadania, ustaw wartość PowtarzanieDuration na zero (0).

Aby zmienić czas trwania powtórzenia lub interwał powtórzeń wyzwalacza Raz zadanie, polecenie musi zawierać parametry PowtarzanieInterval i PowtarzanieDuration . Aby zmienić czas trwania powtórzenia lub interwały powtórzeń innych typów wyzwalaczy zadania, polecenie musi zawierać parametry Raz, At, PowtarzanieInterval i PowtarzanieDuration .

Type:	TimeSpan
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RepetitionInterval

Powtarza zadanie w określonym przedziale czasu. Jeśli na przykład wartość tego parametru wynosi 2 godziny, zadanie jest wyzwalane co dwie godziny. Wartość domyślna 0 nie powtarza zadania.

Wprowadź obiekt przedziału czasu, taki jak ten, który polecenie cmdlet New-TimeSpan zwraca lub ciąg, który można przekonwertować na obiekt przedziału czasu, taki jak "1:05:30".

Aby zmienić czas trwania powtórzenia lub interwał powtórzeń wyzwalacza Raz zadanie, polecenie musi zawierać parametry PowtarzanieInterval i PowtarzanieDuration . Aby zmienić czas trwania powtórzenia lub interwały powtórzeń innych typów wyzwalaczy zadania, polecenie musi zawierać parametry Raz, At, PowtarzanieInterval i PowtarzanieDuration .

Type:	TimeSpan
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-User

Określa użytkowników, którzy wyzwalają początek zaplanowanego zadania AtLogon . Wprowadź nazwę użytkownika w <formacie UserName> lub <Domain\Username> lub wprowadź gwiazdkę (*) reprezentującą wszystkich użytkowników. Wartość domyślna to wszyscy użytkownicy.

Type:	String
Position:	Named
Default value:	All users
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Weekly

Określa cykliczny harmonogram zadań cotygodniowych. Użyj innych parametrów w zestawie parametrów Weekly , aby określić szczegóły harmonogramu.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WeeksInterval

Określa liczbę tygodni między wystąpieniami w harmonogramie zadań cotygodniowych. Na przykład wartość 3 uruchamia zaplanowane zadanie w dniach 1, 4, 7 itd. Wartość domyślna to 1.

Type:	Int32
Position:	Named
Default value:	1
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Możesz przekazać potok wielu wyzwalaczy zadań do polecenia Set-JobTrigger.

Dane wyjściowe

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Gdy używasz parametru Passthru , funkcja Set-JobTrigger zwraca zmienione wyzwalacze zadania. W przeciwnym razie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

Uwagi

Wyzwalacze zadań mają właściwość JobDefintion, która kojarzy je z zaplanowanym zadaniem. Po zmianie wyzwalacza zadania zaplanowanego zadanie zostanie zmienione. Nie musisz używać polecenia Set-ScheduledJob, aby zastosować zmieniony wyzwalacz do zaplanowanego zadania.