Sdílet prostřednictvím

Get-JobTrigger

  • Reference
Modul:
PSScheduledJob

Získá aktivační události úlohy naplánovaných úloh.

Syntax

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

Description

Rutina Get-JobTrigger získá triggery úloh naplánovaných úloh. Tento příkaz můžete použít ke kontrole triggerů úloh nebo k předaní triggerů úloh do jiných rutin.

Aktivační událost úlohy definuje plán opakování nebo podmínky pro spuštění naplánované úlohy. Triggery úloh nejsou uloženy na disku nezávisle; jsou součástí naplánované úlohy. Pokud chcete získat trigger úlohy, zadejte naplánovanou úlohu, kterou trigger spustí.

Pomocí parametrů rutiny Get-JobTrigger identifikujte naplánované úlohy. Naplánované úlohy můžete identifikovat podle jejich názvů, identifikačních čísel nebo zadáním nebo propojením objektů ScheduledJob , například objektů vrácených rutinou Get-ScheduledJob, do Rutiny Get-JobTrigger.

Get-JobTrigger je 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 about_Scheduled_Jobs.

Tato rutina byla zavedena v Windows PowerShell 3.0.

Příklady

Příklad 1: Získání triggeru úlohy podle názvu naplánované úlohy

PS C:\> Get-JobTrigger -Name "BackupJob"

Příkaz používá parametr Name rutiny Get-JobTrigger k získání triggerů úloh naplánované úlohy úlohy BackupJob.

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

The first command uses the Get-ScheduledJob cmdlet to display the scheduled jobs on the local computer. The display includes the IDs of the scheduled jobs.
PS C:\> 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

The second command uses the **Get-JobTrigger** cmdlet to get the job trigger for the Test-HelpFiles job (ID = 3)
PS C:\> Get-JobTrigger -ID 3

Příklad používá parametr IDget-JobTrigger k získání triggerů úloh naplánované úlohy.

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

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

Tento příkaz získá triggery úloh pro všechny úlohy, které mají v názvu Zálohování nebo Archiv.

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

PS C:\> Invoke-Command -ComputerName Server01 { Get-ScheduledJob Backup | Get-JobTrigger -TriggerID 2 }

Tento příkaz získá jeden ze dvou aktivačních událostí úlohy naplánované úlohy na vzdáleném počítači.

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

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

PS C:\> 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

Tento příkaz načte všechny triggery úloh všech naplánovaných úloh v místním počítači.

Příkaz pomocí Get-ScheduledJob získá naplánované úlohy v místním počítači a předá je do rutiny Get-JobTrigger, která 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 zobrazují ve výchozím nastavení, 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

The command uses the Get-ScheduledJob cmdlet to get the Test-HelpFiles scheduled job. Then it uses the dot method (.) to get the JobTriggers property of the Test-HelpFiles scheduled job.
PS C:\> (Get-ScheduledJob Test-HelpFiles).JobTriggers

The second command uses the Get-ScheduledJob cmdlet to get all scheduled jobs on the local computer. It uses the ForEach-Object cmdlet to get the value of the JobTrigger property of each scheduled job.
PS C:\> Get-ScheduledJob | foreach {$_.JobTriggers}

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

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

The first command gets the job trigger of the ArchiveProjects scheduled job. The command pipes the job trigger to the Tee-Object cmdlet, which saves the job trigger in the $T1 variable and displays it at the command line.
PS C:\> 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

The second command gets the job trigger of the Test-HelpFiles scheduled job. The command pipes the job trigger to the Tee-Object cmdlet, which saves the job trigger in the $T2 variable and displays it at the command line.
PS C:\> 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

The third command compares the job triggers in the $t1 and $t2 variables. It uses the Get-Member cmdlet to get the properties of the job trigger in the $t1 variable. It pipes the properties to the ForEach-Object cmdlet, which compares each property to the properties of the job trigger in the $t2 variable by name. The command then pipes the differing properties to the Format-List cmdlet, which displays them in a list.The output indicates that, although the job triggers appear to be the same, the HelpFiles job trigger includes a random delay of three (3) minutes.
PS C:\> $T1 | Get-Member -Type Property | ForEach-Object { Compare-Object $T1 $T2 -Property $_.Name}
RandomDelay                                                 SideIndicator
-----------                                                 -------------
00:00:00                                                    =>
00:03:00                                                    <=

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á trigger úlohy zadané naplánované úlohy.

Pokud chcete získat identifikační počet naplánovaných úloh v místním nebo vzdáleném počítači, použijte rutinu Get-ScheduledJob.

Type:Int32
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Určuje naplánovanou úlohu. Zadejte proměnnou, která obsahuje 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ředvést na Get-JobTrigger.

Type:ScheduledJobDefinition
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Určuje název naplánované úlohy. Get-JobTrigger získá trigger úlohy zadané naplánované úlohy. Zástupné cardy jsou podporované.

Pokud chcete získat názvy naplánovaných úloh v místním nebo vzdáleném počítači, použijte rutinu Get-ScheduledJob.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TriggerId

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

Type:Int32[]
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Vstupy

ScheduledJobDefinition

Naplánovanou úlohu můžete z Get-ScheduledJob převést na Get-JobTrigger.

Výstupy

ScheduledJobTrigger