Delen via

Get-ScheduledJobOption

  • Referentie
Module:
PSScheduledJob

Hiermee haalt u de taakopties van geplande taken op.

Syntaxis

Get-ScheduledJobOption
   [-InputObject] <ScheduledJobDefinition>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Id] <Int32>
   [<CommonParameters>]
Get-ScheduledJobOption
   [-Name] <String>
   [<CommonParameters>]

Description

De Get-ScheduledJobOption cmdlet haalt de taakopties van geplande taken op. U kunt deze opdracht gebruiken om de taakopties te onderzoeken of om de taakopties door te geven aan andere cmdlets.

Taakopties worden niet onafhankelijk op schijf opgeslagen; ze maken deel uit van een geplande taak. Als u de taakopties van een geplande taak wilt ophalen, geeft u de geplande taak op.

Gebruik de parameters van de Get-ScheduledJobOption cmdlet om de geplande taak te identificeren. U kunt geplande taken identificeren op basis van hun namen of identificatienummers, of door geplande-taakobjecten in te voeren of door te leiden, zoals objecten die door de Get-ScheduledJob cmdlet worden geretourneerd, naar Get-ScheduledJobOption.

Get-ScheduledJobOption 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: Taakopties ophalen

In dit voorbeeld worden de taakopties van geplande taken weergegeven die overeenkomen met een opgegeven naam.

Get-ScheduledJobOption -Name "*Backup*"

Voorbeeld 2: Alle taakopties ophalen

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

Get-ScheduledJob | Get-ScheduledJobOption

In het voorbeeld wordt de Get-ScheduledJob cmdlet gebruikt om de geplande taken op de lokale computer op te halen. Een pijplijnoperator (|) verzendt de geplande taken naar de Get-ScheduledJobOption cmdlet, waarmee de taakopties van elke geplande taak worden ophaalt.

Voorbeeld 3: Geselecteerde taakopties ophalen

In dit voorbeeld ziet u hoe u een taakoptiesobject met bepaalde waarden kunt vinden.

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun}

Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun} |
    ForEach-Object {$_.JobDefinition}

Met de eerste opdracht worden taakopties opgehaald waarin de eigenschap RunElevated een waarde van $True heeft en de eigenschap RunWithoutNetwork een waarde van $false. In de uitvoer ziet u het JobOptions-object dat is geselecteerd.

De tweede opdracht laat zien hoe u kunt vinden bij welke geplande taak de taakopties horen. Deze opdracht maakt gebruik van een pijplijnoperator (|) om de geselecteerde taakopties naar de ForEach-Object cmdlet te verzenden, waardoor de eigenschap JobDefinition van elk optieobject wordt opgehaald. De eigenschap JobDefinition bevat het oorspronkelijke taakobject.

Voorbeeld 4: Taakopties gebruiken om een nieuwe taak te maken

In dit voorbeeld ziet u hoe u de taakopties gebruikt die Get-ScheduledJobOption in een nieuwe geplande taak worden opgenomen.

$Opts = Get-ScheduledJobOption -Name "BackupTestLogs"
Register-ScheduledJob -Name "Archive-Scripts" -FilePath "\\Srv01\Scripts\ArchiveScripts.ps1" -ScheduledJobOption $Opts

De eerste opdracht gebruikt Get-ScheduledJobOption om de taakopties van de geplande backupTestLogs-taak op te halen. Met de opdracht worden de opties in de $Opts variabele opgeslagen.

De tweede opdracht maakt gebruik Register-ScheduledJob van cmdlet voor het maken van een nieuwe geplande taak. De waarde van de parameter ScheduledJobOption is het optiesobject in de $Opts variabele.

Voorbeeld 5: Taakopties ophalen van een externe computer

$O = Invoke-Command -ComputerName "Srv01" -ScriptBlock {Get-ScheduledJob -Name "DataDemon" }

Met deze opdracht wordt de Invoke-Command cmdlet gebruikt om de geplande taakopties van de DataDemon-taak op de Srv01-computer op te halen. Met de opdracht worden de opties in de $O variabele opgeslagen.

Parameters

-Id

Hiermee geeft u het identificatienummer van een geplande taak. Get-ScheduledJobOption haalt de taakopties van de opgegeven geplande taak op.

Gebruik de Get-ScheduledJob cmdlet om de identificatienummers van geplande taken op de lokale computer of een externe computer op te halen.

Type:Int32
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u een geplande taak. Voer een variabele in die een ScheduledJob-object bevat of typ een opdracht of expressie die een ScheduledJob-object ophaalt, zoals een Get-ScheduledJob opdracht. U kunt ook een ScheduledJob-object doorsluisen naar Get-ScheduledJobOption.

Type:ScheduledJobDefinition
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de namen van geplande taken. Get-ScheduledJobOption haalt de taakopties van de opgegeven geplande taak op. Jokertekens worden ondersteund.

Gebruik de Get-ScheduledJob cmdlet om de namen van geplande taken op de lokale computer of een externe computer op te halen.

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

ScheduledJobDefinition

U kunt een gepland taakobject doorsluisen naar deze cmdlet.

Uitvoerwaarden

ScheduledJobOptions

Met deze cmdlet wordt een ScheduledJobOptions-object geretourneerd.