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 Taakplanner-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-Job, Get-Joben Stop-JobReceive-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 nieuwere 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 wordt uitgevoerd. De taak wordt zelfs gestart als de computer op batterijen wordt uitgevoerd.
$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 ProcessJob-taak op.
Get-ScheduledJob ProcessJob
Id Name Triggers Command Enabled
-- ---- -------- ------- -------
7 ProcessJob {1} Get-Process True
De Get-Job cmdlet haalt alle exemplaren op van de geplande ProcessJob-taak die tot nu toe zijn uitgevoerd. De Get-Job cmdlet haalt alleen geplande taken op 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 processjob-taak (id = 51).
Receive-Job -ID 51
Hoewel de Receive-Job opdracht de parameter Keep niet heeft opgenomen, 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.
De volgende opdracht gebruikt de parameter DefinitionName van de Start-Job cmdlet 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, zijn ze niet onderhevig aan taakopties of worden ze beïnvloed door taaktriggers en worden hun uitvoer niet opgeslagen in de uitvoermap van de geplande taakmap.
Start-Job -DefinitionName ProcessJob
De Unregister-ScheduledJob cmdlet verwijdert de geplande ProcessJob-taak en alle opgeslagen resultaten van de taakexemplaren.
Unregister-ScheduledJob ProcessJob
Concepten voor geplande taken
Een geplande taak voert opdrachten of een script uit. Een geplande taak kan jobtriggers bevatten waarmee de taak en taakopties worden gestart die voorwaarden instellen voor het uitvoeren van de taak.
Een taaktrigger start automatisch een geplande taak. Een taaktrigger kan een eenmalig of terugkerend schema 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 het 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 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 gekoppeld, waardoor ze eenvoudig 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 eigenschap JobDefinition die de geplande taak bevat waaraan ze zijn gekoppeld. Deze recursieve interconnectie maakt het gemakkelijk om de triggers en opties van een geplande taak te vinden, te vinden, te scripten en de geplande taak weer te geven waaraan een taaktrigger of taakoptie is gekoppeld.
