New-ScheduledJobOption

Referens

Modul:: PSScheduledJob

Skapar ett objekt som innehåller avancerade alternativ för ett schemalagt jobb.

Syntax

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

Description

Cmdleten New-ScheduledJobOption skapar ett objekt som innehåller avancerade alternativ för ett schemalagt jobb.

Du kan använda objektet ScheduledJobOptions som New-ScheduledJobOption returnerar för att ange jobbalternativ för ett nytt eller befintligt schemalagt jobb. Du kan också ange jobbalternativ med hjälp av cmdleten Get-ScheduledJobOption för att hämta jobbalternativen för ett befintligt schemalagt jobb eller genom att använda ett hash-tabellvärde för att representera jobbalternativen.

Utan parametrar genererar New-ScheduledJobOption ett objekt som innehåller standardvärdena för alla alternativ. Eftersom alla egenskaper förutom egenskapen JobDefinition kan redigeras kan du använda det resulterande objektet som en mall och skapa standardalternativobjekt för ditt företag.

När du skapar schemalagda jobb och anger alternativ för schemalagda jobb granskar du standardvärdena för alla alternativ för schemalagt jobb. Schemalagda jobb körs bara när alla villkor som angetts för körningen är uppfyllda.

New-ScheduledJobOption är en av en samling cmdletar för jobbschemaläggning i modulen PSScheduledJob som ingår i Windows PowerShell.

Mer information om schemalagda jobb finns i Om ämnen i modulen PSScheduledJob. Importera PSScheduledJob-modulen och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Denna cmdlet introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Skapa ett schemalagt jobbalternativobjekt med standardvärden

PS C:\> New-ScheduledJobOption
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      : True
DoNotAllowDemandStart  : False
MultipleInstancePolicy : Ignore
NewJobDefinition       :

Det här kommandot skapar ett schemalagt jobbalternativobjekt som har alla standardvärden.

Exempel 2: Skapa ett schemalagt jobbalternativobjekt med anpassade värden

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

Följande kommando skapar ett schemalagt jobbobjekt som kräver nätverket och kör det schemalagda jobbet även om datorn inte är ansluten till nätström.

Utdata visar att parametern RequireNetwork ändrade värdet för egenskapen RunWithoutNetwork till $False och parametern StartIfOnBattery ändrade värdet för egenskapen StartIfOnBatteries till $True.

Exempel 3: Ange alternativ för ett nytt schemalagt jobb

The first command creates a **ScheduledJobOptions** object with the *RunElevated* parameter. It saves the object in the $RunAsAdmin variable.
PS C:\> $RunAsAdmin = New-ScheduledJobOption -RunElevated

The second command uses the Register-ScheduledJob cmdlet to create a new scheduled job. The value of the *ScheduledJobOption* parameter is the option object in the value of the $RunAsAdmin variable.
PS C:\> Register-ScheduledJob -Name Backup -FilePath D:\Scripts\Backup.ps1 -Trigger $Mondays -ScheduledJobOption $RunAsAdmin

The third command uses the Get-ScheduledJobOption cmdlet to get the job options of the Backup scheduled job.The cmdlet output shows that the RunElevated property is set to $True and the JobDefinition property of the job option object is now populated with the scheduled job object for the Backup scheduled job.
PS C:\> 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

Det här exemplet visar hur du använder objektet ScheduledJobOptions som New-ScheduledJobOption returnerar för att ange alternativen för ett nytt schemalagt jobb.

Exempel 4: Sortera egenskaperna för ett schemalagt jobbalternativobjekt

PS C:\> $Options = New-ScheduledJobOption -WakeToRun
PS C:\> $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

Det här exemplet visar hur du sorterar egenskaperna för ett ScheduledJobOptions-objekt i alfabetisk ordning för enkel läsning.

Det första kommandot använder cmdleten New-ScheduledJobOption för att skapa ett ScheduledJobOptions-objekt . Kommandot använder parametern WakeToRun och sparar det resulterande objektet i variabeln $Options.

För att hämta egenskaperna för $Options som objekt använder det andra kommandot PSObject-egenskapen för alla Windows PowerShell objekt och dess egenskap Egenskaper. Kommandot skickar sedan egenskapsobjekten till cmdleten Sort-Object, som sorterar egenskaperna i alfabetisk ordning efter namn, och sedan till cmdleten Format-Table, som visar namnen och värdena för egenskaperna i en tabell.

Det här formatet gör det mycket enklare att hitta egenskapen WakeToRun för objektet ScheduledJobOptions i $Options och att kontrollera att dess värde har ändrats från $False till $True.

Parametrar

-ContinueIfGoingOnBattery

Stoppa inte det schemalagda jobbet om datorn växlar till batteridrift (kopplar från ström) medan jobbet körs. Som standard stoppas schemalagda jobb när datorn kopplas från nätströmmen.

Parametern ContinueIfGoingOnBattery anger värdet för egenskapen StopIfGoingOnBatteries för schemalagda jobb till $True.

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

-DoNotAllowDemandStart

Starta bara jobbet när det utlöses. Användarna kan inte starta jobbet manuellt, till exempel genom att använda funktionen Kör i Schemaläggaren.

Den här parametern påverkar endast Schemaläggaren. Det hindrar inte användare från att använda cmdleten Start-Job för att starta jobbet.

Parametern DoNotAllowDemandStart anger värdet för egenskapen DoNotAllowDemandStart för schemalagda jobb till $True.

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

-HideInTaskScheduler

Visa inte jobbet i Schemaläggaren. Det här värdet påverkar bara den dator där jobbet körs. Som standard visas schemalagda aktiviteter i Schemaläggaren.

Även om en aktivitet är dold kan användarna visa uppgiften genom att välja alternativet Visa dolda aktiviteter i Schemaläggaren.

Parametern HideInTaskScheduler anger värdet för egenskapen ShowInTaskScheduler för schemalagda jobb till $False.

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

-IdleDuration

Anger hur länge datorn måste vara inaktiv innan jobbet startar. Standardvärdet är 10 minuter. Om datorn inte är inaktiv under den angivna varaktigheten innan värdet för IdleTimeout upphör att gälla, körs inte det schemalagda jobbet förrän nästa schemalagda tid, om det finns några.

Ange ett TimeSpan-objekt , till exempel ett som genereras av cmdleten New-TimeSpan, eller ange ett värde i <formatet hours>:<minutes>:<seconds> som automatiskt konverteras till ett TimeSpan-objekt .

Om du vill aktivera det här värdet använder du parametern StartIfIdle . Som standard är egenskapen StartIfNotIdle för schemalagda jobb inställd på $True och Windows PowerShell ignorerar värdena IdleDuration och IdleTimeout.

Type:	TimeSpan
Position:	Named
Default value:	10 minutes (00:10:00)
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdleTimeout

Anger hur länge det schemalagda jobbet väntar på att datorn ska vara inaktiv. Om tidsgränsen går ut innan datorn förblir inaktiv under den tidsperiod som anges av parametern IdleDuration körs inte jobbet förrän nästa schemalagda tid, om sådan finns. Standardvärdet är en timme.

Type:	TimeSpan
Position:	Named
Default value:	1 hour (1:00:00)
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MultipleInstancePolicy

Avgör hur systemet svarar på en begäran om att starta en instans av ett schemalagt jobb medan en annan instans av jobbet körs. Standardvärdet är IgnoreNew. De acceptabla värdena för den här parametern är:

IgnoreNew. Den nya jobbinstansen ignoreras.
Parallell. Den nya jobbinstansen startar omedelbart.
Kö. Den nya jobbinstansen startar så snart den aktuella instansen har slutförts.
StopExisting. Den aktuella instansen av jobbet stoppas och den nya instansen startar.

Om du vill köra jobbet måste alla villkor för jobbschemat vara uppfyllda. Om till exempel de villkor som anges av parametrarna RequireNetwork, IdleDuration och IdleTimeout inte uppfylls, startas inte jobbinstansen, oavsett värdet för den här parametern.

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

-RequireNetwork

Kör endast det schemalagda jobbet när nätverksanslutningar är tillgängliga.

Om du anger den här parametern och nätverket inte är tillgängligt vid den schemalagda starttiden körs inte jobbet förrän nästa schemalagda starttid, om det finns några.

Parametern RequireNetwork anger värdet för egenskapen RunWithoutNetwork för schemalagda jobb till $False.

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

-RestartOnIdleResume

Startar om ett schemalagt jobb när datorn blir inaktiv. Den här parametern fungerar med parametern StopIfGoingOffIdle , som pausar ett schemalagt jobb som körs om datorn blir aktiv (lämnar inaktivt tillstånd).

Parametern RestartOnIdleResume anger värdet för egenskapen RestartOnIdleResume för schemalagda jobb till $True.

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

-RunElevated

Kör det schemalagda jobbet med behörigheter för en medlem i gruppen Administratörer på den dator där jobbet körs.

Om du vill att ett schemalagt jobb ska köras med administratörsbehörigheter använder du parametern Autentiseringsuppgifter för Register-ScheduledJob för att ange explicita autentiseringsuppgifter för jobbet.

Parametern RunElevated anger värdet för egenskapen RunElevated för schemalagda jobb till $True.

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

-StartIfIdle

Startar det schemalagda jobbet om datorn har varit inaktiv under den tid som anges av parametern IdleDuration innan den tid som anges av parametern IdleTimeout upphör att gälla.

Som standard ignoreras parametrarna IdleDuration och IdleTimeout och jobbet startar vid den schemalagda starttiden även om datorn är upptagen.

Om du anger den här parametern och datorn är upptagen (inte inaktiv) vid den schemalagda starttiden körs inte jobbet förrän nästa schemalagda starttid, om det finns några.

Parametern StartIfIdle anger värdet för egenskapen StartIfNotIdle för schemalagda jobb till $False.

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

-StartIfOnBattery

Startar det schemalagda jobbet även om datorn körs på batterier vid den schemalagda starttiden. Standardvärdet är $False.

Parametern StartIfOnBattery anger värdet för egenskapen StartIfOnBatteries för schemalagda jobb till $True.

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

-StopIfGoingOffIdle

Inaktiverar ett schemalagt jobb som körs om datorn blir aktiv (inte inaktiv) medan jobbet körs.

Som standard återupptas ett schemalagt jobb som pausas när datorn blir aktiv när datorn blir inaktiv igen. Om du vill ändra standardbeteendet använder du parametern RestartOnIdleResume .

Parametern StopIfGoingOffIdle anger värdet för egenskapen StopIfGoingOffIdle för schemalagda jobb till $True.

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

-WakeToRun

Växlar datorn från viloläge eller viloläge vid schemalagd starttid så att den kan köra jobbet. Om datorn är i viloläge eller viloläge vid schemalagd starttid körs inte jobbet som standard.

Parametern WakeToRun anger värdet för egenskapen WakeToRun för schemalagda jobb till $True.

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

Indata

None

Du kan inte skicka indata till denna cmdlet.

Utdata

ScheduledJobOptions

Kommentarer

Du kan använda objektet ScheduledJobOptions som New-ScheduledJobOption skapar som värde för parametern ScheduledJobOption för cmdleten Register-ScheduledJob. Men parametern ScheduledJobOption kan också ta ett hash-tabellvärde som anger egenskaperna för objektet ScheduledJobOptions och deras värden, till exempel:

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