Get-ScheduledJobOption

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

-InputObject

-Name

Indata

ScheduledJobDefinition

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

Utdata

ScheduledJobOptions

Relaterade länkar

• about_Scheduled_Jobs
• Add-JobTrigger
• Disable-JobTrigger
• Disable-ScheduledJob
• Enable-JobTrigger
• Enable-ScheduledJob
• Get-JobTrigger
• Get-ScheduledJob
• Get-ScheduledJobOption
• New-JobTrigger
• New-ScheduledJobOption
• Register-ScheduledJob
• Remove-JobTrigger
• Set-JobTrigger
• Set-ScheduledJob
• Set-ScheduledJobOption
• Unregister-ScheduledJob