Freigeben über

Unregister-ScheduledJob

  • Referenz
Modul:
PSScheduledJob

Löscht geplante Aufträge auf dem lokalen Computer.

Syntax

Unregister-ScheduledJob
          [-InputObject] <ScheduledJobDefinition[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Id] <Int32[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]
Unregister-ScheduledJob
          [-Name] <String[]>
          [-Force]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Beschreibung

Das Unregister-ScheduledJob Cmdlet löscht geplante Aufträge vom lokalen Computer.

Wenn ein geplanter Auftrag gelöscht oder die Registrierung aufgehoben wird, Unregister-ScheduledJob wird das Verzeichnis für den geplanten Auftrag (im Folgenden $HOME\AppData\Local\Microsoft\Windows\PowerShell\ScheduledJobs directory) gelöscht, das die XML-Datei enthält, die den geplanten Auftrag, den Auftragsausführungsverlauf und alle Auftragsergebnisse definiert. Diese Aktion löscht auch den Auftrag aus dem Taskplaner.

Unregister-ScheduledJob löscht nur die geplanten Aufträge, die mit dem Register-ScheduledJob Cmdlet erstellt werden. Geplante Aufträge, die im Taskplaner erstellt werden, werden nicht gelöscht.

Sie können die Parameter Unregister-ScheduledJob verwenden, um geplante Aufträge nach ID oder Name zu löschen oder geplante Aufträge von Get-ScheduledJob an zu Unregister-ScheduledJobsenden.

Unregister-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: Löschen eines geplanten Auftrags

Unregister-ScheduledJob TestJob

Dieser Befehl löscht den geplanten Auftrag TestJob vom lokalen Computer.

Beispiel 2: Löschen aller geplanten Aufträge

Get-ScheduledJob | Unregister-ScheduledJob -Force
Unregister-ScheduledJob -Name "*" -Force

Dieses Beispiel zeigt zwei verschiedene Befehle, mit denen alle geplanten Aufträge auf dem lokalen Computer gelöscht werden.

Der erste Befehl verwendet das Get-ScheduledJob Cmdlet, um alle geplanten Aufträge auf dem lokalen Computer abzurufen. Ein Pipelineoperator (|) sendet die geplanten Aufträge an Unregister-ScheduleJob, an die sie gelöscht werden.

Der zweite Befehl verwendet den Parameter Unregister-ScheduledJob Name mit einem Wert aller (*) zum Löschen aller geplanten Aufträge.

Beide Befehle verwenden den Parameter Force , der einen geplanten Auftrag löscht, auch wenn eine Instanz des Auftrags ausgeführt wird.

Beispiel 3: Löschen eines geplanten Auftrags auf einem Remotecomputer

Invoke-Command -ComputerName "Server01" { Unregister-ScheduledJob -Name "Test*"}

Dieser Befehl löscht geplante Aufträge mit Namen, die mit Test auf dem Remotecomputer Server01 beginnen. Der Befehl verwendet das Invoke-Command Cmdlet, um den Unregister-ScheduledJob Befehl auf dem Server02-Computer auszuführen.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Löscht den geplanten Auftrag selbst dann, wenn eine Instanz des Auftrags ausgeführt wird. Unregister-ScheduledJob Standardmäßig wird die Ausführung von Aufträgen nicht unterbrochen.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Löscht die geplanten Aufträge mit den angegebenen IDs. Geben Sie die IDs der geplanten Aufträge auf dem Computer ein.

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 ScheduledJob-Objekte enthält, oder geben Sie einen Befehl oder Ausdruck ein, der ScheduledJob-Objekte abruft, z. B. einen Get-ScheduledJob Befehl. Sie können auch ScheduledJob-Objekte an Unregister-JobTrigger.

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

-Name

Löscht die geplanten Aufträge mit den angegebenen Namen. Geben Sie den Namen mindestens eines geplanten Auftrags auf dem Computer ein. Platzhalter werden unterstützt.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

ScheduledJobDefinition

Sie können einen geplanten Auftrag an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.