Set-ScheduledJobOption

  • Referencia
Modul:
PSScheduledJob

Az ütemezett feladatok feladatbeállításainak módosítása.

Syntax

Set-ScheduledJobOption
   [-InputObject] <ScheduledJobOptions>
   [-PassThru]
   [-RunElevated]
   [-HideInTaskScheduler]
   [-RestartOnIdleResume]
   [-MultipleInstancePolicy <TaskMultipleInstancePolicy>]
   [-DoNotAllowDemandStart]
   [-RequireNetwork]
   [-StopIfGoingOffIdle]
   [-WakeToRun]
   [-ContinueIfGoingOnBattery]
   [-StartIfOnBattery]
   [-IdleTimeout <TimeSpan>]
   [-IdleDuration <TimeSpan>]
   [-StartIfIdle]
   [<CommonParameters>]

Description

A Set-ScheduledJobOptions parancsmag módosítja az ütemezett feladatok feladatbeállításait.

Az ütemezett feladatok beállításainak módosításához először használja a Get-ScheduledJobOption parancsmagot egy ütemezett feladat feladatbeállításainak lekéréséhez. Ezután futtasd a beállításokat Set-ScheduledJobOption egy változóba, vagy mentsd a beállításokat, és a parancsmag InputObject paraméterével Set-ScheduledJobOption azonosítsa a beállításokat. A feladatbeállítások módosításához használja a többi paramétert Set-ScheduledJobOption .

A feladatbeállítás bekapcsolásához használja az adott beállítást beállító paramétert. Egy beállítás kikapcsolásához írja be a paraméter nevét, a kettőspontot (:) és a $false. A RunElevated beállítás kikapcsolásához például írja be a következőt-RunElevated:$false:

Minden feladatbeállítás-objektum tartalmaz egy JobDefinition tulajdonságot, amely tartalmazza az ütemezett feladatot, így az ütemezett feladattal való társítás megmarad a feladatbeállítások módosításakor.

Az ütemezett feladat beállításai határozzák meg, hogyan fut a feladat, amikor a Feladatütemező elindítja. Ezek a beállítások nem alkalmazhatók, amikor a Start-Job parancsmaggal indít el egy ütemezett feladatot.

Set-ScheduledJobOption 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: Feladatbeállítások módosítása

Get-ScheduledJobOption -Name "DeployPackage"

StartIfOnBatteries     : False
StopIfGoingOnBatteries : True
WakeToRun              : False
StartIfNotIdle         : True
StopIfGoingOffIdle     : False
RestartOnIdleResume    : False
IdleDuration           : 00:10:00
IdleTimeout            : 01:00:00
ShowInTaskScheduler    : True
RunElevated            : False
RunWithoutNetwork      : False
DoNotAllowDemandStart  : False
MultipleInstancePolicy : IgnoreNew
JobDefinition          :

Get-ScheduledJobOption -Name "DeployPackage" |
    Set-ScheduledJobOption -WakeToRun -RequireNetwork:$false -Passthru

StartIfOnBatteries     : False
StopIfGoingOnBatteries : True
WakeToRun              : True
StartIfNotIdle         : True
StopIfGoingOffIdle     : False
RestartOnIdleResume    : False
IdleDuration           : 00:10:00
IdleTimeout            : 01:00:00
ShowInTaskScheduler    : True
RunElevated            : False
RunWithoutNetwork      : True
DoNotAllowDemandStart  : False
MultipleInstancePolicy : IgnoreNewJobDefinition          :

Ez a példa bemutatja, hogyan módosíthatja egy ütemezett feladat beállításait a helyi számítógépen.

Az első parancs a Get-ScheduledJobOption parancsmagot használja a DeployPackage ütemezett feladat feladatbeállításainak lekéréséhez. A kimenet azt mutatja, hogy a WakeToRun és a RunElevated tulajdonság értéke .$false

A második parancs a Set-ScheduledJobOpton parancsmaggal módosítja a feladatbeállításokat, így a WakeToRun és a RunWithoutNetwork tulajdonságok értékei $True. 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 a beállításváltozás hatásának megjelenítése.

2. példa: Az összes távoli ütemezett feladat beállításának módosítása

Invoke-Command -Computer "Server01" -ScriptBlock {
    Get-ScheduledJob |
        Get-ScheduledJobOption |
        Set-ScheduledJobOption -IdleTimeout 2:00:00
}

Ez a parancs az IdleTimeout értékét egy óráról (az alapértelmezett érték) két órára módosítja a Server01 számítógépen lévő összes ütemezett feladaton.

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-ScheduledJobOption parancsmagra vannak állítva, amely megkapja az ütemezett feladatok feladatbeállításait. Minden feladatbeállítás-objektum tartalmaz egy JobDefinition tulajdonságot, amely tartalmazza az ütemezett feladatot, így a beállításobjektum akkor is hozzá lesz rendelve az ütemezett feladathoz, ha az módosul.

A feladat-eseményindítók a Set-ScheduledJobOption parancsmagra vannak állítva, amely az IdleTimeout beállítás értékét két órára (2:00:00) módosítja.

Paraméterek

-ContinueIfGoingOnBattery

Ne állítsa le az ütemezett feladatot, ha a számítógép akkumulátoros üzemre vált (leválasztja az AC-teljesítményről) a feladat futtatása közben. Alapértelmezés szerint az ütemezett feladatok leállnak, amikor a számítógép leválasztja az AC tápellátását.

A ContinueIfGoingOnBattery paraméter az ütemezett feladatok StopIfGoingOnBatteries tulajdonságának értékét a következőre $trueállítja: .

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

-DoNotAllowDemandStart

A feladatot csak akkor indítsa el, ha aktiválódik. A felhasználók nem tudják manuálisan elindítani a feladatot, például a Feladatütemező Futtatás funkciójával.

Ez a paraméter csak a Feladatütemezőt érinti. Ez nem akadályozza meg a felhasználókat abban, hogy a Start-Job parancsmagot használják a feladat elindításához.

A DoNotAllowDemandStart paraméter az ütemezett feladatok DoNotAllowDemandStart tulajdonságának értékét a következőre $trueállítja: .

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

-HideInTaskScheduler

Ne jelenjen meg a feladat a Feladatütemezőben. Ez az érték csak azt a számítógépet érinti, amelyen a feladat fut. Alapértelmezés szerint az ütemezett tevékenységek megjelennek a Feladatütemezőben.

Még ha egy tevékenység rejtett is, a felhasználók a Feladatütemező rejtett tevékenységek megjelenítése nézetének kiválasztásával is megjeleníthetik a feladatot.

A HideInTaskScheduler paraméter az ütemezett feladatok ShowInTaskScheduler tulajdonságának értékét a következőre $falseállítja: .

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

-IdleDuration

Megadja, hogy a számítógépnek mennyi ideig kell tétlennek lennie a feladat megkezdése előtt. Az alapértelmezett érték 10 perc. Ha a számítógép az IdleTimeout értékének lejárta előtt nem tétlen a megadott ideig, az ütemezett feladat nem fut a következő ütemezett időpontig, ha van ilyen.

Adjon meg egy időbélyeg-objektumot, például a parancsmag által New-TimeSpan létrehozott objektumot, vagy adjon meg egy olyan értéket<hours>:<minutes>:<seconds>, amely automatikusan TimeSpan-objektummá lesz konvertálva.

Az érték engedélyezéséhez használja a StartIfIdle paramétert. Alapértelmezés szerint az ütemezett feladatok StartIfNotIdle tulajdonsága be van állítva$true, és a Windows PowerShell figyelmen kívül hagyja az IdleDuration és az IdleTimeout értékeket.

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

-IdleTimeout

Megadja, hogy a számítógépnek mennyi ideig kell tétlennek lennie a feladat megkezdése előtt. Az alapértelmezett érték 10 perc. Ha a számítógép az IdleTimeout értékének lejárta előtt nem tétlen a megadott ideig, az ütemezett feladat nem fut a következő ütemezett időpontig, ha van ilyen.

Adjon meg egy időbélyeg-objektumot, például a parancsmag által New-TimeSpan létrehozott objektumot, vagy adjon meg egy olyan értéket<hours>:<minutes>:<seconds>, amely automatikusan TimeSpan-objektummá lesz konvertálva.

Az érték engedélyezéséhez használja a StartIfIdle paramétert. Alapértelmezés szerint az ütemezett feladatok StartIfNotIdle tulajdonsága $True, a Windows PowerShell pedig figyelmen kívül hagyja az IdleDuration és az IdleTimeout értékeket.

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

-InputObject

Megadja a feladatbeállításokat. Adjon meg egy változót, amely ScheduledJobOptions objektumokat tartalmaz, vagy írjon be egy parancsot vagy kifejezést, amely lekéri az ScheduledJobOptions objektumokat, például egy parancsotGet-ScheduledJobOption. ScheduledJobOptions objektumot is becsúszthat a programbaSet-ScheduledJobOption.

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobOptions
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MultipleInstancePolicy

Meghatározza, hogy a rendszer hogyan válaszol egy ütemezett feladat egy példányának elindítására irányuló kérésre, miközben a feladat egy másik példánya fut. A paraméter elfogadható értékei a következők:

  • IgnoreNew – A rendszer figyelmen kívül hagyja az új feladatpéldányt. Ez az alapértelmezett érték.
  • Parallel – Az új feladatpéldány azonnal elindul.
  • Queue – Az új feladatpéldány az aktuális példány befejeződése után azonnal elindul.
  • StopExisting – A feladat aktuális példánya leáll, és az új példány elindul.

A feladat futtatásához a feladatütemezés minden feltételének teljesülnie kell. Ha például a RequireNetwork, az IdleDuration és az IdleTimeout paraméterek által megadott feltételek nem teljesülnek, a feladatpéldány nem indul el a paraméter értékétől függetlenül.

Type:Microsoft.PowerShell.ScheduledJob.TaskMultipleInstancePolicy
Accepted values:None, IgnoreNew, Parallel, Queue, StopExisting
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Azt az elemet képviselő objektumot adja vissza, amellyel dolgozik. 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

-RequireNetwork

Az ütemezett feladatot csak akkor futtatja, ha hálózati kapcsolatok állnak rendelkezésre.

Ha ezt a paramétert adja meg, és a hálózat nem érhető el az ütemezett kezdési időpontban, a feladat csak a következő ütemezett kezdési időpontig fut, ha van ilyen.

A RequireNetwork paraméter az ütemezett feladatok RunWithoutNetwork tulajdonságának értékét a következőre $falseállítja: .

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

-RestartOnIdleResume

Újraindít egy ütemezett feladatot, amikor a számítógép tétlenné válik. Ez a paraméter a StopIfGoingOffIdle paraméterrel működik, amely felfüggeszt egy futó ütemezett feladatot, ha a számítógép aktívvá válik (elhagyja az inaktív állapotot).

A RestartOnIdleResume paraméter az ütemezett feladatok RestartOnIdleResume tulajdonságának értékét a következőre $trueállítja be: .

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

-RunElevated

Az ütemezett feladatot az Rendszergazda istrators csoport tagjának engedélyeivel futtatja azon a számítógépen, amelyen a feladat fut.

Ha engedélyezni szeretné, hogy egy ütemezett feladat Rendszergazda istrator engedélyekkel fusson, használja a hitelesítő paramétert Register-ScheduledJob a feladat explicit hitelesítő adatainak megadásához.

A RunElevated paraméter az ütemezett feladatok RunElevated tulajdonságának értékét a következőre $trueállítja: .

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

-StartIfIdle

Elindítja az ütemezett feladatot, ha a számítógép tétlen volt az IdleDuration paraméter által megadott ideig, mielőtt az IdleTimeout paraméter által megadott idő lejár.

Alapértelmezés szerint az IdleDuration és az IdleTimeout paraméterek figyelmen kívül lesznek hagyva, és a feladat az ütemezett kezdési időpontban indul el akkor is, ha a számítógép foglalt.

Ha ezt a paramétert adja meg, és a számítógép foglalt (nem tétlen) az ütemezett kezdési időpontban, a feladat csak a következő ütemezett kezdési időpontig fut, ha van ilyen.

A StartIfIdle paraméter az ütemezett feladatok StartIfNotIdle tulajdonságának értékét a következőre $falseállítja: .

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

-StartIfOnBattery

Akkor is elindítja az ütemezett feladatot, ha a számítógép akkumulátorokon fut az ütemezett kezdési időpontban. Az alapértelmezett érték $false.

A StartIfOnBattery paraméter az ütemezett feladatok StartIfOnBatteries tulajdonságának értékét a következőre $trueállítja: .

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

-StopIfGoingOffIdle

Felfüggeszt egy futó ütemezett feladatot, ha a számítógép aktívvá válik (nem tétlen) a feladat futtatása közben.

Alapértelmezés szerint a számítógép aktívvá válásakor felfüggesztett ütemezett feladat újraindul, amikor a számítógép ismét tétlenné válik. Az alapértelmezett viselkedés módosításához használja a RestartOnIdleResume paramétert .

A StopIfGoingOffIdle paraméter az ütemezett feladatok StopIfGoingOffIdle tulajdonságának értékét a következőre $trueállítja: .

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

-WakeToRun

Felébreszti a számítógépet hibernált vagy alvó állapotból az ütemezett kezdési időpontban, hogy futtathassa a feladatot. Alapértelmezés szerint ha a számítógép hibernált vagy alvó állapotban van az ütemezett kezdési időpontban, a feladat nem fut.

A WakeToRun paraméter az ütemezett feladatok WakeToRun tulajdonságának értékét a következőre $trueállítja: .

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

Bevitelek

Microsoft.PowerShell.ScheduledJob.ScheduledJobOptions

Erre a parancsmagra ütemezett feladatbeállítások objektumot is be lehet csövezni.

Kimenetek

None

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

Microsoft.PowerShell.ScheduledJob.ScheduledJobOptions

A PassThru paraméter használatakor ez a parancsmag a módosított feladatbeállításokat adja vissza.