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 InputObject parameter.

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

In dit voorbeeld wordt de eerste trigger van een geplande taak op de lokale computer uitgeschakeld.

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

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

Get-ScheduledJob -Name "Backup-Archives,Inventory" | Get-JobTrigger | Disable-JobTrigger
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

De eerste opdracht maakt gebruik van de Get-ScheduledJob cmdlet om de geplande taken Backup-Archives en Inventaris op te halen. Een pijplijnoperator (|) verzendt de geplande taken naar de Get-JobTrigger-cmdlet, waarmee alle taaktriggers van de geplande taken worden ophaalt. Een andere pijplijnoperator verzendt de taaktriggers naar de Disable-JobTrigger cmdlet, waardoor ze worden uitgeschakeld. De eerste opdracht gebruikt de cmdlet Get-ScheduledJob om de taken op te halen, omdat de parameter Name meerdere namen heeft.

Met de tweede opdracht worden de resultaten weergegeven. De opdracht herhaalt de Get-ScheduledJob en Get-JobTrigger opdracht. Een pijplijnoperator verzendt de taaktriggers naar de Format-Table-cmdlet, waarin de taaktriggers in een tabel worden weergegeven. Met de opdracht Format-Table wordt een JobName-eigenschap toegevoegd waarmee de waarde van de eigenschap Naam van de geplande taak wordt weergegeven in de eigenschap JobDefinition van het taaktriggerobject.

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

In dit voorbeeld worden de dagelijkse taaktriggers voor een geplande taak op een externe computer uitgeschakeld

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

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:None
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 een taaktrigger doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

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