Get-ScheduledJob

Modul:
PSScheduledJob Module

Získá naplánované úlohy v místním počítači.

Syntax

DefinitionId (Výchozí) 

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

DefinitionName 

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

Description

Rutina Get-ScheduledJob získá naplánované úlohy na místním počítači. Get-ScheduledJob získá pouze naplánované úlohy vytvořené aktuálním uživatelem pomocí rutiny Register-ScheduledJob.

I když se úlohy vytvořené pomocí rutiny Register-ScheduledJob zobrazí v Plánovači úloh, Get-ScheduledJob získá pouze naplánované úlohy. Nenačte naplánované úkoly vytvořené v Plánovači úloh.

Bez parametrů Get-ScheduledJob získá všechny naplánované úlohy v počítači. Pomocí parametrů Get-ScheduledJob můžete získat naplánované úlohy podle ID nebo názvu a prozkoumat je nebo je přeskakovat do jiných rutin.

Get-ScheduledJob 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í všech naplánovaných úloh

Tento příklad získá všechny naplánované úlohy v místním počítači.

Get-ScheduledJob

Příklad 2: Získání naplánovaných úloh podle názvu

Tento příklad získá všechny naplánované úlohy v počítači s názvy, které obsahují zálohování nebo archivaci. Tento formát příkazu umožňuje hledat konkrétní úlohy.

Get-ScheduledJob -Name *Backup*, *Archive*

Příklad 3: Získání naplánovaných úloh na vzdálených počítačích

Tento příklad získá všechny naplánované úlohy v počítačích, které jsou uvedeny v textovém souboru.

Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

Příkaz používá rutinu Invoke-Command ke spuštění příkazu Get-ScheduleJob na každém počítači.

Příklad 4: Kanál naplánovaných úloh do jiných rutin

Tento příklad získá aktivační události úlohy zadaných naplánovaných úloh.

Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Pomocí rutiny Get-ScheduledJob získá naplánované úlohy a předá je do rutiny Get-JobTrigger, aby získal aktivační události úlohy naplánovaných úloh.

Parametry

-Id

Získá pouze naplánované úlohy se zadaným identifikačním číslem (ID). Zadejte jedno nebo více ID naplánovaných úloh v počítači. Ve výchozím nastavení Get-ScheduledJob získá všechny naplánované úlohy v počítači.

Vlastnosti parametru

Typ:

Int32[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

DefinitionId
Position:0
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

Získá pouze naplánované úlohy se zadanými názvy. Zadejte jeden nebo více názvů naplánovaných úloh v počítači. Zástupné znaky jsou podporovány. Ve výchozím nastavení Get-ScheduledJob získá všechny naplánované úlohy v počítači.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

DefinitionName
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Objekty můžete do této rutiny převést.

Výstupy

ScheduledJobDefinition

Tato rutina vrátí definici naplánované úlohy.

Poznámky

  • Každá naplánovaná úloha se uloží do podadresáře $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs adresáře v místním počítači. Podadresář má název pro naplánovanou úlohu a obsahuje soubor XML pro naplánovanou úlohu a záznamy historie spuštění. Další informace o naplánovaných úlohách na disku najdete v tématu about_Scheduled_Jobs_Advanced.
  • Naplánované úlohy, které vytvoříte ve Windows PowerShellu, se zobrazí v Plánovači úloh ve složce Plánovač úloh Library\Microsoft\Windows\PowerShell\ScheduledJobs. Plánovač úloh můžete použít k zobrazení a úpravě naplánované úlohy.
  • Ke správě naplánovaných úloh, které vytvoříte pomocí rutin naplánované úlohy, můžete použít plánovač úloh, nástroj příkazového řádku SchTasks.exe a rutiny plánovače úloh. Rutiny naplánované úlohy ale nemůžete použít ke správě úloh, které vytvoříte v Plánovači úloh.