Get-JobTrigger

  • Odwołanie
Moduł:
PSScheduledJob

Pobiera wyzwalacze zadań zaplanowanych.

Składnia

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

Opis

Polecenie Get-JobTrigger cmdlet pobiera wyzwalacze zadań zaplanowanych. Tego polecenia można użyć do sprawdzenia wyzwalaczy zadania lub potoku wyzwalaczy zadania do innych poleceń cmdlet.

Wyzwalacz zadania definiuje cykliczny harmonogram lub warunki uruchamiania zaplanowanego zadania. Wyzwalacze zadań nie są zapisywane na dysku niezależnie; są częścią zaplanowanego zadania. Aby uzyskać wyzwalacz zadania, określ zaplanowane zadanie uruchamiane przez wyzwalacz.

Użyj parametrów Get-JobTrigger polecenia cmdlet, aby zidentyfikować zaplanowane zadania. Zaplanowane zadania można zidentyfikować według ich nazw lub numerów identyfikacyjnych albo wprowadzając lub potokując obiekty ScheduledJob , takie jak te, które są zwracane przez Get-ScheduledJob polecenie cmdlet, na Get-JobTrigger.

Get-JobTrigger jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który znajduje się w programie Windows PowerShell.

Aby uzyskać więcej informacji na temat zaplanowanych zadań, zobacz temat Informacje w module PSScheduledJob. Zaimportuj moduł PSScheduledJob, a następnie wpisz: Get-Help about_Scheduled* lub zobacz about_Scheduled_Jobs.

To polecenie cmdlet zostało wprowadzone w programie Windows PowerShell 3.0.

Przykłady

Przykład 1. Pobieranie wyzwalacza zadania według nazwy zaplanowanego zadania

Get-JobTrigger -Name "BackupJob"

Polecenie używa parametru Name polecenia Get-JobTrigger , aby pobrać wyzwalacze zadania zaplanowanego BackupJob .

Przykład 2. Uzyskiwanie wyzwalacza zadania według identyfikatora

W przykładzie użyto parametru Get-JobTrigger ID polecenia , aby pobrać wyzwalacze zadania zaplanowanego.

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

Pierwsze polecenie używa Get-ScheduledJob polecenia cmdlet do wyświetlania zaplanowanych zadań na komputerze lokalnym. Ekran zawiera identyfikatory zaplanowanych zadań.

Drugie polecenie używa Get-JobTrigger polecenia cmdlet , aby uzyskać wyzwalacz zadania dla Test-HelpFiles zadania (którego identyfikator to 3).

Przykład 3. Pobieranie wyzwalaczy zadania przez potokowanie zadania

W tym przykładzie są wyświetlane wyzwalacze zadań, które mają pasujące nazwy.

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

To polecenie pobiera wyzwalacze zadania wszystkich zadań, które mają Backup nazwy lub Archive w ich nazwach.

Przykład 4. Pobieranie wyzwalacza zadania na komputerze zdalnym

Ten przykład pobiera wyzwalacze zaplanowanego zadania na komputerze zdalnym.

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

Polecenie używa Invoke-Command polecenia cmdlet do uruchomienia polecenia na komputerze Server01. Używa Get-ScheduledJob polecenia cmdlet do pobrania zaplanowanego Backup zadania, które potokuje do Get-JobTrigger polecenia cmdlet. Używa parametru TriggerID , aby uzyskać tylko drugi wyzwalacz.

Przykład 5. Pobieranie wszystkich wyzwalaczy zadania

Ten przykład pobiera wszystkie wyzwalacze zadań wszystkich zaplanowanych zadań na komputerze lokalnym.

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

Polecenie używa Get-ScheduledJob polecenia , aby pobrać zaplanowane zadania na komputerze lokalnym i potokować je do Get-JobTrigger, co pobiera wyzwalacz zadania każdego zaplanowanego zadania (jeśli istnieje).

Aby dodać nazwę zaplanowanego zadania do wyświetlania wyzwalacza zadania, polecenie używa funkcji właściwości obliczeniowej Format-Table polecenia cmdlet. Oprócz właściwości wyzwalacza zadania, które są wyświetlane domyślnie, polecenie tworzy nową właściwość ScheduledJob , która wyświetla nazwę zaplanowanego zadania.

Przykład 6. Pobieranie właściwości wyzwalacza zadania zaplanowanego zadania

W tym przykładzie przedstawiono różne metody wyświetlania właściwości JobTrigger zaplanowanego zadania.

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

Pierwsze polecenie używa Get-ScheduledJob polecenia cmdlet do pobrania zaplanowanego Test-HelpFiles zadania. Następnie używa metody dot (.), aby uzyskać właściwość JobTriggers zaplanowanego Test-HelpFiles zadania.

Drugie polecenie używa Get-ScheduledJob polecenia cmdlet , aby pobrać wszystkie zaplanowane zadania na komputerze lokalnym. Używa ForEach-Object polecenia cmdlet , aby uzyskać wartość właściwości JobTriggers każdego zaplanowanego zadania.

Wyzwalacze zadania zaplanowanego są przechowywane we właściwości JobTriggers zadania. W tym przykładzie Get-JobTrigger przedstawiono alternatywy użycia polecenia cmdlet w celu pobrania wyzwalaczy zadania. Wyniki są identyczne z użyciem Get-JobTrigger polecenia cmdlet, a techniki mogą być używane zamiennie.

Przykład 7. Porównanie wyzwalaczy zadań

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                                                    <=

Pierwsze polecenie pobiera wyzwalacz zadania zaplanowanego ArchiveProjects zadania. Polecenie potokuje wyzwalacz zadania do Tee-Object polecenia cmdlet, które zapisuje wyzwalacz zadania w zmiennej $t1 i wyświetla go w wierszu polecenia.

Drugie polecenie pobiera wyzwalacz zadania zaplanowanego Test-HelpFiles zadania. Polecenie potokuje wyzwalacz zadania do Tee-Object polecenia cmdlet, które zapisuje wyzwalacz zadania w zmiennej $t2 i wyświetla go w wierszu polecenia.

Trzecie polecenie porównuje wyzwalacze zadania w $t1 zmiennych i $t 2. Używa Get-Member polecenia cmdlet , aby uzyskać właściwości wyzwalacza zadania w zmiennej $t 1. Potokuje właściwości polecenia ForEach-Object cmdlet, które porównuje każdą właściwość z właściwościami wyzwalacza zadania w zmiennej $t2 według nazwy. Następnie polecenie potokuje różne właściwości polecenia Format-List cmdlet, które wyświetla je na liście. Dane wyjściowe wskazują, że chociaż wyzwalacze zadania wydają się być takie same, HelpFiles wyzwalacz zadania zawiera losowe opóźnienie trzech (3) minut.

W tym przykładzie pokazano, jak porównać wyzwalacze zadań z dwoma zaplanowanymi zadaniami.

Parametry

-Id

Określa numer identyfikacyjny zaplanowanego zadania. Get-JobTrigger pobiera wyzwalacz zadania określonego zaplanowanego zadania.

Aby uzyskać numer identyfikacyjny zaplanowanych zadań na komputerze lokalnym lub komputerze zdalnym, użyj Get-ScheduledJob polecenia cmdlet .

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

-InputObject

Określa zaplanowane zadanie. Wprowadź zmienną zawierającą obiekty ScheduledJob lub wpisz polecenie lub wyrażenie, które pobiera obiekty ScheduledJob, takie jak Get-ScheduledJob polecenie. Można również potokować obiekty ScheduledJob do Get-JobTrigger.

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

-Name

Określa nazwę zaplanowanego zadania. Get-JobTrigger pobiera wyzwalacz zadania określonego zaplanowanego zadania. Obsługiwane są symbole wieloznaczne.

Aby uzyskać nazwy zaplanowanych zadań na komputerze lokalnym lub komputerze zdalnym, użyj Get-ScheduledJob polecenia cmdlet .

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

-TriggerId

Pobiera określone wyzwalacze zadania. Wprowadź identyfikatory wyzwalaczy co najmniej jednego wyzwalacza zaplanowanego zadania. Użyj tego parametru, gdy zaplanowane zadanie określone przez parametry Name, ID lub InputObject ma wiele wyzwalaczy zadania.

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

Dane wejściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Możesz przekazać zaplanowane zadanie do tego polecenia cmdlet.

Dane wyjściowe

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger

To polecenie cmdlet zwraca wyzwalacz zaplanowanego zadania.