Get-ScheduledJob

Hiermee haalt u geplande taken op de lokale computer op.

Syntax

Get-ScheduledJob
   [[-Id] <Int32[]>]
   [<CommonParameters>]
Get-ScheduledJob
   [-Name] <String[]>
   [<CommonParameters>]

Description

De Get-ScheduledJob cmdlet haalt geplande taken op de lokale computer op. Get-ScheduledJob haalt alleen geplande taken op die door de huidige gebruiker worden gemaakt met behulp van de Register-ScheduledJob cmdlet.

Hoewel taken die zijn gemaakt met behulp van de Register-ScheduledJob cmdlet worden weergegeven in Task Scheduler, Get-ScheduledJob worden alleen geplande taken weergegeven. Er worden geen geplande taken gemaakt in Task Scheduler.

Zonder parameters worden Get-ScheduledJob alle geplande taken op de computer opgevraagd. U kunt de parameters voor het ophalen van Get-ScheduledJob geplande taken op id of naam gebruiken en ze onderzoeken of doorsturen naar andere cmdlets.

Get-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: Get-Help about_Scheduled* of zie about_Scheduled_Jobs.

Deze cmdlet is geïntroduceerd in Windows PowerShell 3.0.

Voorbeelden

Voorbeeld 1: Alle geplande taken ophalen

In dit voorbeeld worden alle geplande taken op de lokale computer weergegeven.

Get-ScheduledJob

Voorbeeld 2: Geplande taken ophalen op naam

In dit voorbeeld worden alle geplande taken op de computer met namen met back-up of archief weergegeven. Met deze opdrachtindeling kunt u zoeken naar bepaalde taken.

Get-ScheduledJob -Name *Backup*, *Archive*

Voorbeeld 3: Geplande taken ophalen op externe computers

In dit voorbeeld worden alle geplande taken op de computers weergegeven in een tekstbestand.

Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

De opdracht gebruikt de Invoke-Command cmdlet om een Get-ScheduleJob opdracht uit te voeren op elke computer.

Voorbeeld 4: Geplande taken doorsluisen naar andere cmdlets

In dit voorbeeld worden de taaktriggers van opgegeven geplande taken weergegeven

Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

De cmdlet gebruikt de Get-ScheduledJob cmdlet om de geplande taken op te halen en door te voeren naar de Get-JobTrigger cmdlet om de taaktriggers van de geplande taken op te halen.

Parameters

-Id

Haalt alleen de geplande taken op met het opgegeven identificatienummer (ID). Voer een of meer id's van geplande taken op de computer in. Get-ScheduledJob Standaard worden alle geplande taken op de computer opgeslagen.

Type:Int32[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee haalt u alleen de geplande taken met de opgegeven namen op. Voer een of meer namen van geplande taken op de computer in. Jokertekens worden ondersteund. Get-ScheduledJob Standaard worden alle geplande taken op de computer opgeslagen.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

None

U kunt objecten niet doorsluisen naar deze cmdlet.

Uitvoerwaarden

ScheduledJobDefinition

Met deze cmdlet wordt de definitie van een geplande taak geretourneerd.

Notities

  • Elke geplande taak wordt opgeslagen in een submap van de $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs map op de lokale computer. De submap heeft de naam van de geplande taak en bevat het XML-bestand voor de geplande taak en records van de uitvoeringsgeschiedenis. Zie about_Scheduled_Jobs_Advanced voor meer informatie over geplande taken op schijf.
  • Geplande taken die u in Windows PowerShell maakt, worden weergegeven in Task Scheduler in de map Task Scheduler Library\Microsoft\Windows\PowerShell\ScheduledJobs . U kunt Task Scheduler gebruiken om de geplande taak weer te geven en te bewerken.
  • U kunt Task Scheduler, het SchTasks.exe opdrachtregelprogramma en de Task Scheduler-cmdlets gebruiken om geplande taken te beheren die u maakt met de cmdlets Geplande taak. U kunt de cmdlets Geplande taak echter niet gebruiken om taken te beheren die u in Task Scheduler maakt.