Delen via

Add-JobTrigger

  • Referentie
Module:
PSScheduledJob

Hiermee worden taaktriggers toegevoegd aan geplande taken.

Syntaxis

Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-InputObject] <ScheduledJobDefinition[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Name] <String[]>
   [<CommonParameters>]

Description

Met de Add-JobTrigger cmdlet worden taaktriggers toegevoegd aan geplande taken. U kunt deze gebruiken om meerdere triggers toe te voegen aan meerdere geplande taken.

Een taaktrigger start een geplande taak volgens een eenmalige of terugkerende planning of wanneer een gebeurtenis plaatsvindt.

Gebruik de parameter Trigger om Add-JobTrigger de taaktriggers te identificeren die u wilt toevoegen. Gebruik de parameters Name, ID of InputObject om Add-JobTrigger de geplande taak te identificeren waaraan de triggers worden toegevoegd.

Als u taaktriggers wilt maken voor de waarde van de parameter Trigger , gebruikt u de New-JobTrigger cmdlet of gebruikt u een hash-tabel om de taaktrigger op te geven.

Add-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 toevoegen aan een geplande taak

$Daily = New-JobTrigger -Daily -At 3AMPS
Add-JobTrigger -Trigger $Daily -Name "TestJob"

Met deze opdrachten wordt de taaktrigger Dagelijks toegevoegd aan de geplande TestJob-taak.

De eerste opdracht gebruikt de New-JobTrigger cmdlet om een taaktrigger te maken die elke dag om 3:00 uur een geplande taak start. Met de opdracht wordt de taaktrigger opgeslagen in de $Daily variabele.

De tweede opdracht gebruikt de Add-JobTrigger cmdlet om de taaktrigger in de $Startup variabele toe te voegen aan de geplande TestJob-taak.

Voorbeeld 2: Een taaktrigger toevoegen aan verschillende geplande taken

Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

Met deze opdracht wordt een AtStartup-taaktrigger toegevoegd aan alle geplande taken op de lokale computer. Het gebruikt de Get-ScheduledJob opdracht om alle geplande taken op de computer op te halen. Er wordt een pijplijnoperator (|) gebruikt om de taken naar de Add-JobTrigger cmdlet te verzenden, waardoor de taaktrigger wordt toegevoegd aan elk van de geplande taken. De waarde van de parameter Trigger is een New-JobTrigger opdracht waarmee de AtStartup-taaktrigger wordt gemaakt.

Voorbeeld 3: Een taaktrigger kopiëren

$T = Get-JobTrigger -Name "BackupArchives"
Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

Met deze opdrachten kopieert u de taaktrigger uit de geplande back-uptaak BackupArchives en voegt u deze toe aan de geplande taken TestBackup en BackupLogs.

De eerste opdracht maakt gebruik van de Get-JobTrigger cmdlet om de taaktrigger van de geplande taak BackupArchives op te halen. Met de opdracht wordt de trigger opgeslagen in de $t variabele.

De tweede opdracht gebruikt de Add-JobTrigger cmdlet om de taaktrigger toe te voegen in $t aan de geplande taken TestBackup en BackupLogs.

Parameters

-Id

Hiermee geeft u de identificatienummers van de geplande taken op. Add-JobTrigger voegt de taaktrigger toe aan de opgegeven geplande taken.

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 de geplande taken op. 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 Add-JobTrigger.

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

-Name

Hiermee geeft u de namen van de geplande taken. Add-JobTrigger voegt de taaktriggers toe aan de opgegeven geplande taken. 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

-Trigger

Hiermee geeft u de taaktriggers die moeten worden toegevoegd. Voer een hashtabel in waarmee taaktriggers of een variabele worden opgegeven die ScheduledJobTrigger-objecten bevat, of typ een opdracht of expressie waarmee ScheduledJobTrigger-objecten worden opgehaald, zoals een Get-JobTrigger opdracht. U kunt ook ScheduledJobTrigger-objecten doorsluisen naar Add-JobTrigger.

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

Invoerwaarden

ScheduledJobTrigger

U kunt een taaktrigger doorsluisen naar deze cmdlet.

ScheduledJobDefinition

U kunt een geplande taak doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.