Freigeben über

Get-JobTrigger

  • Referenz
Modul:
PSScheduledJob

Ruft die Auftragstrigger geplanter Aufträge ab.

Syntax

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

Beschreibung

Das Get-JobTrigger Cmdlet ruft die Auftragstrigger von geplanten Aufträgen ab. Sie können den Befehl verwenden, um die Auftragstrigger zu untersuchen bzw. um sie an andere Cmdlets weiterzureichen.

Ein Auftragstrigger definiert einen wiederkehrenden Zeitplan oder bedingungen für das Starten eines geplanten Auftrags. Auftragstrigger werden nicht unabhängig voneinander auf dem Datenträger gespeichert, da sie Teil eines geplanten Auftrags sind. Um einen Auftragstrigger abzurufen, geben Sie den geplanten Auftrag an, den der Trigger startet.

Verwenden Sie die Parameter des Get-JobTrigger Cmdlets, um die geplanten Aufträge zu identifizieren. Sie können die geplanten Aufträge anhand ihrer Namen oder Identifikationsnummern identifizieren, oder indem Sie ScheduledJob-Objekte eingeben oder weiterleiten, z. B. diejenigen, die Get-ScheduledJob vom Cmdlet zurückgegeben werden, an Get-JobTrigger.

Get-JobTrigger ist eine Sammlung von Auftragsplanungs-Cmdlets im PSScheduledJob-Modul, das in Windows PowerShell enthalten ist.

Weitere Informationen zu geplanten Aufträgen finden Sie unter den Info-Themen im PSScheduledJob-Modul. Importieren Sie das PSScheduledJob-Modul, und geben Sie dann Folgendes ein: Get-Help about_Scheduled* oder lesen Sie about_Scheduled_Jobs.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Abrufen eines Auftragstriggers durch den geplanten Auftragsnamen

Get-JobTrigger -Name "BackupJob"

Der Befehl verwendet den Parameter Name , um Get-JobTrigger die Auftragstrigger des BackupJob geplanten Auftrags abzurufen.

Beispiel 2: Abrufen eines Auftragstriggers nach ID

Im Beispiel wird der ID-Parameter verwendet Get-JobTrigger , um die Auftragstrigger eines geplanten Auftrags abzurufen.

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

Der erste Befehl verwendet das Get-ScheduledJob Cmdlet, um die geplanten Aufträge auf dem lokalen Computer anzuzeigen. Die Anzeige enthält die IDs der geplanten Aufträge.

Der zweite Befehl verwendet das Get-JobTrigger Cmdlet, um den Auftragstrigger für den Test-HelpFiles Auftrag abzurufen (dessen ID lautet 3).

Beispiel 3: Abrufen von Auftragstriggern durch Das Anfügen eines Auftrags

In diesem Beispiel werden Auftragsauslöser von Aufträgen mit übereinstimmenden Namen angezeigt.

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

Dieser Befehl ruft die Auftragsauslöser aller Aufträge ab, die Backup über oder Archive in ihren Namen verfügen.

Beispiel 4: Abrufen des Auftragstriggers eines Auftrags auf einem Remotecomputer

In diesem Beispiel werden die Trigger eines geplanten Auftrags auf einem Remotecomputer abgerufen.

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

Der Befehl verwendet das Invoke-Command Cmdlet, um einen Befehl auf dem Server01-Computer auszuführen. Es verwendet das Get-ScheduledJob Cmdlet, um den Backup geplanten Auftrag abzurufen, der an das Get-JobTrigger Cmdlet weitergeleitet wird. Er verwendet den TriggerID-Parameter , um nur den zweiten Trigger abzurufen.

Beispiel 5: Abrufen aller Auftragstrigger

In diesem Beispiel werden alle Auftragsauslöser aller geplanten Aufträge auf dem lokalen Computer abgerufen.

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

Der Befehl verwendet die Befehle, um die Get-ScheduledJob geplanten Aufträge auf dem lokalen Computer abzurufen und sie anzuleitungen Get-JobTrigger, wodurch der Auftragstrigger für jeden geplanten Auftrag (falls vorhanden) abgerufen wird.

Um den Namen des geplanten Auftrags zur Anzeige des Auftragstriggers hinzuzufügen, verwendet der Befehl das Feature für berechnete Eigenschaften des Format-Table Cmdlets. Zusätzlich zu den Standardmäßig angezeigten Auftragstriggereigenschaften erstellt der Befehl eine neue ScheduledJob-Eigenschaft , die den Namen des geplanten Auftrags anzeigt.

Beispiel 6: Abrufen der Auftragstriggereigenschaft eines geplanten Auftrags

Dieses Beispiel zeigt verschiedene Methoden zum Anzeigen der JobTrigger-Eigenschaft eines geplanten Auftrags.

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

Der erste Befehl verwendet das Get-ScheduledJob Cmdlet, um den Test-HelpFiles geplanten Auftrag abzurufen. Anschließend wird die Punktmethode (.) verwendet, um die JobTriggers-Eigenschaft des Test-HelpFiles geplanten Auftrags abzurufen.

Der zweite Befehl verwendet das Get-ScheduledJob Cmdlet, um alle geplanten Aufträge auf dem lokalen Computer abzurufen. Es verwendet das ForEach-Object Cmdlet, um den Wert der JobTriggers-Eigenschaft jedes geplanten Auftrags abzurufen.

Die Auftragsauslöser eines geplanten Auftrags werden in der JobTriggers-Eigenschaft des Auftrags gespeichert. Dieses Beispiel zeigt Alternativen zur Verwendung des Get-JobTrigger Cmdlets zum Abrufen von Auftragstriggern. Die Ergebnisse sind identisch mit der Verwendung des Get-JobTrigger Cmdlets, und die Techniken können austauschbar verwendet werden.

Beispiel 7: Vergleichen von Auftragstriggern

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

Der erste Befehl ruft den Auftragsauslöser des ArchiveProjects geplanten Auftrags ab. Mit dem Befehl wird der Auftragstrigger an das Tee-Object Cmdlet weitergeleitet, wodurch der Auftragstrigger in der $t1 Variablen gespeichert und in der Befehlszeile angezeigt wird.

Der zweite Befehl ruft den Auftragsauslöser des Test-HelpFiles geplanten Auftrags ab. Mit dem Befehl wird der Auftragstrigger an das Tee-Object Cmdlet weitergeleitet, wodurch der Auftragstrigger in der $t2 Variablen gespeichert und in der Befehlszeile angezeigt wird.

Der dritte Befehl vergleicht die Auftragstrigger in den $t1 Variablen und $t 2. Es verwendet das Get-Member Cmdlet, um die Eigenschaften des Auftragstriggers in der variablen $t 1 abzurufen. Sie führt die Eigenschaften an das ForEach-Object Cmdlet weiter, wodurch jede Eigenschaft mit den Eigenschaften des Auftragstriggers in der $t2 Variablen anhand des Namens verglichen wird. Der Befehl gibt dann die unterschiedlichen Eigenschaften an das Format-List Cmdlet weiter, wodurch sie in einer Liste angezeigt werden. Die Ausgabe gibt an, dass der Auftragstrigger zwar identisch ist, aber der HelpFiles Auftragstrigger eine zufällige Verzögerung von drei (3) Minuten enthält.

Dieses Beispiel zeigt, wie die Auftragstrigger von zwei geplanten Aufträgen verglichen werden.

Parameter

-Id

Gibt die ID eines geplanten Auftrags an. Get-JobTrigger ruft den Auftragstrigger des angegebenen geplanten Auftrags ab.

Verwenden Sie das Get-ScheduledJob Cmdlet, um die Identifikationsnummer der geplanten Aufträge auf dem lokalen Computer oder einem Remotecomputer abzurufen.

Typ:Int32
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt einen geplanten Auftrag an. Geben Sie eine Variable ein, die ScheduledJob-Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der ScheduledJob-Objekte abruft, z. B. einen Get-ScheduledJob Befehl. Sie können auch ScheduledJob-Objekte an Get-JobTrigger.

Typ:ScheduledJobDefinition
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines geplanten Auftrags an. Get-JobTrigger ruft den Auftragstrigger des angegebenen geplanten Auftrags ab. Platzhalter werden unterstützt.

Verwenden Sie das Get-ScheduledJob Cmdlet, um die Namen der geplanten Aufträge auf dem lokalen Computer oder einem Remotecomputer abzurufen.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TriggerId

Ruft die angegebenen Auftragstrigger ab. Geben Sie die Trigger-ID mindestens eines Auftragstriggers eines geplanten Auftrags ein. Verwenden Sie diesen Parameter, wenn der geplante Auftrag, der durch die Parameter Name, ID oder InputObject angegeben wird, mehrere Auftragsauslöser aufweist.

Typ:Int32[]
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

ScheduledJobDefinition

Sie können einen geplanten Auftrag an dieses Cmdlet weiterleiten.

Ausgaben

ScheduledJobTrigger

Dieses Cmdlet gibt den Trigger des geplanten Auftrags zurück.