Freigeben über

Get-ScheduledJob

  • Referenz
Modul:
PSScheduledJob

Ruft geplante Aufträge auf dem lokalen Computer ab.

Syntax

Get-ScheduledJob
   [[-Id] <Int32[]>]
   [<CommonParameters>]
Get-ScheduledJob
   [-Name] <String[]>
   [<CommonParameters>]

Beschreibung

Das Get-ScheduledJob Cmdlet ruft geplante Aufträge auf dem lokalen Computer ab. Get-ScheduledJob ruft nur geplante Aufträge ab, die vom aktuellen Benutzer mithilfe des Register-ScheduledJob Cmdlets erstellt werden.

Obwohl Aufträge, die mithilfe des Register-ScheduledJob Cmdlets erstellt werden, im Taskplaner angezeigt werden, Get-ScheduledJob werden nur geplante Aufträge abgerufen. Geplante Tasks, die im Taskplaner erstellt wurden, werden nicht abgerufen.

Ohne Parameter Get-ScheduledJob werden alle geplanten Aufträge auf dem Computer abgerufen. Sie können die Parameter verwenden, um geplante Aufträge anhand der Get-ScheduledJob ID oder des Namens abzurufen und diese zu untersuchen oder an andere Cmdlets weiterzuleiten.

Get-ScheduledJob 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 aller geplanten Aufträge

In diesem Beispiel werden alle geplanten Aufträge auf dem lokalen Computer abgerufen.

Get-ScheduledJob

Beispiel 2: Abrufen von geplanten Aufträgen anhand des Namens

In diesem Beispiel werden alle geplanten Aufträge auf dem Computer mit Namen abgerufen, die Sicherung oder Archiv enthalten. Mit diesem Befehlsformat können Sie bestimmte Aufträge suchen.

Get-ScheduledJob -Name *Backup*, *Archive*

Beispiel 3: Abrufen von geplanten Aufträgen auf Remotecomputern

In diesem Beispiel werden alle geplanten Aufträge auf den Computern abgerufen, die in einer Textdatei aufgeführt sind.

Invoke-Command -ComputerName (Get-Content Servers.txt) {Get-ScheduledJob}

Der Befehl verwendet das Invoke-Command Cmdlet, um einen Get-ScheduleJob Befehl auf jedem Computer auszuführen.

Beispiel 4: Geplante Pipeaufträge an andere Cmdlets

In diesem Beispiel werden die Auftragsauslöser der angegebenen geplanten Aufträge abgerufen.

Get-ScheduledJob DailyBackup, WeeklyBackup | Get-JobTrigger

Es verwendet das Get-ScheduledJob Cmdlet, um die geplanten Aufträge abzurufen und sie an das Get-JobTrigger Cmdlet zu übergeben, um die Auftragsauslöser der geplanten Aufträge abzurufen.

Parameter

-Id

Ruft nur die geplanten Aufträge mit der angegebenen ID ab. Geben Sie mindestens eine ID eines geplanten Auftrags auf dem Computer ein. Ruft standardmäßig Get-ScheduledJob alle geplanten Aufträge auf dem Computer ab.

Typ:Int32[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Ruft nur die geplanten Aufträge mit den angegebenen Namen ab. Geben Sie mindestens einen Namen eines geplanten Auftrags auf dem Computer ein. Platzhalter werden unterstützt. Ruft standardmäßig Get-ScheduledJob alle geplanten Aufträge auf dem Computer ab.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Sie können Objekte an dieses Cmdlet weiterleiten.

Ausgaben

ScheduledJobDefinition

Dieses Cmdlet gibt die Definition eines geplanten Auftrags zurück.

Hinweise

  • Jeder geplante Auftrag wird in einem Unterverzeichnis des $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs Verzeichnisses auf dem lokalen Computer gespeichert. Das Unterverzeichnis wird für den geplanten Auftrag benannt und enthält die XML-Datei für den geplanten Auftrag sowie Einträge zu dessen Ausführungsverlauf. Weitere Informationen zu geplanten Aufträgen auf dem Datenträger finden Sie unter about_Scheduled_Jobs_Advanced.
  • Geplante Aufträge, die Sie in Windows PowerShell erstellen, werden im Aufgabenplaner im Ordner "Taskplaner Library\Microsoft\Windows\PowerShell\ScheduledJobs " angezeigt. Sie können den Taskplaner zum Anzeigen und Bearbeiten des geplanten Auftrags verwenden.
  • Sie können den Task Scheduler, das SchTasks.exe Befehlszeilentool und die Cmdlets "Task Scheduler" verwenden, um geplante Aufträge zu verwalten, die Sie mit den Cmdlets "Geplanter Auftrag" erstellen. Sie können die Cmdlets für geplante Aufträge jedoch nicht zum Verwalten von Tasks verwenden, die Sie im Taskplaner erstellen.