Set-JobTrigger

Módosítja egy ütemezett feladat feladat-eseményindí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 feladat-eseményindítóinak tulajdonságait. A segítségével 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 válthat.

A feladat-eseményindítók ismétlődő ütemezést vagy feltételeket határoznak meg egy ütemezett feladat indításához. Bár a rendszer nem menti a feladat-eseményindítókat a lemezre, módosíthatja az ütemezett feladatok feladat-eseményindí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 feladat-eseményindítójának lekéréséhez. Ezután futtassa az eseményindítót egy változóba Set-JobTrigger , vagy mentse egy változóban, é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ágokat. Ha azonban módosítja az eseményindító értékeit, de a típusát nem, például egy heti eseményindító napjainak módosítását, csak a megadott tulajdonságok módosulnak. Az eredeti feladat-eseményindító minden más tulajdonsága megmarad.

Set-JobTriggerA a PSScheduledJob modul feladatütemezési parancsmagjainak egyike, amely a Windows PowerShell része.

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

Ez a parancsmag a Windows PowerShell 3.0-s verzióban jelent meg.

Példák

1. példa: A napok módosítása egy feladat-eseményindítóban

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

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 parancsmag használatával lekéri az DeployPackage ütemezett feladat feladat-eseményindítóját. 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 DeployPackage ütemezett feladat feladat-eseményindítóját. A folyamatüzemeltető (|) elküldi az eseményindítót a Set-JobTrigger parancsmagnak, amely úgy 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ő; A 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 feladatot elindító feladat-eseményindító típusát. Az ebben 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 parancsmag használatával lekéri az Inventory ütemezett feladat feladat-eseményindítóját. A kimenet azt mutatja, hogy a feladat két eseményindítóval rendelkezik, egy napi és egy AtStartup eseményindítóval.

A második parancs a Get-JobTrigger parancsmag használatával lekéri a feladat AtStartup feladat-eseményindí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 heti feladat-eseményindítóra módosítja, amely hétfőn éjfélkor négy hetente 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ő; A csak az eseményindító módosításának hatását jeleníti meg.

3. példa: Felhasználó módosítása távoli feladat eseményindítójá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 Server01 számítógépen ütemezett feladatok összes AtLogon-feladat eseményindítójában.

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

A távoli parancs egy Get-ScheduledJob olyan paranccsal kezdődik, amely lekéri a számítógépen lévő összes ütemezett feladatot. Az ütemezett feladatok a Get-JobTrigger parancsmagba lesznek átirányítva, amely lekéri az ütemezett feladatok feladat-eseményindí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 feladattal, ha módosul.

A feladat-eseményindítók a Where-Object parancsmagba kerülnek, amely lekéri a User tulajdonsággal rendelkező feladat-eseményindítókat. A kijelölt feladat-eseményindítók a Set-JobTrigger parancsmagba kerülnek, amely a felhasználót a következőre Domain01\Admin02módosítja: .

4. példa: A számos 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 SecurityCheck ismétlődési 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 parancsmag használatával lekéri az SecurityCheck ütemezett feladat összes feladat-eseményindítóját. A kimenet, amely megjeleníti a feladat-eseményindítók azonosítóit, azt mutatja, hogy az Egyszer feladat eseményindító azonosítója3.

A második parancs a parancsmag TriggerID paraméterét használja az Get-JobTrigger ütemezett feladat Once eseményindítójának lekéréséhez SecurityCheck . A parancs a parancsmagba irányítja az Format-List eseményindítót, amely megjeleníti a Once feladat eseményindítójának összes tulajdonságát. A kimenet azt mutatja, hogy az eseményindító óránként egyszer indítja el a feladatot (a RepetitionInterval értéke 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ődé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 értéke 1 óra, 30 perc) egy napig (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 a Get-Date parancsmag által visszaadott objektumot, 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ásodperceket), 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 Once paraméter használatakor állítsa az At paraméter értékét egy adott dátumra és időpontra. Mivel a DateTime objektum alapértelmezett dátuma az aktuális dátum, az aktuális időpont előtti időpont explicit dátum nélküli beállítása egy feladat-eseményindítót eredményez egy múltbeli időpontra vonatkozóan.

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éphez kiválasztott dátum- és időformátumokkal Vezérlőpult régióban és nyelven.

Type:DateTime
Position:Named
Default value:None
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
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
Accept pipeline input:False
Accept wildcard characters:False

-Daily

Ismétlődő napi feladatütemezést ad meg. A Napi paraméterkészlet többi paraméterével adja meg az ütemezés részleteit.

Type:SwitchParameter
Position:Named
Default value:None
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 14indítja el, 7 és így tovább. Az alapértelmezett érték 1.

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

-DaysOfWeek

A hét azon napjait adja meg, amelyeken a heti ütemezett feladatok futnak. Adjon meg napneveket, például Monday, Thursdayegész számokat6-0, ahol 0 a vasárnapot jelöli, vagy egy csillagot (*) a nap minden napjának ábrázolásához. Erre a paraméterre a Heti paraméterkészletben van szükség.

A napneveket a rendszer egész számértékké alakítja a feladat-eseményindítóban. Amikor a napneveket idézőjelek közé foglalja egy parancsban, minden napnevet külön idézőjelek közé kell tenni, például "Monday", "Tuesday". Ha több nap nevét egyetlen idézőjelpárba foglalja, a rendszer összegzi a megfelelő egész számértékeket. Például ("Monday, Tuesday"1 + 2) a (3) értéket adja eredményként Wednesday .

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

-InputObject

Meghatározza a feladat eseményindítóit. Írjon be egy ScheduledJobTrigger objektumokat tartalmazó változót, vagy írjon be egy parancsot vagy kifejezést, amely ScheduledJobTrigger objektumokat, például parancsokat Get-JobTrigger kap. ScheduledJobTrigger objektumot is átirányíthat a következőreSet-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:Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger[]
Position:0
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

A módosított feladat-eseményindítókat adja vissza. Alapértelmezés szerint ez a parancsmag nem ad kimenetet.

Type:SwitchParameter
Position:Named
Default value:None
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 minden indításhoz pszeudo-véletlenszerűen van beállítva, é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 írjon be 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
Accept pipeline input:False
Accept wildcard characters:False

-RepeatIndefinitely

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

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

-RepetitionDuration

Megismétli a feladatot, amíg a megadott idő le nem jár. Az ismétlődési gyakoriságot a RepetitionInterval paraméter értéke határozza meg. Ha például a RepetitionInterval értéke 5 perc, az IsmétlődésDuration értéke pedig 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 egy olyan objektumot, amelyet a New-TimeSpan parancsmag visszaad, vagy egy olyan sztringet, amely időbélyeg-objektummá alakítható, például 1:05:30.

Ha határozatlan ideig szeretne futtatni egy feladatot, adja hozzá helyette az RepeatIndefinitely paramétert .

Ha le szeretne állítani egy feladatot, mielőtt a feladat-eseményindító ismétlődé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ődési időközének módosításához a parancsnak tartalmaznia kell az Ismétlésintervallum és az IsmétlésDuration paramétereket is. Más típusú feladat-eseményindítók ismétlési időtartamának vagy ismétlődé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
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 nem 0ismétli meg a feladatot.

Adjon meg egy időbélyeg-objektumot, például egy olyan objektumot, 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ődési időközének módosításához a parancsnak tartalmaznia kell az Ismétlésintervallum és az IsmétlésDuration paramétereket is. Más típusú feladat-eseményindítók ismétlési időtartamának vagy ismétlődé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
Accept pipeline input:False
Accept wildcard characters:False

-User

Meghatározza azokat a felhasználókat, akik atLogon-indítást aktiválnak egy ütemezett feladathoz. Adja meg egy felhasználó <UserName> nevét vagy formátumát, <Domain>\<Username> 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
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
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 3 ütemezett feladat heteken 1át indul el 4, 7 és így tovább. Az alapértelmezett érték 1.

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

Bevitelek

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

Több feladat-eseményindítót is átirányíthat a parancsba Set-JobTrigger.

Kimenetek

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

A Passthru paraméter Set-JobTrigger használatakor a módosított feladat-eseményindítókat adja vissza. Ellenkező esetben ez a parancsmag nem hoz létre kimenetet.

Jegyzetek

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