about_Scheduled_Jobs

Korte beschrijving

Hierin worden geplande taken beschreven en wordt uitgelegd hoe u geplande taken gebruikt en beheert in PowerShell en in Task Scheduler.

Lange beschrijving

Geplande PowerShell-taken zijn een handige hybride versie van PowerShell-achtergrondtaken en Task Scheduler-taken.

Net als PowerShell-achtergrondtaken worden geplande taken asynchroon op de achtergrond uitgevoerd. Exemplaren van geplande taken die zijn uitgevoerd, kunnen worden beheerd met behulp van de taak-cmdlets, zoals Start-JobGet-Job, , Stop-Joben Receive-Job.

Net als taakplannertaken worden geplande taken opgeslagen op schijf. U kunt de taken in Task Scheduler weergeven en beheren, ze indien nodig in- en uitschakelen, ze uitvoeren of gebruiken als sjablonen, een eenmalige of terugkerende planning instellen voor het starten van de taken, of voorwaarden instellen waaronder de taken worden gestart.

Bovendien worden de resultaten van geplande taakexemplaren opgeslagen op schijf in een eenvoudig toegankelijke indeling, waardoor een actief logboek met taakuitvoer wordt geboden. Geplande taken worden geleverd met een aangepaste set cmdlets voor het beheren ervan. Met de cmdlets kunt u geplande taken, taaktriggers en taakopties maken, bewerken, beheren, uitschakelen en opnieuw inschakelen.

Deze uitgebreide en flexibele set hulpprogramma's maken geplande taken een essentieel onderdeel van veel professionele PowerShell IT-oplossingen.

De geplande taak-cmdlets zijn opgenomen in de PSScheduledJob-module die is geïnstalleerd met PowerShell. Deze module is geïntroduceerd in PowerShell 3.0 en werkt in PowerShell 3.0 en latere versies van PowerShell. Zie PSScheduledJob voor meer informatie over de cmdlets in de PSScheduledJob-module.

Zie about_Jobs voor meer informatie over PowerShell-achtergrondtaken.

Zie Task Scheduler voor meer informatie over Task Scheduler.

Notitie

U kunt geplande PowerShell-taken weergeven en beheren in Task Scheduler. De PowerShell-taken en geplande taak-cmdlets werken alleen voor geplande taken die zijn gemaakt in PowerShell.

Snel starten

In dit voorbeeld wordt een geplande taak gemaakt die elke dag om 3:00 uur begint en de Get-Process cmdlet uitvoert. De taak begint zelfs als de computer wordt uitgevoerd op batterijen.

$trigger = New-JobTrigger -Daily -At 3AM
$options = New-ScheduledJobOption -StartIfOnBattery
Register-ScheduledJob -Name ProcessJob -ScriptBlock {Get-Process} `
-Trigger $trigger -ScheduledJobOption $options

De Get-ScheduledJob cmdlet haalt de geplande taken op de lokale computer op.

Get-ScheduledJob
Id         Name            Triggers        Command            Enabled
--         ----            --------        -------            -------
7          ProcessJob      {1}             Get-Process        True

Get-JobTrigger haalt de taaktriggers van ProcessJob op. De invoerparameters geven de geplande taak op, niet de trigger, omdat triggers worden opgeslagen in een geplande taak.

Get-JobTrigger -Name ProcessJob
Id         Frequency       Time                   DaysOfWeek        Enabled
--         ---------       ----                   ----------        -------
1          Daily           11/5/2011 3:00:00 AM                     True

In dit voorbeeld wordt de parameter ContinueIfGoingOnBattery van de Set-ScheduledJob cmdlet gebruikt om de eigenschap StopIfGoingOnBatteries van ProcessJob te wijzigen in False.

Get-ScheduledJob -Name ProcessJob | Set-ScheduledJobOption `
-ContinueIfGoingOnBattery -Passthru
StartIfOnBatteries     : True
StopIfGoingOnBatteries : False
WakeToRun              : True
StartIfNotIdle         : True
StopIfGoingOffIdle     : False
RestartOnIdleResume    : False
IdleDuration           : 00:10:00
IdleTimeout            : 01:00:00
ShowInTaskScheduler    : True
RunElevated            : False
RunWithoutNetwork      : True
DoNotAllowDemandStart  : False
MultipleInstancePolicy : IgnoreNew
JobDefinition          : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

De Get-ScheduledJob cmdlet haalt de geplande taak ProcessJob op.

Get-ScheduledJob ProcessJob
Id         Name            Triggers        Command        Enabled
--         ----            --------        -------        -------
7          ProcessJob      {1}             Get-Process    True

De Get-Job cmdlet haalt alle exemplaren van de geplande ProcessJob-taak op die tot nu toe zijn uitgevoerd. De Get-Job cmdlet krijgt alleen geplande taken wanneer de PSScheduledJob-module wordt geïmporteerd in de huidige sessie.

Tip

U ziet dat u de geplande taak-cmdlets gebruikt om geplande taken te beheren, maar u gebruikt de taak-cmdlets om exemplaren van geplande taken te beheren.

Get-Job -Name ProcessJob
Id     Name        PSJobTypeName  State    HasMoreData   Location   Command
--     ----        ------------   -----    -----------   --------   -------
45     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
46     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
47     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
48     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
49     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
50     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process
51     ProcessJob  PSScheduledJob Completed       True   localhost   Get-Process

De Receive-Job cmdlet haalt de resultaten op van de meest recente instantie van de geplande processtaaktaak (id = 51).

Receive-Job -ID 51

Hoewel de Receive-Job opdracht de parameter Keep niet bevat, worden de resultaten van de taak op de schijf opgeslagen totdat u ze verwijdert of het maximum aantal resultaten wordt overschreden.

De taakresultaten zijn niet meer beschikbaar in deze sessie, maar als u een nieuwe sessie start of een nieuw PowerShell-venster opent, zijn de resultaten van de taak opnieuw beschikbaar.

Met de volgende opdracht wordt de parameter DefinitionName van de Start-Job cmdlet gebruikt om de geplande processjob-taak te starten.

Taken die met behulp van de Start-Job cmdlet worden gestart, zijn standaard PowerShell-achtergrondtaken, niet exemplaren van de geplande taak. Net als bij alle achtergrondtaken worden deze taken onmiddellijk gestart, worden ze niet onderworpen aan taakopties of beïnvloed door taaktriggers. De uitvoer wordt niet opgeslagen in de uitvoermap van de geplande taakmap.

Start-Job -DefinitionName ProcessJob

De Unregister-ScheduledJob cmdlet verwijdert de geplande taak ProcessJob en alle opgeslagen resultaten van de taakexemplaren.

Unregister-ScheduledJob ProcessJob

Concepten van geplande taken

Met een geplande taak worden opdrachten of een script uitgevoerd. Een geplande taak kan taaktriggers bevatten die de taak en taakopties starten die voorwaarden instellen voor het uitvoeren van de taak.

Met een taaktrigger wordt automatisch een geplande taak gestart. Een taaktrigger kan een eenmalige of terugkerende planning bevatten of een gebeurtenis opgeven, bijvoorbeeld wanneer een gebruiker zich aanmeldt of Windows start. Een geplande taak kan een of meer taaktriggers hebben en u kunt taaktriggers maken, toevoegen, inschakelen, uitschakelen en ophalen.

Taaktriggers zijn optioneel. U kunt geplande taken direct starten met behulp van de Start-Job cmdletopdracht of door de parameter RunNow toe te voegen aan uw Register-ScheduledJob opdracht.

Met taakopties kunt u de voorwaarden instellen voor het uitvoeren van een geplande taak. Elke geplande taak heeft één taakoptiesobject. U kunt objecten voor taakopties maken en bewerken en deze toevoegen aan een of meer geplande taken.

Telkens wanneer een geplande taak wordt gestart, wordt er een taakexemplaren gemaakt. Gebruik de PowerShell-taak-cmdlets om het taakexemplaren weer te geven en te beheren.

Geplande taken worden opgeslagen op schijf en gebruiken de cmdlet-werkwoord, Registerin plaats van New. De XML-bestanden bevinden zich op de lokale computer in de map $home\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs.

PowerShell maakt een map voor elke geplande taak en slaat de taakopdrachten, taaktriggers, taakopties en taakresultaten op in de geplande taakmap. Taaktriggers en taakopties worden niet onafhankelijk op de schijf opgeslagen. Ze worden opgeslagen in de XML van de geplande taak van elke geplande taak waaraan ze zijn gekoppeld.

Geplande taken, taaktriggers en taakopties worden weergegeven in PowerShell als objecten. De objecten zijn onderling gekoppeld, waardoor ze gemakkelijk kunnen worden gedetecteerd en gebruikt in opdrachten en scripts.

Geplande taken worden weergegeven als ScheduledJobDefinition-objecten . Het object ScheduledJobDefinition heeft een eigenschap JobTriggers die de taaktriggers van de geplande taak bevat en een eigenschap Opties die de taakopties bevat. De ScheduledJobTriggers - en ScheduledJobOptions-objecten die respectievelijk taaktriggers en taakopties vertegenwoordigen, hebben elk een JobDefinition-eigenschap die de geplande taak bevat waaraan ze zijn gekoppeld. Deze recursieve koppeling maakt het gemakkelijk om de triggers en opties van een geplande taak te vinden en de geplande taak te vinden, te scripten en weer te geven waaraan een taaktrigger of taakoptie is gekoppeld.

Zie ook