Sdílet prostřednictvím

Get-ScheduledJob

  • Reference
Modul:
PSScheduledJob

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

Syntaxe

Get-ScheduledJob
   [[-Id] <Int32[]>]
   [<CommonParameters>]
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.

Přestože 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řevést 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

PS C:\> Get-ScheduledJob

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

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

PS C:\> Get-ScheduledJob -Name *Backup*, *Archive*

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

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

PS C:\> Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

Tento příkaz získá všechny naplánované úlohy v počítačích, které jsou uvedeny v souboru Servers.txt. 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

PS C:\> Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Tento příkaz získá triggery úlohy naplánovaných úloh DailyBackup a WeeklyBackup. Pomocí rutiny Get-ScheduledJob získá naplánované úlohy a rutinu Get-JobTrigger k získání aktivačních událostí úlohy plá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.

Typ:Int32[]
Position:0
Default value:All jobs
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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. Podporují se zástupné kóty. Ve výchozím nastavení Get-ScheduledJob získá všechny naplánované úlohy v počítači.

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

Vstupy

None

Vstup do Get-ScheduledJob nelze.

Výstupy

ScheduledJobDefinition

Poznámky

  • Každá naplánovaná úloha se uloží do podadresáře $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs 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\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.