Get-ScheduledJobOption

Hiermee haalt u de taakopties van geplande taken op.

Syntax

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 geven, zoals objecten die door de Get-ScheduledJob cmdlet worden geretourneerd, naar Get-ScheduledJobOption.

Get-ScheduledJobOptionis 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: 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 zoeken.

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 heeft van $false. In de uitvoer ziet u het JobOptions-object dat is geselecteerd.

De tweede opdracht laat zien hoe u kunt zoeken naar welke geplande taak de taakopties behoren. Met deze opdracht wordt een pijplijnoperator (|) gebruikt om de geselecteerde taakopties naar de ForEach-Object cmdlet te verzenden, waarmee 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 een nieuwe geplande taak krijgen.

$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 van Register-ScheduledJob de cmdlet om een nieuwe geplande taak te maken. 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 cmdlet om de identificatienummers van geplande taken op de lokale computer of een externe computer op te Get-ScheduledJob halen.

Type:Int32
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

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

Type:Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

Hiermee geeft u de namen van geplande taken op. 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
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

U kunt een geplande taak van Get-ScheduledJob naar Get-ScheduledJobOption.

Uitvoerwaarden

Microsoft.PowerShell.ScheduledJob.ScheduledJobOptions