Delen via

Get-JobTrigger

  • Referentie
Module:
PSScheduledJob

Hiermee haalt u de taaktriggers van geplande taken op.

Syntaxis

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

Description

De Get-JobTrigger cmdlet haalt de taaktriggers van geplande taken op. U kunt deze opdracht gebruiken om de taaktriggers te onderzoeken of om de taaktriggers door te geven aan andere cmdlets.

Een taaktrigger definieert een terugkerend schema of voorwaarden voor het starten van een geplande taak. Taaktriggers worden niet onafhankelijk op schijf opgeslagen; ze maken deel uit van een geplande taak. Als u een taaktrigger wilt ophalen, geeft u de geplande taak op die door de trigger wordt gestart.

Gebruik de parameters van de Get-JobTrigger cmdlet om de geplande taken te identificeren. U kunt de geplande taken identificeren op basis van hun namen of identificatienummers, of door ScheduledJob-objecten, zoals objecten die worden geretourneerd door de Get-ScheduledJob-cmdlet, in te voeren of door te leiden naar Get-JobTrigger-.

Get-JobTrigger is een verzameling cmdlets voor taakplanning in de PSScheduledJob-module die is opgenomen in Windows PowerShell.

Zie de onderwerpen Over geplande taken in de PSScheduledJob-module voor meer informatie over geplande taken. Importeer de PSScheduledJob-module en typ vervolgens: Get-Help about_Scheduled* of zie about_Scheduled_Jobs.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

Voorbeelden

Voorbeeld 1: Een taaktrigger ophalen op basis van de geplande taaknaam

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

De opdracht gebruikt de parameter Name van Get-JobTrigger- om de taaktriggers van de geplande BackupJob-taak op te halen.

Voorbeeld 2: Een taaktrigger ophalen op 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

In het voorbeeld wordt de -id parameter van Get-JobTrigger- gebruikt om de taaktriggers van een geplande taak op te halen.

Voorbeeld 3: Taaktriggers ophalen door een taak te doorsluizen

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

Met deze opdracht worden de taaktriggers van alle taken met Back-up of Archief in hun namen opgeslagen.

Voorbeeld 4: De taaktrigger van een taak op een externe computer ophalen

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

Met deze opdracht krijgt u een van de twee taaktriggers van een geplande taak op een externe computer.

De opdracht gebruikt de Invoke-Command cmdlet om een opdracht uit te voeren op de Server01-computer. De cmdlet Get-ScheduledJob wordt gebruikt om de geplande back-uptaak op te halen, die wordt uitgevoerd op de Get-JobTrigger cmdlet. Hierbij wordt de parameter TriggerID gebruikt om alleen de tweede trigger op te halen.

Voorbeeld 5: Alle taaktriggers ophalen

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

Met deze opdracht worden alle taaktriggers van alle geplande taken op de lokale computer weergegeven.

De opdracht gebruikt de Get-ScheduledJob om de geplande taken op de lokale computer op te halen en deze door te geven aan Get-JobTrigger, waarmee de taaktrigger van elke geplande taak (indien van toepassing) wordt geactiveerd.

Als u de naam van de geplande taak wilt toevoegen aan de weergave van de taaktrigger, gebruikt de opdracht de functie voor berekende eigenschappen van de Format-Table-cmdlet. Naast de eigenschappen van de taaktrigger die standaard worden weergegeven, maakt de opdracht een nieuwe eigenschap ScheduledJob die de naam van de geplande taak weergeeft.

Voorbeeld 6: De eigenschap taaktrigger van een geplande taak ophalen

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}

De taaktriggers van een geplande taak worden opgeslagen in de eigenschap JobTriggers van de taak. In dit voorbeeld ziet u alternatieven voor het gebruik van de Get-JobTrigger cmdlet om taaktriggers op te halen. De resultaten zijn identiek aan het gebruik van de Get-JobTrigger cmdlet en de technieken kunnen door elkaar worden gebruikt.

Voorbeeld 7: Taaktriggers vergelijken

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

In dit voorbeeld ziet u hoe u de taaktriggers van twee geplande taken vergelijkt.

Parameters

-Id

Hiermee geeft u het identificatienummer van een geplande taak. Get-JobTrigger de taaktrigger van de opgegeven geplande taak ophaalt.

Gebruik de Get-ScheduledJob-cmdlet om het identificatienummer van geplande taken op de lokale computer of een externe computer op te halen.

Type:Int32
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u een geplande taak. Voer een variabele in die ScheduledJob objecten bevat of typ een opdracht of expressie die ScheduledJob objecten, zoals een Get-ScheduledJob opdracht. U kunt ook ScheduledJob-objecten doorsluisen naar Get-JobTrigger.

Type:ScheduledJobDefinition
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een geplande taak. Get-JobTrigger de taaktrigger van de opgegeven geplande taak ophaalt. Jokertekens worden ondersteund.

Gebruik de Get-ScheduledJob-cmdlet om de namen van geplande taken op de lokale computer of een externe computer op te halen.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TriggerId

Hiermee haalt u de opgegeven taaktriggers op. Voer de trigger-id's in van een of meer taaktriggers van een geplande taak. Gebruik deze parameter wanneer de geplande taak die is opgegeven door de Name, IDof InputObject parameters meerdere taaktriggers heeft.

Type:Int32[]
Position:1
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

ScheduledJobDefinition

U kunt een geplande taak van Get-ScheduledJob naar Get-JobTrigger.

Uitvoerwaarden

ScheduledJobTrigger