New-ScheduledJobOption

  • Referencia
Modul:
PSScheduledJob

Létrehoz egy objektumot, amely speciális beállításokat tartalmaz egy ütemezett feladathoz.

Syntax

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

Description

A New-ScheduledJobOption parancsmag létrehoz egy objektumot, amely speciális beállításokat tartalmaz egy ütemezett feladathoz.

Használhatja az ScheduledJobOptions objektumot, amely New-ScheduledJobOption visszatér egy új vagy meglévő ütemezett feladat feladatbeállításainak beállításához. Másik lehetőségként a feladatbeállításokat úgy is beállíthatja, hogy a Get-ScheduledJobOption parancsmaggal lekérje egy meglévő ütemezett feladat feladatbeállításait, vagy egy kivonattábla-érték használatával képviselje a feladatbeállításokat.

Paraméterek nélkül létrehoz egy objektumot, New-ScheduledJobOption amely az összes beállítás alapértelmezett értékeit tartalmazza. Mivel a JobDefinition tulajdonság kivételével az összes tulajdonság szerkeszthető, az eredményként kapott objektumot sablonként használhatja, és szabványos beállításobjektumokat hozhat létre a vállalat számára.

Ütemezett feladatok létrehozásakor és az ütemezett feladatok beállításainak beállításakor tekintse át az összes ütemezett feladatbeállítás alapértelmezett értékeit. Az ütemezett feladatok csak akkor futnak, ha a végrehajtáshoz beállított összes feltétel teljesül.

New-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: Ütemezett feladatbeállítás-objektum létrehozása alapértelmezett értékekkel

Ez a példa létrehoz egy ütemezett feladatbeállítás-objektumot az alapértelmezett értékekkel.

New-ScheduledJobOption

2. példa: Ütemezett feladatbeállítás-objektum létrehozása egyéni értékekkel

Ez a példa létrehoz egy ütemezett feladatbeállítás-objektumot egyéni értékekkel

New-ScheduledJobOption -RequireNetwork -StartIfOnBattery

StartIfOnBatteries     : True
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 : Ignore
NewJobDefinition       :

Az alábbi parancs létrehoz egy ütemezett feladatobjektumot, amely megköveteli a hálózatot, és akkor is futtatja az ütemezett feladatot, ha a számítógép nincs csatlakoztatva a hálózati adapterhez.

A kimenet azt mutatja, hogy a RequireNetwork paraméter a RunWithoutNetwork tulajdonság $false értékét módosította, a StartIfOnBattery paraméter pedig a StartIfOnBatteries tulajdonság $trueértékét.

3. példa: Új ütemezett feladat beállításainak megadása

Ez a példa bemutatja, hogyan használható az ScheduledJobOptions objektum, amely New-ScheduledJobOption visszatér egy új ütemezett feladat beállításainak beállításához.

$runAsAdmin = New-ScheduledJobOption -RunElevated
Register-ScheduledJob -Name Backup -FilePath D:\Scripts\Backup.ps1 -Trigger $Mondays -ScheduledJobOption $RunAsAdmin
Get-ScheduledJobOption -Name Backup

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

Az első parancs létrehoz egy ScheduledJobOptions objektumot a RunElevated paraméterrel. Menti az objektumot a $runAsAdmin változóban.

A második parancs a Register-ScheduledJob parancsmaggal hoz létre egy új ütemezett feladatot. Az ScheduledJobOption paraméter értéke a változó értékében $runAsAdmin lévő beállításobjektum.

A harmadik parancs a Get-ScheduledJobOption parancsmaggal lekéri az ütemezett biztonsági mentési feladat feladatbeállításait. A parancsmag kimenete azt mutatja, hogy a RunElevated tulajdonság be van állítva $true , és a feladatbeállítás-objektum JobDefinition tulajdonsága most fel van töltve a Biztonsági mentés ütemezett feladat ütemezett feladatobjektumával.

4. példa: Ütemezett feladatbeállítás-objektum tulajdonságainak rendezése

Ez a példa bemutatja, hogyan rendezheti az ScheduledJobOptions objektum tulajdonságait betűrendben az egyszerű olvasás érdekében.

$options = New-ScheduledJobOption -WakeToRun
$options.PSObject.Properties | Sort-Object -Property Name | Format-Table -Property Name, Value -Autosize

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

Az első parancs a New-ScheduledJobOption parancsmaggal hoz létre egy ScheduledJobOptions objektumot . A parancs a WakeToRun paramétert használja, és menti az eredményként kapott objektumot a $options változóban.

A $Options tulajdonságainak objektumként való lekéréséhez a második parancs az összes Windows PowerShell-objektum PSObject tulajdonságát és annak Tulajdonságok tulajdonságát használja. A parancs ezután a tulajdonságobjektumokat a Sort-Object parancsmagba irányítja, amely betűrendbe rendezi a tulajdonságokat név szerint, majd a Format-Table parancsmagra, amely megjeleníti a tulajdonságok nevét és értékeit egy táblázatban.

Ezzel a formátummal sokkal könnyebben megtalálhatja az ScheduledJobOptions objektum WakeToRun tulajdonságát, és ellenőrizheti, hogy az értéke át lett-e állítva $false a következőre$true$options.

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 TimeSpan-objektumot, például a parancsmag által New-TimeSpan létrehozott objektumot, vagy írjon <be egy értéket óra>:perc>:<<másodperc> formátumban, amelyet a rendszer automatikusan TimeSpan-objektummákonvertál.

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

Azt adja meg, hogy az ütemezett feladat mennyi ideig várakozik a számítógép tétlen állapotára. Ha ez az időtúllépés még azelőtt lejár, hogy a számítógép tétlen marad az IdleDuration paraméter által megadott időszakra vonatkozóan, a feladat csak a következő ütemezett időpontig fut, ha van ilyen. Az alapértelmezett érték egy óra.

Adjon meg egy TimeSpan-objektumot, például a parancsmag által New-TimeSpan létrehozott objektumot, vagy írjon <be egy értéket óra>:perc>:<<másodperc> formátumban, amelyet a rendszer automatikusan TimeSpan-objektummákonvertál.

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

-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. Az alapértelmezett érték IgnoreNew. A paraméter elfogadható értékei a következők:

  • IgnoreNew – A rendszer figyelmen kívül hagyja az új feladatpéldányt.
  • 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

-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

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

Microsoft.PowerShell.ScheduledJob.ScheduledJobOptions

Ez a parancsmag egy ScheduledJobOptions objektumot ad vissza, amely a létrehozott beállításokat jelöli.

Jegyzetek

  • Használhatja az ScheduledJobOptions objektumot, amely New-ScheduledJobOption a parancsmag ScheduledJobOption paraméterének Register-ScheduledJob értékeként jön létre. Az ScheduledJobOption paraméter azonban egy kivonattábla-értéket is tartalmazhat, amely meghatározza az ScheduledJobOptions objektum tulajdonságait és azok értékeit, például:

    @{ShowInTaskScheduler=$False; RunElevated=$True; IdleDuration="00:05"}