Sdílet prostřednictvím

Get-ScheduledJobOption

  • Reference
Modul:
PSScheduledJob

Získá možnosti úlohy naplánovaných úloh.

Syntaxe

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

Description

Rutina Get-ScheduledJobOption získá možnosti úlohy naplánovaných úloh. Tento příkaz můžete použít k prozkoumání možností úlohy nebo k přemísťování možností úlohy do jiných rutin.

Možnosti úlohy se neukládají na disk nezávisle; jsou součástí naplánované úlohy. Pokud chcete získat možnosti úlohy naplánované úlohy, zadejte naplánovanou úlohu.

Pomocí parametrů rutiny Get-ScheduledJobOption identifikujte naplánovanou úlohu. Naplánované úlohy můžete identifikovat podle jejich názvů nebo identifikačních čísel nebo zadáním nebo propojením objekty ScheduledJob, jako jsou ty, které vrací rutina Get-ScheduledJob, a Get-ScheduledJobOption.

Get-ScheduledJobOption je jednou z kolekcí rutin plánování úloh v modulu PSScheduledJob, který je součástí Prostředí Windows PowerShell.

Další informace o naplánovaných úlohách naleznete v tématu o tématech v modulu PSScheduledJob. Importujte modul PSScheduledJob a zadejte: Get-Help about_Scheduled* nebo viz about_Scheduled_Jobs.

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

Příklad 1: Získání možností úlohy

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

Tento příkaz získá možnosti úlohy naplánovaných úloh, které mají backup v jejich názvech. Výsledky zobrazují objekt možností úlohy, který Vráceno get-ScheduledJobOption.

Příklad 2: Získání všech možností úlohy

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

Tento příkaz získá možnosti úlohy všech naplánovaných úloh v místním počítači.

Pomocí rutiny Get-ScheduledJob získá naplánované úlohy na místním počítači. Operátor kanálu (|) odesílá naplánované úlohy do rutiny Get-ScheduledJobOptions, která získá možnosti úlohy každé naplánované úlohy.

Příklad 3: Získání vybraných možností úlohy

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

Tento příklad ukazuje, jak najít objekt možností úlohy s konkrétními hodnotami.

První příkaz získá možnosti úlohy, ve kterých RunElevated vlastnost má hodnotu $True a RunWithoutNetwork vlastnost má hodnotu $False. Výstup zobrazuje JobOptions objekt, který byl vybrán.

Příklad 4: Vytvoření nové úlohy pomocí možností úlohy

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

Tento příklad ukazuje, jak používat možnosti úlohy, které Get-ScheduledJobOptions dostane do nové naplánované úlohy.

První příkaz používá Get-ScheduledJobOptions k získání možností úloh naplánované úlohy BackupTestLogs. Příkaz uloží možnosti do proměnné $Opts.

Druhý příkaz pomocí rutiny Register-ScheduledJob vytvoří novou naplánovanou úlohu. Hodnota parametru ScheduledJobOption je objekt options v proměnné $Opts.

Příklad 5: Získání možností úlohy ze vzdáleného počítače

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

Tento příkaz používá rutinu Invoke-Command k získání možností naplánované úlohy úlohy DataDemon na počítači Srv01. Příkaz uloží možnosti do proměnné $O.

Parametry

-Id

Určuje identifikační číslo naplánované úlohy. Get-ScheduledJobOption získá možnosti úlohy zadané naplánované úlohy.

Pokud chcete získat identifikační čísla naplánovaných úloh na místním počítači nebo ve vzdáleném počítači, použijte rutinu Get-ScheduledJob.

Typ:Int32
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-InputObject

Určuje naplánovanou úlohu. Zadejte proměnnou, která obsahuje ScheduledJob objekt nebo zadejte příkaz nebo výraz, který získá ScheduledJob objekt, například příkaz Get-ScheduledJob. Objekt ScheduledJob můžete takéGet-ScheduledJobOption.

Typ:ScheduledJobDefinition
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje názvy naplánovaných úloh. Get-ScheduledJobOption získá možnosti úlohy zadané naplánované úlohy. Podporují se zástupné kóty.

Názvy naplánovaných úloh získáte na místním počítači nebo ve vzdáleném počítači pomocí rutiny Get-ScheduledJob.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

ScheduledJobDefinition

Naplánovanou úlohu můžete převést z Get-ScheduledJob do Get-ScheduledJobOption .

Výstupy

ScheduledJobOptions