Freigeben über

Disable-ScheduledJob

  • Referenz
Modul:
PSScheduledJob

Deaktiviert einen geplanten Auftrag.

Syntax

Disable-ScheduledJob
       [-InputObject] <ScheduledJobDefinition>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-ScheduledJob
       [-Id] <Int32>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-ScheduledJob
       [-Name] <String>
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Beschreibung

Das Disable-ScheduledJob Cmdlet deaktiviert vorübergehend geplante Aufträge. Beim Deaktivieren werden alle Auftragseigenschaften beibehalten und keine Auftragstrigger deaktiviert. Gleichzeitig verhindert das Cmdlet, dass geplante Aufträge bei einem Trigger automatisch gestartet werden. Sie können einen deaktivierten geplanten Auftrag mithilfe des Start-Job Cmdlets starten oder einen deaktivierten geplanten Auftrag als Vorlage verwenden.

Um einen geplanten Auftrag zu deaktivieren, legt das Disable-ScheduledJob Cmdlet die Eigenschaft "Enabled " des geplanten Auftrags auf "False" fest. Verwenden Sie das Enable-ScheduledJob Cmdlet, um den geplanten Auftrag erneut zu aktivieren.

Disable-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: Deaktivieren eines geplanten Auftrags

In diesem Beispiel wird ein geplanter Auftrag auf dem lokalen Computer deaktiviert.

Disable-ScheduledJob -ID 2 -Passthru

Dieser Befehl deaktiviert den geplanten Auftrag mit der ID 2 auf dem lokalen Computer.

Beispiel 2: Alle geplanten Aufträge deaktivieren

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

Get-ScheduledJob | Disable-ScheduledJob -Passthru

Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        False
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    False
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     False
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       False

Das Get-ScheduledJob Cmdlet, um den gesamten geplanten Auftrag abzurufen und sie an das Disable-ScheduledJob Cmdlet zu übergeben, um sie zu deaktivieren.

Sie können den geplanten Auftrag mithilfe des Enable-ScheduledJob Cmdlets erneut aktivieren und einen deaktivierten geplanten Auftrag mithilfe des Start-Job Cmdlets ausführen.

Disable-ScheduledJob generiert keine Warnungen oder Fehler, wenn Sie einen bereits deaktivierten geplanten Auftrag deaktivieren, sodass Sie alle geplanten Aufträge ohne Bedingungen deaktivieren können.

Beispiel 3: Deaktivieren ausgewählter geplanter Aufträge

In diesem Beispiel wird der geplante Auftrag deaktiviert, der keine Anmeldeinformationen enthält.

Get-ScheduledJob | Where-Object {!$_.Credential} | Disable-ScheduledJob

Aufträge ohne Anmeldeinformationen werden mit der Berechtigung des Benutzers ausgeführt, der sie erstellt hat.

Der Befehl verwendet das Get-ScheduledJob Cmdlet, um alle geplanten Aufträge auf dem Computer abzurufen. Ein Pipelineoperator sendet die geplanten Aufträge an das Where-Object Cmdlet, das geplante Aufträge auswählt, für die keine Anmeldeinformationen vorhanden sind. Der Befehl verwendet den Operator nicht (!) und verweist auf die Credential-Eigenschaft des geplanten Auftrags. Ein anderer Pipelineoperator sendet die ausgewählten geplanten Aufträge an das Disable-ScheduledJob Cmdlet, wodurch sie deaktiviert werden.

Beispiel 4: Deaktivieren von geplanten Aufträgen auf einem Remotecomputer

In diesem Beispiel wird ein geplanter Auftrag auf zwei Remotecomputern deaktiviert.

Invoke-Command -ComputerName Srv01, Srv10 -ScriptBlock {Disable-ScheduledJob -Name TestJob}

Der Befehl verwendet das Invoke-Command Cmdlet, um einen Disable-ScheduledJob Befehl auf den Computern Srv01 und Srv10 auszuführen. Der Befehl verwendet den Parameter "Name " Disable-ScheduledJob , um den geplanten Auftrag "TestJob" auf jedem Computer auszuwählen.

Beispiel 5: Deaktivieren eines geplanten Auftrags anhand seiner globalen ID

In diesem Beispiel wird gezeigt, wie ein geplanter Auftrag nach seinem globalen Bezeichner deaktiviert wird. Der Wert der GlobalID-Eigenschaft eines geplanten Auftrags ist eine GUID (Globally Unique Identifier). Verwenden Sie den GlobalID-Wert, wenn es auf Genauigkeit ankommt, z. B. beim Deaktivieren von geplanten Aufträgen auf mehreren Computern.

Get-ScheduledJob | Format-Table -Property Name, GlobalID, Command -Autosize

Name             GlobalId                             Command
----             --------                             -------
ArchiveProjects1 a26a0b3d-b4e6-44d3-8b95-8706ef621f7c C:\Scripts\Archive-DxProjects.ps1
Inventory        3ac37e5d-84c0-4a8f-9661-7e88ebb8f914 \\Srv01\Scripts\Get-FullInventory.ps1
Backup-Scripts   4d0cc6be-c082-48d1-baec-1bd8278f3c81  Copy-Item C:\CurrentScripts\*.ps1 -Destination C:\BackupScripts
Test-HelpFiles   d77020ca-f20d-42be-86c8-fc64df97db90 .\Test-HelpFiles.ps1
Test-HelpFiles   2f1606d2-c6cf-4bef-8b1c-ae36a9cc9934 .\Test-DomainHelpFiles.ps1

Get-ScheduledJob | Where-Object {$_.GlobalID = d77020ca-f20d-42be-86c8-fc64df97db90} | Disable-ScheduledJob

Der erste Befehl veranschaulicht eine Möglichkeit, die GlobalID eines geplanten Auftrags zu finden. Der Befehl verwendet das Get-ScheduledJob Cmdlet, um die geplanten Aufträge auf dem Computer abzurufen. Ein Pipelineoperator (|) sendet die geplanten Aufträge an das Format-Table Cmdlet, wodurch die Eigenschaften Name, GlobalID und Command jedes Auftrags in einer Tabelle angezeigt werden.

Der zweite Befehl verwendet das Get-ScheduledJob Cmdlet, um die geplanten Aufträge auf dem Computer abzurufen. Ein Pipelineoperator (|) sendet die geplanten Aufträge an das Where-Object Cmdlet, das den geplanten Auftrag mit der angegebenen globalen ID auswählt. Ein anderer Pipelineoperator sendet den Auftrag an das Disable-ScheduledJob Cmdlet, wodurch er deaktiviert wird.

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

-Id

Deaktiviert den geplanten Auftrag mit der angegebenen ID. Geben Sie die ID eines geplanten Auftrags ein.

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

-InputObject

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

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

-Name

Deaktiviert die geplanten Aufträge mit den angegebenen Namen. Geben Sie den Namen eines geplanten Auftrags ein. Platzhalter werden unterstützt.

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

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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 Disable-ScheduledJob.

Ausgaben

None

Standardmäßig gibt dieses Cmdlet keine Ausgabe zurück.

ScheduledJobDefinition

Wenn Sie den PassThru-Parameter verwenden, gibt dieses Cmdlet den geplanten Auftrag zurück, der deaktiviert ist.

Hinweise

  • Disable-ScheduledJob generiert keine Warnungen oder Fehler, wenn Sie ihn verwenden, um einen bereits deaktivierten geplanten Auftrag zu deaktivieren.