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 cmdlet Get-ScheduledJobOption 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 ScheduledJob-objecten, zoals objecten die worden geretourneerd door de Get-ScheduledJob-cmdlet, in te voeren of door te leiden naar Get-ScheduledJobOption-.

Get-ScheduledJobOption is 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

PS C:\> Get-ScheduledJobOption -Name "*Backup*"
StartIfOnBatteries     : False

StopIfGoingOnBatteries : True

WakeToRun              : False

StartIfNotIdle         : True

StopIfGoingOffIdle     : False

RestartOnIdleResume    : False

IdleDuration           : 00:10:00

IdleTimeout            : 01:00:00

ShowInTaskScheduler    : True

RunElevated            : True

RunWithoutNetwork      : True

DoNotAllowDemandStart  : False

MultipleInstancePolicy : Ignore

NewJobDefinition       : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Met deze opdracht worden de taakopties van geplande taken met BackUp in hun naam weergegeven. In de resultaten ziet u het object taakopties dat Get-ScheduledJobOption geretourneerd.

Voorbeeld 2: Alle taakopties ophalen

PS C:\> Get-ScheduledJob | Get-ScheduledJobOptions

Met deze opdracht worden de taakopties van alle geplande taken op de lokale computer weergegeven.

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

Voorbeeld 3: Geselecteerde taakopties ophalen

PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun}
StartIfOnBatteries     : False

StopIfGoingOnBatteries : True

WakeToRun              : True

StartIfNotIdle         : True

StopIfGoingOffIdle     : False

RestartOnIdleResume    : False

IdleDuration           : 00:10:00

IdleTimeout            : 01:00:00

ShowInTaskScheduler    : True

RunElevated            : True

RunWithoutNetwork      : True

DoNotAllowDemandStart  : False

MultipleInstancePolicy : Ignore

NewJobDefinition       : Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

The second command shows how to find to which scheduled job the job options belong. This command uses a pipeline operator (|) to send the selected job options to the ForEach-Object cmdlet, which gets the JobDefinition property of each options object. The JobDefinition property contains the originating job object. The results show that the selected options came from the DeployPkg scheduled job.
PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where {$_.RunElevated -and !$_.WaketoRun} | ForEach-Object {$_.JobDefinition}
Id         Name            Triggers        Command                                  Enabled

--         ----            --------        -------                                  -------

2          DeployPkg         {1, 2}        DeployPackage.ps1                        True

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

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

Voorbeeld 4: Taakopties gebruiken om een nieuwe taak te maken

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

In dit voorbeeld ziet u hoe u de taakopties gebruikt die Get-ScheduledJobOptions een nieuwe geplande taak krijgt.

De eerste opdracht maakt gebruik van Get-ScheduledJobOptions- om de taakopties van de geplande Back-upTestLogs-taak op te halen. Met de opdracht worden de opties opgeslagen in de $Opts variabele.

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

Voorbeeld 5: Taakopties ophalen van een externe computer

PS C:\> $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 opgeslagen in de $O variabele.

Parameters

-Id

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

Gebruik de cmdlet Get-ScheduledJob 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 waarmee een ScheduledJob-object wordt opgehaald, 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- krijgt de taakopties van de opgegeven geplande taak. 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 geplande taak van Get-ScheduledJob naar Get-ScheduledJobOption-.

Uitvoerwaarden

ScheduledJobOptions