Set-JobTrigger

  • Referencia
Modul:
PSScheduledJob

Módosítja egy ütemezett feladat feladatindítóját.

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

Description

A Set-JobTrigger parancsmag módosítja az ütemezett feladatok feladatindítóinak tulajdonságait. Ezzel módosíthatja a feladatok indításának időpontját vagy gyakoriságát, illetve az időalapú ütemezésről a bejelentkezés vagy indítás által aktivált ütemezésekre.

A feladat-eseményindítók ismétlődő ütemezést vagy feltételeket határoznak meg az ütemezett feladatok indításához. Bár a feladat-eseményindítók nincsenek lemezre mentve, módosíthatja az ütemezett feladatok feladatindítóit, amelyeket a rendszer lemezre ment.

Egy ütemezett feladat feladat-eseményindítójának módosításához először használja a Get-JobTrigger parancsmagot egy ütemezett feladat feladatindítójának lekéréséhez. Ezután futtasd az eseményindítót egy változóba Set-JobTrigger , vagy mentse az eseményindítót, és használja a parancsmag InputObject paraméterét Set-JobTrigger az eseményindító azonosításához. A feladat-eseményindító módosításához használja a többi paramétert Set-JobTrigger .

Amikor módosítja egy feladat-eseményindító típusát, például egy feladat-eseményindítót napi vagy heti eseményindítóról AtLogon-eseményindítóra módosít, a rendszer törli az eredeti eseményindító tulajdonságait. Ha azonban módosítja az eseményindító értékeit, de nem annak típusát, például a heti eseményindító napjainak módosítását, akkor csak a megadott tulajdonságok módosulnak. Az eredeti feladat-eseményindító minden más tulajdonsága megmarad.

Set-JobTrigger a Windows PowerShellben található PSScheduledJob modul feladatütemezési parancsmagjainak egyik gyűjteménye.

Az ütemezett feladatokról további információt a PSScheduledJob modul Témakörök című témakörében talál. Importálja a PSScheduledJob modult, majd írja be a következőt: Get-Help about_Scheduled* vagy tekintse meg a about_Scheduled_Jobs.

Ezt a parancsmagot a Windows PowerShell 3.0-ban vezettük be.

Példák

1. példa: A feladatok eseményindítójának napjainak módosítása

Ez a példa bemutatja, hogyan módosíthatja a heti feladat-eseményindító napjait.

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

Az első parancs a Get-JobTrigger parancsmaggal lekéri az ütemezett feladat feladatindítóját DeployPackage . A kimenet azt mutatja, hogy az eseményindító szerdán és szombaton éjfélkor indítja el a feladatot.

A második parancs a Get-JobTrigger parancsmaggal lekéri az ütemezett feladat feladatindítóját DeployPackage . A folyamatkezelő (|) elküldi az eseményindítót a Set-JobTrigger parancsmagnak, amely módosítja a feladat-eseményindítót, hogy szerdán és vasárnap indítsa el a DeployPackage feladatot. A parancs a Passthru paraméter használatával adja vissza az eseményindítót a módosítás után.

Ez a parancs nem kötelező; csak az eseményindító módosításának hatását jeleníti meg.

2. példa: A feladat-eseményindító típusának módosítása

Ez a példa bemutatja, hogyan módosíthatja a feladatindító típusú feladatindítót. A példában szereplő parancsok egy feladat-eseményindítót AtStartup heti eseményindítóra cserélnek.

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

Az első parancs a Get-JobTrigger parancsmaggal lekéri az ütemezett feladat feladatindítóját Inventory . A kimenet azt mutatja, hogy a feladat két eseményindítóval rendelkezik egy napi eseményindítóval és egy AtStartup-eseményindítóval .

A második parancs a Get-JobTrigger parancsmaggal lekéri a feladat AtStartup feladatindítóját Inventory . A parancs a TriggerID paraméter használatával azonosítja a feladat-eseményindítót. A folyamatüzemeltető (|) elküldi a feladat-eseményindítót a Set-JobTrigger parancsmagnak, amely egy heti feladat-eseményindítóra módosítja, amely hétfőn éjfélkor négyhetente fut. A parancs a Passthru paraméter használatával adja vissza az eseményindítót a módosítás után.

Ez a parancs nem kötelező; csak az eseményindító módosításának hatását jeleníti meg.

3. példa: A felhasználó módosítása távoli feladat-eseményindítón

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

Ez a parancs módosítja a felhasználót a Kiszolgáló01 számítógépen ütemezett feladatok összes AtLogon-feladat eseményindítójában.

A parancs a Invoke-Command parancsmaggal futtat egy parancsot a Server01 számítógépen.

A távoli parancs egy Get-ScheduledJob olyan paranccsal kezdődik, amely lekéri az összes ütemezett feladatot a számítógépen. Az ütemezett feladatok a Get-JobTrigger parancsmagba vannak állítva, amely lekéri az ütemezett feladatok feladatindítóit. Minden feladat-eseményindító tartalmaz egy JobDefinition tulajdonságot, amely tartalmazza az ütemezett feladatot, így az eseményindító akkor is társítva marad az ütemezett feladathoz, ha módosul.

A feladat-eseményindítók a Where-Object parancsmagra vannak állítva, amely a User tulajdonsággal rendelkező feladat-eseményindítókat kapja meg. A kijelölt feladat-eseményindítók a Set-JobTrigger parancsmagra vannak állítva, amely a felhasználót a következőre Domain01\Admin02módosítja: .

4. példa: Több feladat-eseményindító egyikének módosítása

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

A példában szereplő parancsok az ütemezett feladat Egyszeri feladat eseményindítójának ismétlési SecurityCheck időközét 60 percenként 90 percenként módosítják. Az SecurityCheck ütemezett feladat három feladat-eseményindítóval rendelkezik, ezért a parancsok a Get-JobTrigger parancsmag TriggerId paraméterével azonosítják a módosítandó feladat-eseményindítót.

Az első parancs a Get-JobTrigger parancsmaggal lekéri az SecurityCheck ütemezett feladat összes feladatindítóját. A feladat-eseményindítók azonosítóit megjelenítő kimenetből kiderül, hogy a Once feladat-eseményindító azonosítója3.

A második parancs a parancsmag TriggerID paraméterét használja az Get-JobTrigger ütemezett feladat Egyszeri eseményindítójának SecurityCheck lekéréséhez. A parancs a parancsmagra irányítja az Format-List eseményindítót, amely megjeleníti a Once job trigger összes tulajdonságát. A kimenet azt mutatja, hogy az eseményindító óránként egyszer indítja el a feladatot (a RepetitionInterval 1 óra) egy napon keresztül (az ismétlési idő 1 nap).

A harmadik parancs egy óráról 90 percre módosítja a feladat-eseményindító ismétlési időközét. A parancs nem ad vissza kimenetet.

A negyedik parancs megjeleníti a módosítás hatását. A kimenet azt mutatja, hogy az eseményindító 90 percenként egyszer indítja el a feladatot (a RepetitionInterval 1 óra 30 perc) egy napon keresztül (az ismétlési idő 1 nap).

Paraméterek

-At

A feladatot a megadott dátumon és időpontban indítja el. Adjon meg egy DateTime-objektumot , például azt, amelyet a Get-Date parancsmag visszaad, vagy egy olyan sztringet, amely idővé alakítható, például April 19, 2012 15:00, 12/31/2013 9:00 PMvagy 3am.

Ha nem adja meg a DateTime objektum egyik elemét (például a másodpercet), a feladat-eseményindító ezen eleme nem módosul. Ha az eredeti feladat-eseményindító nem tartalmaz DateTime objektumot, és kihagy egy elemet, a feladat-eseményindító az aktuális dátum és idő megfelelő elemével jön létre.

Az Egyszer paraméter használatakor állítsa az At paraméter értékét egy adott dátumra és időpontra. Mivel egy DateTime objektumban az alapértelmezett dátum az aktuális dátum, az aktuális időpont előtti időpont explicit dátum nélkül történő beállítása egy korábbi időponthoz tartozó feladat-eseményindítót eredményez.

A DateTime-objektumok és a DateTime-objektumokká konvertált sztringek automatikusan úgy vannak módosítva, hogy kompatibilisek legyenek a helyi számítógép által a régióban és a nyelvben kiválasztott dátum- és időformátumokkal a Vezérlőpult.

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

-AtLogOn

Elindítja az ütemezett feladatot, amikor a megadott felhasználók bejelentkeznek a számítógépre. Felhasználó megadásához használja a User paramétert.

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

-AtStartup

A Windows indításakor elindítja az ütemezett feladatot.

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

-Daily

Ismétlődő napi feladatütemezést ad meg. Az ütemezés részleteinek megadásához használja a Napi paraméterkészlet többi paraméterét.

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

-DaysInterval

A napi ütemezésben előforduló előfordulások közötti napok számát adja meg. Például egy érték 3 az ütemezett feladatot napokon 1indítja el, 47 és így tovább. Az alapértelmezett érték 1.

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

-DaysOfWeek

A hét azon napjait adja meg, amelyeken egy heti ütemezett feladat fut. Adja meg a napneveket, például Monday: , Thursdayegész számokat06-, ahol 0 a vasárnapot jelöli, vagy egy csillagot (*) a minden nap ábrázolásához. Ez a paraméter a Heti paraméterkészletben szükséges.

A napnevek a feladat-eseményindító egész számértékévé alakulnak. Ha idézőjelek közé teszi a napneveket egy parancsban, minden napnevet külön idézőjelek közé kell foglalnia, például "Monday", "Tuesday". Ha több napi nevet egyetlen idézőjelpárba foglal, a megfelelő egész számértékeket összegzi a rendszer. Például ("Monday, Tuesday"1 + 2) a () értéke Wednesday (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

Megadja a feladat-eseményindítókat. Adjon meg egy változót, amely ScheduledJobTrigger objektumokat tartalmaz, vagy írjon be egy parancsot vagy kifejezést, amely ScheduledJobTrigger-objektumokat, például parancsokat Get-JobTrigger kap. ScheduledJobTrigger objektumot is becsúszthat a programbaSet-JobTrigger.

Ha több feladat-eseményindítót ad meg, Set-JobTrigger ugyanazokat a módosításokat hajtja végre az összes feladat-eseményindítón.

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

-Once

Nem ismétlődő (egyszeri) ütemezést ad meg.

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

-PassThru

A megváltozott feladat-eseményindítókat adja vissza. Ez a parancsmag alapértelmezés szerint nem hoz létre kimenetet.

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

-RandomDelay

Lehetővé teszi az ütemezett kezdési időponttól kezdődő véletlenszerű késleltetést, és beállítja a maximális késleltetési értéket. A késleltetés hossza pszeudo-véletlenszerűen van beállítva minden indításhoz, és a paraméter értéke által megadott időtől függetlenül változik. Az alapértelmezett nulla (00:00:00) érték letiltja a véletlenszerű késleltetést.

Adjon meg egy időbélyeg-objektumot, például a New-TimeSpan parancsmag által visszaadott objektumot, vagy adjon meg egy formátumbeli <hours>:<minutes>:<seconds> értéket, amelyet a rendszer automatikusan időbélyeg-objektummá alakít át.

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

-RepeatIndefinitely

Ez a Windows PowerShell 4.0-tól elérhető paraméter szükségtelenné teszi a TimeSpan.MaxValue érték megadását az IsmétlődésDuration paraméterhez egy ütemezett feladat ismételt futtatásához határozatlan ideig.

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

-RepetitionDuration

Megismétli a feladatot, amíg a megadott idő el nem jár. Az ismétlés gyakoriságát az RepetitionInterval paraméter értéke határozza meg. Ha például az RepetitionInterval értéke 5 perc, és az IsmétlésDuration értéke 2 óra, a feladat két órán keresztül öt percenként aktiválódik.

Adjon meg egy időbélyeg-objektumot, például azt, amelyet a New-TimeSpan parancsmag visszaad, vagy egy olyan sztringet, amely időbélyeg-objektummá alakítható, például 1:05:30.

Egy feladat határozatlan ideig történő futtatásához adja hozzá az RepeatIndefinitely paramétert.

Ha le szeretne állítani egy feladatot, mielőtt a feladat eseményindítójának ismétlési időtartama lejár, állítsa az IsmétlésDuration értéket nullára (0).

Az Egyszeri feladat eseményindítójának ismétlési időtartamának vagy ismétlési időközének módosításához a parancsnak tartalmaznia kell az Ismétlésintervallás és az IsmétlésDuration paramétert is. Más típusú feladat-eseményindítók ismétlési időtartamának vagy ismétlési időközeinek módosításához a parancsnak tartalmaznia kell a Once, At, RepetitionInterval és RepetitionDuration paramétereket.

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

-RepetitionInterval

Megismétli a feladatot a megadott időintervallumban. Ha például ennek a paraméternek az értéke 2 óra, a feladat két óránként aktiválódik. Az alapértelmezett érték 0nem ismétli meg a feladatot.

Adjon meg egy időbélyeg-objektumot, például azt, amelyet a New-TimeSpan parancsmag visszaad, vagy egy olyan sztringet, amely időbélyeg-objektummá alakítható, például 1:05:30.

Az Egyszeri feladat eseményindítójának ismétlési időtartamának vagy ismétlési időközének módosításához a parancsnak tartalmaznia kell az Ismétlésintervallás és az IsmétlésDuration paramétert is. Más típusú feladat-eseményindítók ismétlési időtartamának vagy ismétlési időközeinek módosításához a parancsnak tartalmaznia kell a Once, At, RepetitionInterval és RepetitionDuration paramétereket.

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

-User

Megadja azokat a felhasználókat, akik egy ütemezett feladat AtLogon-kezdetét aktiválják. Adja meg egy felhasználó <UserName> nevét vagy <Domain>\<Username> formátumát, vagy írjon be egy csillagot (*) az összes felhasználó megjelenítéséhez. Az alapértelmezett érték az összes felhasználó.

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

-Weekly

Ismétlődő heti feladatütemezést ad meg. Az ütemezés részleteinek megadásához használja a Heti paraméterkészlet többi paraméterét.

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

-WeeksInterval

A heti feladatütemezés előfordulásai közötti hetek számát adja meg. Például az ütemezett feladat heteken 147 keresztüli indításának értéke3, és így tovább. Az alapértelmezett érték 1.

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

Bevitelek

ScheduledJobTrigger

Ehhez a parancsmaghoz futtathat feladat-eseményindítót.

Kimenetek

None

Ez a parancsmag alapértelmezés szerint nem ad vissza kimenetet.

ScheduledJobTrigger

A PassThru paraméter használatakor ez a parancsmag a módosított feladat-eseményindítókat adja vissza.

Jegyzetek

  • A feladat-eseményindítók egy JobDefinition tulajdonsággal rendelkeznek, amely az ütemezett feladathoz társítja őket. Ha módosítja egy ütemezett feladat feladatindítóját, a feladat megváltozik. A módosított eseményindító ütemezett feladatra való alkalmazásához nem kell parancsot használnia Set-ScheduledJob .