Get-JobTrigger

Referentie

Module:: PSScheduledJob

Hiermee haalt u de taaktriggers van geplande taken op.

Syntax

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

Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Id] <Int32>
   [<CommonParameters>]

Get-JobTrigger
   [[-TriggerId] <Int32[]>]
   [-Name] <String>
   [<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 objecten voor geplande taken in te voeren of door te geven, zoals objecten die door de Get-ScheduledJob cmdlet worden geretourneerd, naar Get-JobTrigger.

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

Zie de onderwerpen Over 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

Get-JobTrigger -Name "BackupJob"

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

Voorbeeld 2: Een taaktrigger ophalen op basis van id

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

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

De eerste opdracht gebruikt de Get-ScheduledJob cmdlet om de geplande taken op de lokale computer weer te geven. De weergave bevat de id's van de geplande taken.

De tweede opdracht gebruikt de Get-JobTrigger cmdlet om de taaktrigger op te halen voor de taak (waarvan de Test-HelpFiles id is 3).

Voorbeeld 3: Taaktriggers ophalen door een taak te pipen

In dit voorbeeld worden taaktriggers van taken met overeenkomende namen weergegeven.

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

Met deze opdracht worden de taaktriggers van alle taken met Backup of Archive in hun naam getriggerd.

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

In dit voorbeeld worden de triggers van een geplande taak op een externe computer weergegeven.

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

De opdracht gebruikt de Invoke-Command cmdlet om een opdracht uit te voeren op de Server01-computer. De cmdlet gebruikt de Get-ScheduledJob cmdlet om de Backup geplande taak op te halen, die wordt pijpen naar de Get-JobTrigger cmdlet. De parameter TriggerID wordt gebruikt om alleen de tweede trigger op te halen.

Voorbeeld 5: Alle taaktriggers ophalen

In dit voorbeeld worden alle taaktriggers van alle geplande taken op de lokale computer weergegeven.

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

De opdracht maakt gebruik van de Get-ScheduledJob opdracht om de geplande taken op de lokale computer op te halen en deze door te voeren, Get-JobTriggerwaardoor de taaktrigger van elke geplande taak (indien aanwezig) wordt ontvangen.

Als u de naam van de geplande taak wilt toevoegen aan de weergave van de taaktrigger, gebruikt de opdracht de functie voor de berekende eigenschap 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

In dit voorbeeld ziet u verschillende methoden om de eigenschap JobTrigger van een geplande taak weer te geven.

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

De eerste opdracht maakt gebruik van de Get-ScheduledJob cmdlet om de Test-HelpFiles geplande taak op te halen. Vervolgens wordt de puntmethode (.) gebruikt om de eigenschap JobTriggers van de Test-HelpFiles geplande taak op te halen.

Met de tweede opdracht wordt de Get-ScheduledJob cmdlet gebruikt om alle geplande taken op de lokale computer op te halen. De cmdlet gebruikt de ForEach-Object cmdlet om de waarde op te halen van de eigenschap JobTriggers van elke geplande taak.

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

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

De eerste opdracht haalt de taaktrigger van de ArchiveProjects geplande taak op. Met de opdracht wordt de taaktrigger naar de Tee-Object cmdlet uitgevoerd, waarmee de taaktrigger in de $t1 variabele wordt opgeslagen en op de opdrachtregel wordt weergegeven.

De tweede opdracht haalt de taaktrigger van de Test-HelpFiles geplande taak op. Met de opdracht wordt de taaktrigger naar de Tee-Object cmdlet uitgevoerd, waarmee de taaktrigger in de $t2 variabele wordt opgeslagen en op de opdrachtregel wordt weergegeven.

Met de derde opdracht worden de taaktriggers in de $t1 variabelen en $t 2 vergeleken. De cmdlet gebruikt de Get-Member cmdlet om de eigenschappen van de taaktrigger op te halen in de variabele $t 1. Het pijpt de eigenschappen uit naar de ForEach-Object cmdlet, die elke eigenschap vergelijkt met de eigenschappen van de taaktrigger in de $t2 variabele op naam. De opdracht geeft vervolgens de verschillende eigenschappen door aan de Format-List cmdlet, die deze weergeeft in een lijst. De uitvoer geeft aan dat, hoewel de taaktriggers hetzelfde lijken te zijn, de HelpFiles taaktrigger een willekeurige vertraging van drie (3) minuten bevat.

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 haalt de taaktrigger van de opgegeven geplande taak op.

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
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

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

-Name

Hiermee geeft u de naam van een geplande taak. Get-JobTrigger haalt de taaktrigger van de opgegeven geplande taak op. 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
Accept pipeline input:	False
Accept wildcard characters:	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 parameters Naam, ID of InputObject meerdere taaktriggers heeft.

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

Invoerwaarden

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

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

Uitvoerwaarden

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger