Get-ScheduledJobOption

Get-ScheduledJobOption
    [-InputObject] <ScheduledJobDefinition>
    [<CommonParameters>]

Get-ScheduledJobOption
    [-Id] <Int32>
    [<CommonParameters>]

Get-ScheduledJobOption
    [-Name] <String>
    [<CommonParameters>]

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å disken 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 ScheduledJob-objekt , 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 modulen PSScheduledJob och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Den här cmdleten introducerades i Windows PowerShell 3.0.

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 det jobbalternativobjekt som Get-ScheduledJobOption returnerade.

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.

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 RunWithoutNetwork egenskapen har värdet $False. Utdata visar JobOptions objekt som har valts.

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.

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 schemalagda jobbalternativ för DataDemon-jobbet på Srv01-datorn. Kommandot sparar alternativen i den $O variabeln.

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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