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 .

I když se úlohy vytvořené pomocí rutiny Register-ScheduledJob zobrazují v Plánovači úloh, Get-ScheduledJob získají 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 na jiné rutiny.

Get-ScheduledJob 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í 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 Get-ScheduleJob ke spuštění příkazu 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í této rutiny Get-ScheduledJob získá naplánované úlohy a předá je do Get-JobTrigger rutiny, 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 načte všechny naplánované úlohy v počítači.

Typ:Int32[]
Position:0
Default value:None
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 načte všechny naplánované úlohy v počítači.

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

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č Library\Microsoft\Windows\PowerShell\ScheduledJobs úloh. Plánovač úloh můžete použít k zobrazení a úpravě naplánované úlohy.
  • Pomocí plánovače úloh, nástroje příkazového SchTasks.exe řádku a rutin plánovače úloh můžete spravovat naplánované úlohy, které vytvoříte pomocí rutin naplánované úlohy. Rutiny naplánované úlohy ale nemůžete použít ke správě úloh, které vytvoříte v Plánovači úloh.