Udostępnij za pośrednictwem

Get-JobTrigger

  • Odwołanie
Moduł:
PSScheduledJob

Pobiera wyzwalacze zadań zaplanowanych.

Składnia

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

Opis

Polecenie cmdlet Get-JobTrigger 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 polecenia cmdlet Get-JobTrigger, 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 polecenie cmdlet Get-ScheduledJob, aby Get-JobTrigger.

Get-JobTrigger jest jedną z kolekcji poleceń cmdlet planowania zadań w module PSScheduledJob, który jest zawarty 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

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

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

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

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

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

Przykład 3. Pobieranie wyzwalaczy zadania przez potokowanie zadania

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

To polecenie pobiera wyzwalacze zadań wszystkich zadań z kopią zapasową lub Archiwum w nazwach.

Przykład 4. Pobieranie wyzwalacza zadania na komputerze zdalnym

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

To polecenie pobiera jeden z dwóch wyzwalaczy zaplanowanego zadania na komputerze zdalnym.

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

Przykład 5. Pobieranie wszystkich wyzwalaczy zadania

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

To polecenie pobiera wszystkie wyzwalacze zadań wszystkich zaplanowanych zadań na komputerze lokalnym.

Polecenie używa Get-ScheduledJob, aby pobrać zaplanowane zadania na komputerze lokalnym i potokuje je do Get-JobTrigger, który 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 polecenia cmdlet Format-Table. 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

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}

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

Przykład 7. Porównanie wyzwalaczy zadań

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

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 polecenia cmdlet Get-ScheduledJob.

Typ:Int32
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

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

Typ:ScheduledJobDefinition
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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 polecenia cmdlet Get-ScheduledJob.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 parametr Name, IDlub InputObject parametrów ma wiele wyzwalaczy zadania.

Typ:Int32[]
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

ScheduledJobDefinition

Zaplanowane zadanie można potokować z Get-ScheduledJob do Get-JobTrigger.

Dane wyjściowe

ScheduledJobTrigger