Delen via

Enable-ScheduledJob

  • Referentie
Module:
PSScheduledJob

Hiermee schakelt u een geplande taak in.

Syntaxis

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

Description

Met de cmdlet Enable-ScheduledJob worden geplande taken die zijn uitgeschakeld, opnieuw ingeschakeld, zoals taken die zijn uitgeschakeld met behulp van de Disable-ScheduledJob-cmdlet. Ingeschakelde taken worden automatisch uitgevoerd wanneer deze worden geactiveerd.

Als u een geplande taak wilt inschakelen, stelt de cmdlet Enable-ScheduledJob de eigenschap Enabled van de geplande taak in op $True.

Enabled-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 inschakelen

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

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

Voorbeeld 2: Alle geplande taken inschakelen

PS C:\> Get-ScheduledJob | Enable-ScheduledJob -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        True
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    True
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     True
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       True

Met deze opdracht worden alle geplande taken op de lokale computer ingeschakeld. De cmdlet Get-ScheduledJob wordt gebruikt om alle geplande taken en de Enable-ScheduledJob cmdlet in te schakelen.

Enable-ScheduledJob genereert geen waarschuwingen of fouten als u een geplande taak inschakelt die al is ingeschakeld, zodat u alle geplande taken zonder voorwaarden kunt inschakelen.

Voorbeeld 3: Geselecteerde geplande taken inschakelen

PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where-Object {$_.RunWithoutNetwork} | ForEach-Object {Enable-ScheduledJob -InputObject $_.JobDefinition}

Met deze opdracht kunt u geplande taken inschakelen waarvoor geen netwerkverbinding is vereist.

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 Get-ScheduledJobOption-cmdlet, waarmee de taakopties van elke geplande taak worden ophaalt. Elk taakoptiesobject heeft een JobDefinition-eigenschap die de bijbehorende geplande taak bevat. De eigenschap JobDefinition wordt gebruikt om de opdracht te voltooien.

De opdracht maakt gebruik van een pijplijnoperator (|) om de taakopties te verzenden naar de Where-Object-cmdlet, waarmee geplande taakoptieobjecten worden geselecteerd waarin de eigenschap RunWithoutNetwork de waarde True ($true) heeft. Een andere pijplijnoperator verzendt de geselecteerde objecten voor geplande taakopties naar de ForEach-Object-cmdlet waarop een opdracht Enable-ScheduledJob op de geplande taak wordt uitgevoerd in de waarde van de eigenschap JobDefinition van elk taakoptiesobject.

Voorbeeld 4: Geplande taken inschakelen op een externe computer

PS C:\> Invoke-Command -ComputerName "Srv01,Srv10" -ScriptBlock {Enable-ScheduledJob -Name "Inventory"}

Met deze opdracht kunt u geplande taken inschakelen die 'testen' hebben in hun namen op twee externe computers, Srv01 en Srv10.

De opdracht gebruikt de Invoke-Command cmdlet om een Enable-ScheduledJob opdracht uit te voeren op de Srv01- en Srv10-computers. De opdracht gebruikt de parameter Name van Enable-ScheduledJob om de geplande inventaristaak op elke computer in te schakelen.

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 in 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 op die moet worden ingeschakeld. 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 Enable-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 in. 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 Enable-ScheduledJob.

Uitvoerwaarden

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Als u de parameter Passthru gebruikt, retourneert Enable-ScheduledJob de geplande taak die is ingeschakeld. Anders genereert deze cmdlet geen uitvoer.

Notities

  • Enable-ScheduledJob genereert geen waarschuwingen of fouten als u deze gebruikt om een geplande taak in te schakelen die al is ingeschakeld.