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 cmdlet Disable-ScheduledJob 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 cmdlet Disable-ScheduledJob de eigenschap Enabled van de geplande taak in op False ($false). Als u de geplande taak opnieuw wilt inschakelen, gebruikt u de cmdlet Enable-ScheduledJob.

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

PS C:\> Disable-ScheduledJob -ID 2 -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    False

Met deze opdracht wordt de geplande taak uitgeschakeld met id 2 op de lokale computer. De uitvoer toont het effect van de opdracht.

Voorbeeld 2: Alle geplande taken uitschakelen

PS C:\> 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

Met deze opdracht worden alle geplande taken op de lokale computer uitgeschakeld. De cmdlet Get-ScheduledJob wordt gebruikt om alle geplande taken op te halen en de cmdlet Disable-ScheduledJob 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

PS C:\> Get-ScheduledJob | Where-Object {!$_.Credential} | Disable-ScheduledJob

Met deze opdracht wordt een geplande taak uitgeschakeld zonder referenties. 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 gebruikt de operator not (!) en verwijst naar de eigenschap Referentie van de geplande taak. Een andere pijplijnoperator verzendt de geselecteerde geplande taken naar de cmdlet Disable-ScheduledJob, waardoor ze worden uitgeschakeld.

Voorbeeld 4: Geplande taken uitschakelen op een externe computer

PS C:\> Invoke-Command -ComputerName Srv01, Srv10 -ScriptBlock {Disable-ScheduledJob -Name TestJob}

Met deze opdracht wordt de geplande taak TestJob uitgeschakeld op twee externe computers, Srv01 en Srv10.

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 van Disable-ScheduledJob om de geplande TestJob-taak op elke computer te selecteren.

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

The first command demonstrates one way of finding the GlobalID of a scheduled job. The command uses the Get-ScheduledJob cmdlet to get the scheduled jobs on the computer. A pipeline operator (|) sends the scheduled jobs to the Format-Table cmdlet, which displays the Name, GlobalID, and Command properties of each job in a table.
PS C:\> 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

The second command uses the  Get-ScheduledJob cmdlet to get the scheduled jobs on the computer. A pipeline operator (|) sends the scheduled jobs to the Where-Object cmdlet, which selects the scheduled job with the specified global ID. Another pipeline operator sends the job to the **Disable-ScheduledJob** cmdlet, which disables it.
PS C:\> Get-ScheduledJob | Where-Object {$_.GlobalID = d77020ca-f20d-42be-86c8-fc64df97db90} | Disable-ScheduledJob

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.

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

-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 die ScheduledJobDefinition--objecten, zoals een Get-ScheduledJob opdracht, ophaalt. 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: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

ScheduledJobDefinition

U kunt een geplande taak doorsluisen naar Disable-ScheduledJob.

Uitvoerwaarden

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Als u de parameter Passthru gebruikt, retourneert Disable-ScheduledJob de geplande taak 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.