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 ScheduledJob in of door te voeren, zoals objecten die door de Get-ScheduledJob cmdlet worden geretourneerd, in te voeren of door te geven.Get-JobTrigger

Get-JobTrigger is een van 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: 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 parameter Name om Get-JobTrigger de taaktriggers van de BackupJob geplande taak op te halen.

Voorbeeld 2: Een taaktrigger ophalen op 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 voor de taak op te halen (waarvan de Test-HelpFiles id is3).

Voorbeeld 3: Taaktriggers ophalen door een taak te doorsluizen

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 opgeslagen.

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. Hierbij wordt de Get-ScheduledJob cmdlet gebruikt om de Backup geplande taak op te halen, die door de cmdlet wordt Get-JobTrigger uitgevoerd. 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 gebruikt de Get-ScheduledJob opdracht om de geplande taken op de lokale computer op te halen en deze door te voeren naar Get-JobTrigger, waardoor de taaktrigger van elke geplande taak (indien van toepassing).

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

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 gebruikt 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.

De tweede opdracht gebruikt de Get-ScheduledJob cmdlet 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. De opdracht geeft de taaktrigger door aan de Tee-Object cmdlet, waarmee de taaktrigger in de $t1 variabele wordt opgeslagen en op de opdrachtregel wordt weergegeven.

Met de tweede opdracht wordt de taaktrigger van de Test-HelpFiles geplande taak ophaalt. De opdracht geeft de taaktrigger door aan de Tee-Object cmdlet, 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. Hierbij wordt de Get-Member cmdlet gebruikt om de eigenschappen van de taaktrigger op te halen in de variabele $t 1. Het pijpt de eigenschappen naar de ForEach-Object cmdlet, die elke eigenschap vergelijkt met de eigenschappen van de taaktrigger in de $t2 variabele op naam. Met de opdracht worden vervolgens de verschillende eigenschappen voor de Format-List cmdlet uitgevoerd, waarmee deze in een lijst worden weergegeven. 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
Required:True
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:ScheduledJobDefinition
Position:0
Default value:None
Required:True
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
Required:True
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 Name, ID of InputObject meerdere taaktriggers heeft.

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

Invoerwaarden

ScheduledJobDefinition

U kunt een geplande taak doorsluisen naar deze cmdlet.

Uitvoerwaarden

ScheduledJobTrigger

Met deze cmdlet wordt de trigger van de geplande taak geretourneerd.