Condividi tramite


Get-ScheduledJobOption

Ottiene le opzioni dei processi pianificati.

Sintassi

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

Descrizione

Il cmdlet Get-ScheduledJobOption ottiene le opzioni di processo dei processi pianificati. È possibile usare questo comando per esaminare le opzioni di processo o per inviare tramite pipe le opzioni di processo ad altri cmdlet.

Le opzioni di processo non vengono salvate su disco separatamente, ma sono parte di un processo pianificato. Per ottenere le opzioni di un processo pianificato, specificare tale processo.

Usare i parametri del cmdlet Get-ScheduledJobOption per identificare il processo pianificato. È possibile identificare i processi pianificati in base ai nomi o ai numeri di identificazione oppure immettendo o inviando tramite pipe oggetti ScheduledJob , ad esempio quelli restituiti dal cmdlet Get-ScheduledJob, a Get-ScheduledJobOption.

Get-ScheduledJobOption è una raccolta di cmdlet di pianificazione dei processi nel modulo PSScheduledJob incluso in Windows PowerShell.

Per altre informazioni sui lavori pianificati, vedere gli argomenti Informazioni nel modulo PSScheduledJob. Importare il modulo PSScheduledJob e quindi digitare: Get-Help about_Scheduled* o vedere about_Scheduled_Jobs.

Questo cmdlet è stato introdotto in Windows PowerShell 3.0.

Esempio

Esempio 1: Ottenere le opzioni di processo

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

Questo comando ottiene le opzioni di processo dei processi pianificati con backup nei nomi. Nei risultati è visualizzato l'oggetto opzioni di processo restituito da Get-ScheduledJobOption.

Esempio 2: Ottenere tutte le opzioni di processo

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

Questo comando ottiene le opzioni di processo di tutti i processi pianificati nel computer locale.

Usa il cmdlet Get-ScheduledJob per ottenere i processi pianificati nel computer locale. Un operatore pipeline (|) invia i processi pianificati al cmdlet Get-ScheduledJobOptions che ottiene le opzioni di processo di ciascun processo pianificato.

Esempio 3: Ottenere le opzioni di processo selezionate

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

Questo esempio mostra come trovare l'oggetto opzioni di processo con determinati valori.

Il primo comando ottiene le opzioni di processo in cui la proprietà RunElevated ha un valore di $True e la proprietà RunWithoutNetwork ha un valore di $False. L'output mostra l'oggetto JobOptions selezionato.

Esempio 4: Usare le opzioni di processo per creare un nuovo processo

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

Questo esempio mostra come usare le opzioni di processo ottenute da Get-ScheduledJobOptions in un nuovo processo pianificato.

Il primo comando usa Get-ScheduledJobOptions per ottenere le opzioni di processo del processo pianificato BackupTestLogs. Il comando salva le opzioni nella variabile $Opts.

Il secondo comando usa Register-ScheduledJob cmdlet per creare un nuovo processo pianificato. Il valore del parametro ScheduledJobOption corrisponde all'oggetto delle opzioni nella variabile $Opts.

Esempio 5: Ottenere le opzioni di processo da un computer remoto

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

Questo comando usa il cmdlet Invoke-Command per ottenere le opzioni di processo pianificate del processo DataDemon nel computer Srv01. Il comando salva le opzioni nella variabile $O.

Parametri

-Id

Specifica il numero di identificazione di un processo pianificato. Get-ScheduledJobOption ottiene le opzioni di processo del processo pianificato specificato.

Per ottenere i numeri di identificazione dei processi pianificati nel computer locale o in un computer remoto, usare il cmdlet Get-ScheduledJob.

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

-InputObject

Specifica un processo pianificato. Immettere una variabile contenente un oggetto ScheduledJob o digitare un comando o un'espressione che ottiene un oggetto ScheduledJob , ad esempio un comando Get-ScheduledJob. È anche possibile inviare tramite pipe un oggetto ScheduledJob a Get-ScheduledJobOption.

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

-Name

Specifica i nomi dei processi pianificati. Get-ScheduledJobOption ottiene le opzioni di processo del processo pianificato specificato. Sono supportati caratteri jolly.

Per ottenere i nomi dei processi pianificati nel computer locale o in un computer remoto, usare il cmdlet Get-ScheduledJob.

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

Input

ScheduledJobDefinition

È possibile inviare tramite pipe un processo pianificato da Get-ScheduledJob a Get-ScheduledJobOption.

Output

ScheduledJobOptions