Freigeben über

Get-ScheduledJobOption

  • Referenz
Modul:
PSScheduledJob

Ruft die Auftragsoptionen geplanter Aufträge ab.

Syntax

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

Beschreibung

Das Get-ScheduledJobOption Cmdlet ruft die Auftragsoptionen von geplanten Aufträgen ab. Sie können den Befehl verwenden, um die Auftragsoptionen zu untersuchen bzw. an andere Cmdlets weiterzureichen.

Auftragsoptionen werden nicht unabhängig voneinander auf dem Datenträger gespeichert, da sie Teil eines geplanten Auftrags sind. Um die Auftragsoptionen eines geplanten Auftrags abzurufen, geben Sie den geplanten Auftrag an.

Verwenden Sie die Parameter des Get-ScheduledJobOption Cmdlets, um den geplanten Auftrag zu identifizieren. Sie können geplante Aufträge anhand ihrer Namen oder Identifikationsnummern identifizieren, oder indem Sie ScheduledJob-Objekte eingeben oder weiterleiten, z. B. diejenigen, die Get-ScheduledJob vom Cmdlet zurückgegeben werden, an Get-ScheduledJobOption.

Get-ScheduledJobOption ist eine Sammlung von Auftragsplanungs-Cmdlets im PSScheduledJob-Modul, das in Windows PowerShell enthalten ist.

Weitere Informationen zu geplanten Aufträgen finden Sie unter den Info-Themen im PSScheduledJob-Modul. Importieren Sie das PSScheduledJob-Modul, und geben Sie dann Folgendes ein: Get-Help about_Scheduled* oder lesen Sie about_Scheduled_Jobs.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

Beispiele

Beispiel 1: Abrufen von Auftragsoptionen

In diesem Beispiel werden die Auftragsoptionen von geplanten Aufträgen abgerufen, die einem angegebenen Namen entsprechen.

Get-ScheduledJobOption -Name "*Backup*"

Beispiel 2: Abrufen aller Auftragsoptionen

In diesem Beispiel werden die Auftragsoptionen aller geplanten Aufträge auf dem lokalen Computer abgerufen.

Get-ScheduledJob | Get-ScheduledJobOption

Im Beispiel wird das Get-ScheduledJob Cmdlet verwendet, um die geplanten Aufträge auf dem lokalen Computer abzurufen. Ein Pipelineoperator (|) sendet die geplanten Aufträge an das Get-ScheduledJobOption Cmdlet, wodurch die Auftragsoptionen für jeden geplanten Auftrag abgerufen werden.

Beispiel 3: Abrufen ausgewählter Auftragsoptionen

In diesem Beispiel wird veranschaulicht, wie ein Objekt mit Auftragsoptionen, das bestimmte Werte enthält, ermittelt wird.

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

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

Der erste Befehl ruft Auftragsoptionen ab, in denen die RunElevated-Eigenschaft einen Wert von $True und die RunWithoutNetwork-Eigenschaft einen Wert aufweist $false. Die Ausgabe zeigt das JobOptions-Objekt an, das ausgewählt wurde.

Der zweite Befehl zeigt, wie Sie ermitteln, zu welchem geplanten Auftrag die Auftragsoptionen gehören. Dieser Befehl verwendet einen Pipelineoperator (|), um die ausgewählten Auftragsoptionen an das ForEach-Object Cmdlet zu senden, wodurch die JobDefinition-Eigenschaft jedes Optionsobjekts abruft. Die JobDefinition-Eigenschaft enthält das ursprüngliche Auftragsobjekt.

Beispiel 4: Verwenden von Auftragsoptionen zum Erstellen eines neuen Auftrags

In diesem Beispiel wird gezeigt, wie Sie die Auftragsoptionen verwenden, die Get-ScheduledJobOption in einem neuen geplanten Auftrag abgerufen werden.

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

Der erste Befehl verwendet Get-ScheduledJobOption , um die Auftragsoptionen des geplanten BackupTestLogs-Auftrags abzurufen. Der Befehl speichert die Optionen in der $Opts Variablen.

Der zweite Befehl verwendet Register-ScheduledJob cmdlet zum Erstellen eines neuen geplanten Auftrags. Der Wert des Parameters ScheduledJobOption ist das Optionsobjekt in der $Opts Variablen.

Beispiel 5: Abrufen von Auftragsoptionen von einem Remotecomputer

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

Dieser Befehl verwendet das Invoke-Command Cmdlet, um die geplanten Auftragsoptionen des DataDemon-Auftrags auf dem Srv01-Computer abzurufen. Der Befehl speichert die Optionen in der $O Variablen.

Parameter

-Id

Gibt die ID eines geplanten Auftrags an. Get-ScheduledJobOption ruft die Auftragsoptionen des angegebenen geplanten Auftrags ab.

Um die Identifikationsnummern von geplanten Aufträgen auf dem lokalen Computer oder einem Remotecomputer abzurufen, verwenden Sie das Get-ScheduledJob Cmdlet.

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

-InputObject

Gibt einen geplanten Auftrag an. Geben Sie eine Variable ein, die ein ScheduledJob-Objekt enthält, oder geben Sie einen Befehl oder Ausdruck ein, der ein ScheduledJob-Objekt abruft, z. B. einen Get-ScheduledJob Befehl. Sie können auch ein ScheduledJob -Objekt an Get-ScheduledJobOption.

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

-Name

Gibt die Namen geplanter Aufträge an. Get-ScheduledJobOption ruft die Auftragsoptionen des angegebenen geplanten Auftrags ab. Platzhalter werden unterstützt.

Verwenden Sie das Get-ScheduledJob Cmdlet, um die Namen der geplanten Aufträge auf dem lokalen Computer oder einem Remotecomputer abzurufen.

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

Eingaben

ScheduledJobDefinition

Sie können ein geplantes Auftragsobjekt an dieses Cmdlet weiterleiten.

Ausgaben

ScheduledJobOptions

Dieses Cmdlet gibt ein ScheduledJobOptions-Objekt zurück.