Delen via

Disable-ScheduledJob

  • Referentie
Module:
PSScheduledJob

Hiermee schakelt u een geplande taak uit.

Syntaxis

Disable-ScheduledJob
       [-InputObject] <ScheduledJobDefinition>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-ScheduledJob
       [-Id] <Int32>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-ScheduledJob
       [-Name] <String>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Met de Disable-ScheduledJob cmdlet worden geplande taken tijdelijk uitgeschakeld. Als u alle taakeigenschappen uitschakelt, blijven alle taakeigenschappen behouden en worden de taaktriggers niet uitgeschakeld, maar voorkomt u dat de geplande taken automatisch worden gestart wanneer ze worden geactiveerd. U kunt een uitgeschakelde geplande taak starten met behulp van de Start-Job cmdlet of een uitgeschakelde geplande taak gebruiken als sjabloon.

Als u een geplande taak wilt uitschakelen, stelt de Disable-ScheduledJob cmdlet de eigenschap Ingeschakeld van de geplande taak in op False. Gebruik de Enable-ScheduledJob cmdlet om de geplande taak opnieuw in te schakelen.

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: Get-Help about_Scheduled* of zie about_Scheduled_Jobs.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

Voorbeelden

Voorbeeld 1: Een geplande taak uitschakelen

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

Disable-ScheduledJob -ID 2 -PassThru

Met deze opdracht wordt de geplande taak uitgeschakeld met id 2 op de lokale computer.

Voorbeeld 2: Alle geplande taken uitschakelen

In dit voorbeeld worden alle geplande taken op de lokale computer uitgeschakeld.

Get-ScheduledJob | Disable-ScheduledJob -PassThru

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        False
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    False
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     False
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       False

De Get-ScheduledJob cmdlet haalt alle geplande taken op en pijpt deze naar de Disable-ScheduledJob cmdlet om ze uit te schakelen.

U kunt geplande taak opnieuw inschakelen met behulp van de Enable-ScheduledJob cmdlet en een uitgeschakelde geplande taak uitvoeren met behulp van de Start-Job cmdlet.

Disable-ScheduledJob genereert geen waarschuwingen of fouten als u een geplande taak uitschakelt die al is uitgeschakeld, zodat u alle geplande taken zonder voorwaarden kunt uitschakelen.

Voorbeeld 3: Geselecteerde geplande taken uitschakelen

In dit voorbeeld wordt een geplande taak uitgeschakeld zonder referenties.

Get-ScheduledJob | Where-Object {!$_.Credential} | Disable-ScheduledJob

Taken zonder referenties worden uitgevoerd met de machtiging van de gebruiker die ze heeft gemaakt.

De opdracht gebruikt de Get-ScheduledJob cmdlet om alle geplande taken op de computer op te halen. Een pijplijnoperator verzendt de geplande taken naar de Where-Object cmdlet, die geplande taken selecteert die geen referenties hebben. De opdracht maakt gebruik van de operator not (!) en verwijst naar de eigenschap Referentie van de geplande taak. Een andere pijplijnoperator verzendt de geselecteerde geplande taken naar de Disable-ScheduledJob cmdlet, waardoor ze worden uitgeschakeld.

Voorbeeld 4: Geplande taken uitschakelen op een externe computer

In dit voorbeeld wordt een geplande taak op twee externe computers uitgeschakeld.

Invoke-Command -ComputerName Srv01, Srv10 -ScriptBlock {Disable-ScheduledJob -Name TestJob}

De opdracht gebruikt de Invoke-Command cmdlet om een Disable-ScheduledJob opdracht uit te voeren op de Srv01- en Srv10-computers. De opdracht gebruikt de parameter Name om Disable-ScheduledJob de geplande TestJob-taak op elke computer te selecteren.

Voorbeeld 5: Een geplande taak uitschakelen op basis van de globale id

In deze voorbeelden ziet u hoe u een geplande taak uitschakelt met behulp van de globale id. De waarde van de eigenschap GlobalID van een geplande taak is een unieke id (GUID). Gebruik de GlobalID-waarde wanneer precisie vereist is, bijvoorbeeld wanneer u geplande taken op meerdere computers uitschakelt.

Get-ScheduledJob | Format-Table -Property Name, GlobalID, Command -Autosize

Name             GlobalId                             Command
----             --------                             -------
ArchiveProjects1 a26a0b3d-b4e6-44d3-8b95-8706ef621f7c C:\Scripts\Archive-DxProjects.ps1
Inventory        3ac37e5d-84c0-4a8f-9661-7e88ebb8f914 \\Srv01\Scripts\Get-FullInventory.ps1
Backup-Scripts   4d0cc6be-c082-48d1-baec-1bd8278f3c81  Copy-Item C:\CurrentScripts\*.ps1 -Destination C:\BackupScripts
Test-HelpFiles   d77020ca-f20d-42be-86c8-fc64df97db90 .\Test-HelpFiles.ps1
Test-HelpFiles   2f1606d2-c6cf-4bef-8b1c-ae36a9cc9934 .\Test-DomainHelpFiles.ps1

Get-ScheduledJob | Where-Object {$_.GlobalID = d77020ca-f20d-42be-86c8-fc64df97db90} | Disable-ScheduledJob

Met de eerste opdracht ziet u een manier om de GlobalID van een geplande taak te vinden. De opdracht gebruikt de Get-ScheduledJob cmdlet om de geplande taken op de computer op te halen. Een pijplijnoperator (|) verzendt de geplande taken naar de Format-Table cmdlet, waarin de eigenschappen Name, GlobalID en Command van elke taak in een tabel worden weergegeven.

De tweede opdracht gebruikt de Get-ScheduledJob cmdlet om de geplande taken op de computer op te halen. Een pijplijnoperator (|) verzendt de geplande taken naar de Where-Object cmdlet, waarmee de geplande taak met de opgegeven globale id wordt geselecteerd. Een andere pijplijnoperator verzendt de taak naar de Disable-ScheduledJob cmdlet, waardoor deze wordt uitgeschakeld.

Parameters

-Confirm

Hiermee wordt u 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

-Id

Hiermee schakelt u de geplande taak uit met het opgegeven identificatienummer (ID). Voer de id van een geplande taak in.

Type:Int32
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u de geplande taak moet worden uitgeschakeld. Voer een variabele in die ScheduledJobDefinition-objecten bevat of typ een opdracht of expressie waarmee ScheduledJobDefinition-objecten worden opgehaald, zoals een Get-ScheduledJob opdracht. U kunt ook een ScheduledJobDefinition-object doorsluisen naar Disable-ScheduledJob.

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

-Name

Hiermee schakelt u de geplande taken met de opgegeven namen uit. Voer de naam van een geplande taak in. Jokertekens worden ondersteund.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
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

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

ScheduledJobDefinition

U kunt een geplande taak doorsluisen naar Disable-ScheduledJob.

Uitvoerwaarden

None

Deze cmdlet retourneert standaard geen uitvoer.

ScheduledJobDefinition

Wanneer u de parameter PassThru gebruikt, retourneert deze cmdlet de geplande taak die is uitgeschakeld.

Notities

  • Disable-ScheduledJob genereert geen waarschuwingen of fouten als u deze gebruikt om een geplande taak uit te schakelen die al is uitgeschakeld.