Disable-ScheduledJob

Hiermee wordt een geplande taak uitgeschakeld.

Syntax

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 uitschakelt, blijven alle taakeigenschappen behouden en worden de taaktriggers niet uitgeschakeld, maar voorkomt u dat de geplande taken automatisch worden gestart wanneer deze worden geactiveerd. U kunt een uitgeschakelde geplande taak starten met behulp van de Start-Job cmdlet of een uitgeschakelde geplande taak als sjabloon gebruiken.

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

Disable-ScheduledJobis 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 geplande taak uitschakelen

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

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 om alle geplande taken op te halen en deze door te voeren 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 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, waarmee geplande taken worden geselecteerd 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 uitgeschakeld op twee externe computers.

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 maakt gebruik van de naamparameter voor het selecteren van Disable-ScheduledJob de geplande TestJob-taak op elke computer.

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 is vereist, 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
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-Id

Hiermee wordt de geplande taak uitgeschakeld met het opgegeven identificatienummer (ID). Voer de id van een geplande taak in.

Type:Int32
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

Hiermee geeft u de geplande taak die 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:Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

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

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

U kunt een geplande taak doorsluisen naar Disable-ScheduledJob.

Uitvoerwaarden

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Als u de parameter Passthru gebruikt, Disable-ScheduledJob wordt de geplande taak geretourneerd die is uitgeschakeld. Anders genereert deze cmdlet geen uitvoer.

Notities

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