Sdílet prostřednictvím

Get-JobTrigger

  • Reference
Modul:
PSScheduledJob

Získá triggery úlohy naplánovaných úloh.

Syntaxe

Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Id] <Int32>
   [<CommonParameters>]
Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Name] <String>
   [<CommonParameters>]

Description

Rutina Get-JobTrigger získá aktivační události úlohy naplánovaných úloh. Tento příkaz můžete použít k prozkoumání triggerů úlohy nebo k nasouvat triggery úlohy do jiných rutin.

Trigger úlohy definuje opakovaný plán nebo podmínky pro spuštění naplánované úlohy. Triggery úloh se neukládají na disk nezávisle; jsou součástí naplánované úlohy. Pokud chcete získat aktivační událost úlohy, zadejte naplánovanou úlohu, kterou trigger spustí.

Pomocí parametrů Get-JobTrigger rutiny identifikujte naplánované úlohy. 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 vrací Get-ScheduledJob Get-JobTrigger.

Get-JobTrigger 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í triggeru úlohy podle názvu naplánované úlohy

Get-JobTrigger -Name "BackupJob"

Příkaz pomocí parametru Get-JobTrigger Name získá aktivační události úlohy naplánované BackupJob úlohy.

Příklad 2: Získání triggeru úlohy podle ID

Příklad používá parametr Get-JobTrigger ID pro získání aktivačních událostí úlohy naplánované úlohy.

Get-ScheduledJob

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProjects {1}             \\Server\Share\Archive-Projects.ps1      True
2          Backup          {1,2}           \\Server\Share\Run-Backup.ps1            True
3          Test-HelpFiles  {1}             \\Server\Share\Test-HelpFiles.ps1        True
4          TestJob         {}              \\Server\Share\Run-AllTests.ps1          True

Get-JobTrigger -ID 3

První příkaz pomocí rutiny Get-ScheduledJob zobrazí naplánované úlohy v místním počítači. Zobrazení obsahuje ID naplánovaných úloh.

Druhý příkaz použije rutinu Get-JobTrigger k získání triggeru úlohy pro Test-HelpFiles úlohu (jejíž ID je 3).

Příklad 3: Získání triggerů úlohy propojením úlohy

Tento příklad získá triggery úloh úloh, které mají odpovídající názvy.

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

Tento příkaz získá aktivační události úlohy všech úloh, které mají Backup nebo Archive mají jejich názvy.

Příklad 4: Získání triggeru úlohy ve vzdáleném počítači

Tento příklad načte triggery naplánované úlohy na vzdáleném počítači.

Invoke-Command -ComputerName Server01 { Get-ScheduledJob Backup | Get-JobTrigger -TriggerID 2 }

Příkaz používá rutinu Invoke-Command ke spuštění příkazu na počítači Server01. Pomocí této rutiny Get-ScheduledJob získá naplánovanou Backup úlohu, kterou do rutiny Get-JobTrigger předá. Používá parametr TriggerID k získání pouze druhého triggeru.

Příklad 5: Získání všech triggerů úloh

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

Get-ScheduledJob | Get-JobTrigger |
    Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="ScheduledJob";Expression={$_.JobDefinition.Name}} -AutoSize

Id Frequency At                    DaysOfWeek Enabled ScheduledJob
-- --------- --                    ---------- ------- ------------
1    Weekly  9/28/2011 3:00:00 AM  {Monday}   True    Backup
1    Daily   9/27/2011 11:00:00 PM            True    Test-HelpFiles

Příkaz pomocí Get-ScheduledJob příkazu získá naplánované úlohy v místním počítači a předá je do Get-JobTrigger, což získá aktivační událost úlohy pro každou naplánovanou úlohu (pokud existuje).

K přidání názvu naplánované úlohy do zobrazení triggeru úlohy použije příkaz funkci počítané vlastnosti rutiny Format-Table . Kromě vlastností triggeru úlohy, které se ve výchozím nastavení zobrazují, vytvoří příkaz novou vlastnost ScheduledJob , která zobrazí název naplánované úlohy.

Příklad 6: Získání vlastnosti triggeru úlohy naplánované úlohy

Tento příklad ukazuje různé metody zobrazení JobTrigger vlastnost naplánované úlohy.

(Get-ScheduledJob Test-HelpFiles).JobTriggers
Get-ScheduledJob | foreach {$_.JobTriggers}

První příkaz pomocí rutiny Get-ScheduledJob získá naplánovanou Test-HelpFiles úlohu. Pak pomocí tečky (.) získat JobTriggers vlastnost naplánované Test-HelpFiles úlohy.

Druhý příkaz pomocí rutiny Get-ScheduledJob získá všechny naplánované úlohy v místním počítači. Pomocí rutiny ForEach-Object získá hodnotu vlastnosti JobTriggers každé naplánované úlohy.

Aktivační události úlohy naplánované úlohy jsou uloženy ve vlastnosti JobTriggers úlohy. Tento příklad ukazuje alternativy použití Get-JobTrigger rutiny k získání triggerů úloh. Výsledky jsou stejné jako při použití Get-JobTrigger rutiny a techniky se dají zaměnitelně.

Příklad 7: Porovnání triggerů úloh

Get-ScheduledJob -Name ArchiveProjects | Get-JobTrigger | Tee-Object -Variable t1

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

Get-ScheduledJob -Name "Test-HelpFiles" | Get-JobTrigger | Tee-Object -Variable t2

Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/26/2011 3:00:00 AM                           True

$t1| Get-Member -Type Property | ForEach-Object { Compare-Object $t1 $t2 -Property $_.Name}

RandomDelay                                                 SideIndicator
-----------                                                 -------------
00:00:00                                                    =>
00:03:00                                                    <=

První příkaz získá trigger úlohy naplánované ArchiveProjects úlohy. Příkaz předá trigger úlohy do Tee-Object rutiny, která uloží trigger úlohy do $t1 proměnné a zobrazí ji na příkazovém řádku.

Druhý příkaz získá trigger úlohy naplánované Test-HelpFiles úlohy. Příkaz předá trigger úlohy do Tee-Object rutiny, která uloží trigger úlohy do $t2 proměnné a zobrazí ji na příkazovém řádku.

Třetí příkaz porovná triggery úlohy v $t1 proměnných a $t 2. Pomocí rutiny Get-Member získá vlastnosti triggeru úlohy v proměnné $t 1. Předá vlastnosti rutině ForEach-Object , která porovnává jednotlivé vlastnosti s vlastnostmi triggeru úlohy v $t2 proměnné podle názvu. Příkaz pak předá různé vlastnosti rutině Format-List , která je zobrazí v seznamu. Výstup označuje, že i když se triggery úloh jeví jako stejné, HelpFiles aktivační událost úlohy zahrnuje náhodné zpoždění tří (3) minut.

Tento příklad ukazuje, jak porovnat triggery úloh dvou naplánovaných úloh.

Parametry

-Id

Určuje identifikační číslo naplánované úlohy. Get-JobTrigger získá aktivační událost úlohy zadané naplánované úlohy.

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

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

-InputObject

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

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

-Name

Určuje název naplánované úlohy. Get-JobTrigger získá aktivační událost ú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 .

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

-TriggerId

Získá zadané aktivační události úlohy. Zadejte ID aktivační události jedné nebo více aktivačních událostí úlohy naplánované úlohy. Tento parametr použijte, pokud má naplánovaná úloha určená parametry Name, ID nebo InputObject několik aktivačních událostí úlohy.

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

Vstupy

ScheduledJobDefinition

Do této rutiny můžete převést naplánovanou úlohu.

Výstupy

ScheduledJobTrigger

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