Dela via


Get-ScheduledJobOption

Hämtar jobbalternativen för schemalagda jobb.

Syntax

Get-ScheduledJobOption
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Id] <Int32>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Name] <String>
   [<CommonParameters>]

Description

Cmdleten Get-ScheduledJobOption hämtar jobbalternativen för schemalagda jobb. Du kan använda det här kommandot för att undersöka jobbalternativen eller skicka jobbalternativen till andra cmdletar.

Jobbalternativ sparas inte på diskar oberoende av varandra. de ingår i ett schemalagt jobb. Om du vill hämta jobbalternativen för ett schemalagt jobb anger du det schemalagda jobbet.

Använd parametrarna för cmdleten Get-ScheduledJobOption för att identifiera det schemalagda jobbet. Du kan identifiera schemalagda jobb med deras namn eller ID-nummer, eller genom att ange eller skicka schemalagda jobbobjekt , till exempel de som returneras av cmdleten Get-ScheduledJob, till Get-ScheduledJobOption.

Get-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 avsnittet Om 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: Hämta jobbalternativ

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 : Ignore

NewJobDefinition       : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Det här kommandot hämtar jobbalternativen för schemalagda jobb som har BackUp i sina namn. Resultatet visar jobbalternativobjektet som Get-ScheduledJobOption returnerade.

Exempel 2: Hämta alla jobbalternativ

PS C:\> Get-ScheduledJob | Get-ScheduledJobOptions

Det här kommandot hämtar jobbalternativen för alla schemalagda jobb på den lokala datorn.

Den använder cmdleten Get-ScheduledJob för att hämta schemalagda jobb på den lokala datorn. En pipelineoperator (|) skickar de schemalagda jobben till cmdleten Get-ScheduledJobOptions , som hämtar jobbalternativen för varje schemalagt jobb.

Exempel 3: Hämta valda jobbalternativ

PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun}
StartIfOnBatteries     : False

StopIfGoingOnBatteries : True

WakeToRun              : True

StartIfNotIdle         : True

StopIfGoingOffIdle     : False

RestartOnIdleResume    : False

IdleDuration           : 00:10:00

IdleTimeout            : 01:00:00

ShowInTaskScheduler    : True

RunElevated            : True

RunWithoutNetwork      : True

DoNotAllowDemandStart  : False

MultipleInstancePolicy : Ignore

NewJobDefinition       : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

The second command shows how to find to which scheduled job the job options belong. This command uses a pipeline operator (|) to send the selected job options to the ForEach-Object cmdlet, which gets the JobDefinition property of each options object. The JobDefinition property contains the originating job object. The results show that the selected options came from the DeployPkg scheduled job.
PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun} | ForEach-Object {$_.JobDefinition}
Id         Name            Triggers        Command                                  Enabled

--         ----            --------        -------                                  -------

2          DeployPkg         {1, 2}        DeployPackage.ps1                        True

Det här exemplet visar hur du hittar jobbalternativobjekt med specifika värden.

Det första kommandot hämtar jobbalternativ där egenskapen RunElevated har värdet $True och egenskapen RunWithoutNetwork har värdet $False. Utdata visar joboptions-objektet som har valts .

Exempel 4: Använd jobbalternativ för att skapa ett nytt jobb

PS C:\> $Opts = Get-ScheduledJobOption -Name "BackupTestLogs"
PS C:\> Register-ScheduledJob -Name "Archive-Scripts" -FilePath "\\Srv01\Scripts\ArchiveScripts.ps1" -ScheduledJobOption $Opts

Det här exemplet visar hur du använder jobbalternativen som Get-ScheduledJobOptions får i ett nytt schemalagt jobb.

Det första kommandot använder Get-ScheduledJobOptions för att hämta jobbalternativen för det schemalagda jobbet BackupTestLogs. Kommandot sparar alternativen i variabeln $Opts.

Det andra kommandot använder Register-ScheduledJob cmdlet för att skapa ett nytt schemalagt jobb. Värdet för parametern ScheduledJobOption är alternativobjektet i variabeln $Opts.

Exempel 5: Hämta jobbalternativ från en fjärrdator

PS C:\> $O = Invoke-Command -ComputerName "Srv01" -ScriptBlock {Get-ScheduledJob -Name "DataDemon" }

Det här kommandot använder cmdleten Invoke-Command för att hämta de schemalagda jobbalternativen för DataDemon-jobbet på Srv01-datorn. Kommandot sparar alternativen i variabeln $O.

Parametrar

-Id

Anger identifieringsnumret för ett schemalagt jobb. Get-ScheduledJobOption hämtar jobbalternativen för det angivna schemalagda jobbet.

Om du vill hämta identifieringsnumren för schemalagda jobb på den lokala datorn eller en fjärrdator använder du cmdleten Get-ScheduledJob.

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

-InputObject

Anger ett schemalagt jobb. Ange en variabel som innehåller ett ScheduledJob-objekt eller skriv ett kommando eller uttryck som hämtar ett ScheduledJob-objekt , till exempel ett Get-ScheduledJob kommando. Du kan också skicka ett ScheduledJob-objekt till Get-ScheduledJobOption.

Type:ScheduledJobDefinition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Anger namnen på schemalagda jobb. Get-ScheduledJobOption hämtar jobbalternativen för det angivna schemalagda jobbet. Jokertecken stöds.

Om du vill hämta namnen på schemalagda jobb på den lokala datorn eller en fjärrdator använder du cmdleten Get-ScheduledJob.

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

Indata

ScheduledJobDefinition

Du kan skicka ett schemalagt jobb från Get-ScheduledJob till Get-ScheduledJobOption.

Utdata

ScheduledJobOptions