Get-ScheduledJob

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

Syntax

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

Description

Rutina Get-ScheduledJob získá naplánované úlohy v 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í Register-ScheduledJob rutiny zobrazí v Plánovači úloh, Get-ScheduledJob získá pouze naplánované úlohy. V Plánovači úloh se nevytvořily naplánované úlohy.

Bez parametrů získá Get-ScheduledJob 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ředvést do jiných rutin.

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

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

Tato rutina byla zavedena v Windows PowerShell 3.0.

Příklady

Příklad 1: Získání všech naplánovaných úloh

Tento příklad načte 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 načte všechny naplánované úlohy v počítači s názvy, které zahrnují Zálohování nebo Archiv. Tento formát příkazu umožňuje vyhledat 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í Get-ScheduleJob 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á triggery úloh určený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 Get-JobTrigger rutiny, aby získal triggery 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.

Type:Int32[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters: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é cardy jsou podporované. Ve výchozím nastavení Get-ScheduledJob získá všechny naplánované úlohy v počítači.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

None

Objekty nelze do této rutiny převést.

Výstupy

Microsoft.PowerShell.ScheduledJob.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 její historie provádě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 v Windows PowerShell se zobrazí v Plánovači úloh ve složce Plánovač Library\Microsoft\Windows\PowerShell\ScheduledJobs úloh. Naplánovanou úlohu můžete zobrazit a upravit pomocí Plánovače úloh.
  • Plánovač úloh, nástroj příkazového SchTasks.exe řádku a rutiny Plánovače úloh můžete použít ke správě naplánovaných úloh, které vytvoříte pomocí rutin Naplánované úlohy. Rutiny Naplánované úlohy však nelze použít ke správě úkolů, které vytvoříte v Plánovači úloh.