Get-ScheduledJobOption

  • Referens
Modul:
PSScheduledJob

Hämtar jobbalternativen för schemalagda jobb.

Syntax

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

Description

Cmdleten Get-ScheduledJobOption hämtar jobbalternativen för schemalagda jobb. Du kan använda det här kommandot för att undersöka jobbalternativen eller skicka jobbalternativen till andra cmdletar.

Jobbalternativ sparas inte på disken oberoende av varandra. de ingår i ett schemalagt jobb. Om du vill hämta jobbalternativen för ett schemalagt jobb anger du det schemalagda jobbet.

Använd cmdletens Get-ScheduledJobOption parametrar för att identifiera det schemalagda jobbet. Du kan identifiera schemalagda jobb med deras namn eller ID-nummer, eller genom att ange eller skicka schemalagda jobbobjekt , till exempel de som returneras av cmdleten Get-ScheduledJob , till Get-ScheduledJobOption.

Get-ScheduledJobOption är en av en samling cmdletar för jobbschemaläggning i modulen PSScheduledJob som ingår i Windows PowerShell.

Mer information om schemalagda jobb finns i Avsnittet om i modulen PSScheduledJob. Importera modulen PSScheduledJob och skriv sedan: Get-Help about_Scheduled* eller se about_Scheduled_Jobs.

Den här cmdleten introducerades i Windows PowerShell 3.0.

Exempel

Exempel 1: Hämta jobbalternativ

Det här exemplet hämtar jobbalternativen för schemalagda jobb som matchar ett angivet namn.

Get-ScheduledJobOption -Name "*Backup*"

Exempel 2: Hämta alla jobbalternativ

Det här exemplet hämtar jobbalternativen för alla schemalagda jobb på den lokala datorn.

Get-ScheduledJob | Get-ScheduledJobOption

I exemplet används cmdleten Get-ScheduledJob för att hämta schemalagda jobb på den lokala datorn. En pipelineoperator (|) skickar de schemalagda jobben till cmdleten Get-ScheduledJobOption , som hämtar jobbalternativen för varje schemalagt jobb.

Exempel 3: Hämta valda jobbalternativ

Det här exemplet visar hur du hittar jobbalternativobjekt med specifika värden.

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

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

Det första kommandot hämtar jobbalternativ där egenskapen RunElevated har värdet $True och egenskapen RunWithoutNetwork har värdet $false. Utdata visar det JobOptions-objekt som har valts .

Det andra kommandot visar hur du hittar till vilket schemalagt jobb jobbalternativen tillhör. Det här kommandot använder en pipelineoperator (|) för att skicka de valda jobbalternativen till cmdleten ForEach-Object , som hämtar egenskapen JobDefinition för varje alternativobjekt. Egenskapen JobDefinition innehåller det ursprungliga jobbobjektet.

Exempel 4: Använd jobbalternativ för att skapa ett nytt jobb

Det här exemplet visar hur du använder jobbalternativen som Get-ScheduledJobOption finns i ett nytt schemalagt jobb.

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

Det första kommandot använder Get-ScheduledJobOption för att hämta jobbalternativen för det schemalagda jobbet BackupTestLogs. Kommandot sparar alternativen i variabeln $Opts .

Det andra kommandot använder Register-ScheduledJob cmdlet för att skapa ett nytt schemalagt jobb. Värdet för parametern ScheduledJobOption är alternativobjektet i variabeln $Opts .

Exempel 5: Hämta jobbalternativ från en fjärrdator

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

Det här kommandot använder cmdleten Invoke-Command för att hämta de schemalagda jobbalternativen för DataDemon-jobbet på Srv01-datorn. Kommandot sparar alternativen i variabeln $O .

Parametrar

-Id

Anger identifieringsnumret för ett schemalagt jobb. Get-ScheduledJobOption hämtar jobbalternativen för det angivna schemalagda jobbet.

Om du vill hämta ID-nummer för schemalagda jobb på den lokala datorn eller en fjärrdator använder du cmdleten Get-ScheduledJob .

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

-InputObject

Anger ett schemalagt jobb. Ange en variabel som innehåller ett ScheduledJob-objekt eller skriv ett kommando eller uttryck som hämtar ett ScheduledJob-objekt , till exempel ett Get-ScheduledJob kommando. Du kan också skicka ett ScheduledJob-objekt till Get-ScheduledJobOption.

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

-Name

Anger namnen på schemalagda jobb. Get-ScheduledJobOption hämtar jobbalternativen för det angivna schemalagda jobbet. Jokertecken stöds.

Om du vill hämta namnen på schemalagda jobb på den lokala datorn eller en fjärrdator använder du cmdleten Get-ScheduledJob .

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

Indata

Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Du kan skicka ett schemalagt jobbobjekt till den här cmdleten.

Utdata

Microsoft.PowerShell.ScheduledJob.ScheduledJobOptions

Den här cmdleten returnerar ett ScheduledJobOptions-objekt .