Get-ScheduledJobOption

  • Reference
Modul:
PSScheduledJob

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

Syntax

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ů Get-ScheduledJobOption rutiny 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 objektů ScheduledJob , jako jsou ty, které rutina Get-ScheduledJobGet-ScheduledJobOptionvrací.

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

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

Tato rutina byla zavedena ve Windows PowerShellu 3.0.

Příklady

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

Tento příklad získá možnosti úlohy naplánovaných úloh odpovídající zadanému názvu.

Get-ScheduledJobOption -Name "*Backup*"

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

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

Get-ScheduledJob | Get-ScheduledJobOption

Příklad používá rutinu Get-ScheduledJob k získání naplánovaných úloh na místním počítači. Operátor kanálu (|) odešle naplánované úlohy do Get-ScheduledJobOption rutiny, která získá možnosti úlohy pro každou naplánovanou úlohu.

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

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

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun}

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun} |
    ForEach-Object {$_.JobDefinition}

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 objekt JobOptions , který byl vybrán.

Druhý příkaz ukazuje, jak najít, do které naplánované úlohy patří možnosti úlohy. Tento příkaz používá operátor kanálu (|) k odeslání vybraných možností úlohy rutině ForEach-Object , která získá JobDefinition vlastnost každého objektu options. JobDefinition vlastnost obsahuje původní objekt úlohy.

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

Tento příklad ukazuje, jak používat možnosti úlohy, které Get-ScheduledJobOption se načte v nové naplánované úloze.

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

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

Druhý příkaz používá Register-ScheduledJob rutinu k vytvoření nové naplánované úlohy. Hodnota ScheduledJobOption parametru je objekt options v $Opts proměnné.

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

$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 $O proměnné.

Parametry

-Id

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

K získání identifikačních čísel naplánovaných úloh na místním počítači nebo vzdáleném počítači použijte rutinu Get-ScheduledJob .

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

-InputObject

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

Type:ScheduledJobDefinition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .

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

Vstupy

ScheduledJobDefinition

Do této rutiny můžete převést objekt naplánované úlohy.

Výstupy

ScheduledJobOptions

Tato rutina vrátí objekt ScheduledJobOptions .