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[]>
   [-Name] <String[]>
   [<CommonParameters>]
Add-JobTrigger
   [-Trigger] <ScheduledJobTrigger[]>
   [-Id] <Int32[]>
   [<CommonParameters>]

Description

Met de cmdlet Add-JobTrigger 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 van Add-JobTrigger om de taaktriggers te identificeren die moeten worden toegevoegd. Gebruik de parameters Name, IDof InputObject parameters van Add-JobTrigger om 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 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 toevoegen aan een geplande taak

PS C:\> $Daily = New-JobTrigger -Daily -At 3AMPS
PS C:\> Add-JobTrigger -Trigger $Daily -Name "TestJob"

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

De eerste opdracht maakt gebruik van 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 maakt gebruik van de cmdlet Add-JobTrigger om de taaktrigger toe te voegen aan de $Startup variabele aan de geplande TestJob-taak.

Voorbeeld 2: Een taaktrigger toevoegen aan verschillende geplande taken

PS C:\> 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 om alle geplande taken op de computer op te halen. Er wordt een pijplijnoperator (|) gebruikt om de taken te verzenden naar de Add-JobTrigger cmdlet, waarmee 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

PS C:\> $T = Get-JobTrigger -Name "BackupArchives"
PS C:\> 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 maakt gebruik van 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 die ScheduledJob objecten, 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 die taaktriggers of een variabele bevat die ScheduledJobTrigger objecten bevat, of typ een opdracht of expressie die ScheduledJobTrigger objecten, 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

Microsoft.PowerShell.ScheduledJob.ScheduledJobTrigger, Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

U kunt taaktriggers of geplande taken doorsluisen naar Add-JobTrigger.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.