Delen via

Disable-JobTrigger

  • Referentie
Module:
PSScheduledJob

Hiermee worden de taaktriggers van geplande taken uitgeschakeld.

Syntaxis

Disable-JobTrigger
       [-InputObject] <ScheduledJobTrigger[]>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Met de Disable-JobTrigger cmdlet worden de taaktriggers van geplande taken tijdelijk uitgeschakeld. Als u uitschakelt, blijven alle eigenschappen van de taaktrigger behouden, maar voorkomt u dat de taaktrigger de geplande taak start.

Als u deze cmdlet wilt gebruiken, gebruikt u de Get-JobTrigger-cmdlet om de taaktriggers op te halen. Sluis vervolgens de taaktriggers door naar Disable-JobTrigger of gebruik de parameter InputObject.

Als u een taaktrigger wilt uitschakelen, stelt de Disable-JobTrigger cmdlet de eigenschap Ingeschakeld van de taaktrigger in op $False. Als u de taaktrigger opnieuw wilt inschakelen, gebruikt u de cmdlet Enable-JobTrigger, waarmee de eigenschap Ingeschakeld van de taaktrigger wordt ingesteld op $True. Als u een taaktrigger uitschakelt, wordt de geplande taak niet uitgeschakeld, zoals door de Disable-ScheduledJob cmdlet, maar als u alle taaktriggers uitschakelt, is het effect hetzelfde als het uitschakelen van de geplande taak.

Als u een geplande taak uitschakelt of alle taaktriggers van een geplande taak uitschakelt, kunt u de taak nog steeds starten met behulp van de Start-Job-cmdlet of de uitgeschakelde geplande taak als sjabloon gebruiken.

Disable-ScheduledJob 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 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 uitschakelen

PS C:\> Get-JobTrigger -Name "Backup-Archives" -TriggerID 1 | Disable-JobTrigger

Met deze opdracht wordt de eerste trigger (ID=1) van de Backup-Archives geplande taak op de lokale computer uitgeschakeld.

De opdracht gebruikt de Get-JobTrigger cmdlet om de taaktrigger op te halen. Een pijplijnoperator verzendt de taaktrigger naar de Disable-JobTrigger cmdlet, waardoor deze wordt uitgeschakeld.

Voorbeeld 2: Alle taaktriggers uitschakelen

The first command uses the Get-ScheduledJob cmdlet to get the Backup-Archives and Inventory scheduled jobs. A pipeline operator (|) sends the scheduled jobs to the Get-JobTrigger cmdlet, which gets all job triggers of the scheduled jobs. Another pipeline operator sends the job triggers to the **Disable-JobTrigger** cmdlet, which disables them.The first command uses the **Get-ScheduledJob** cmdlet to get the jobs, because its *Name* parameter takes multiple names.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger

The second command displays the results. The command repeats the **Get-ScheduledJob** and **Get-JobTrigger** command. A pipeline operator sends the job triggers to the Format-Table cmdlet, which displays the job triggers in a table. The **Format-Table** command adds a JobName property that displays the value of the Name property of the scheduled job in the JobDefinition property of the job trigger object.
PS C:\> Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Format-Table -Property ID, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}} -AutoSize
Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
1  Weekly    9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
2  Daily     9/29/2011 1:00:00 AM              False   Backup-Archive
1  Weekly    10/20/2011 11:00:00 PM {Friday}   False   Inventory
1  Weekly    11/2/2011 2:00:00 PM   {Monday}   False   Inventory

Met deze opdrachten worden alle taaktriggers voor twee geplande taken uitgeschakeld en worden de resultaten weergegeven.

Voorbeeld 3: Taaktrigger uitschakelen van een geplande taak op een externe computer

PS C:\> Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "Daily"} | Disable-JobTrigger}

Met deze opdracht worden de dagelijkse taaktriggers uitgeschakeld voor de geplande taak DeployPackage op de externe server01-computer.

De opdracht gebruikt de Invoke-Command cmdlet om de opdrachten uit te voeren op de Server01-computer. De externe opdracht maakt gebruik van de Get-JobTrigger cmdlet om de taaktriggers van de geplande taak DeployPackage op te halen. Een pijplijnoperator verzendt de taaktriggers naar de Where-Object cmdlet, die alleen dagelijkse taaktriggers retourneert. Een pijplijnoperator verzendt de dagelijkse taaktriggers naar de Disable-JobTrigger cmdlet, waardoor ze worden uitgeschakeld.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u de taaktrigger moet worden uitgeschakeld. Voer een variabele in die ScheduledJobTrigger objecten bevat of typ een opdracht of expressie die ScheduledJobTrigger objecten, zoals een Get-JobTrigger opdracht. U kunt ook een ScheduledJobTrigger--object doorsluisen naar Disable-JobTrigger-.

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

-PassThru

Retourneert een object dat het item aangeeft waarmee u werkt. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

ScheduledJobTrigger

U kunt taaktriggers doorsluisen naar Disable-JobTrigger.

Uitvoerwaarden

None

Met deze cmdlet wordt geen uitvoer gegenereerd.

Notities

  • Disable-JobTrigger- genereert geen fouten of waarschuwingen als u een taaktrigger uitschakelt die al is uitgeschakeld.