Freigeben über

Enable-ScheduledJob

  • Referenz
Modul:
PSScheduledJob

Aktiviert einen geplanten Auftrag.

Syntax

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

Beschreibung

Das Enable-ScheduledJob Cmdlet aktiviert geplante Aufträge, die deaktiviert sind, z. B. solche, die mithilfe des Disable-ScheduledJob Cmdlets deaktiviert sind. Aktivierte Aufträge werden automatisch ausgeführt, wenn sie ausgelöst werden.

Um einen geplanten Auftrag zu aktivieren, legt das Enable-ScheduledJob Cmdlet die Enabled-Eigenschaft des geplanten Auftrags auf $true.

Enabled-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: Aktivieren eines geplanten Auftrags

In diesem Beispiel wird der geplante Auftrag auf einem lokalen Computer aktiviert.

Enable-ScheduledJob -ID 2 -Passthru

Der Enable-ScheduledJob Befehl aktiviert den geplanten Auftrag mit ID 2 auf dem lokalen Computer. Der PassThru-Parameter ermöglicht die Ausgabe des Job-Objekts.

Beispiel 2: Alle geplanten Aufträge aktivieren

In diesen Beispielen werden alle geplanten Aufträge auf dem lokalen Computer aktiviert.

Get-ScheduledJob | Enable-ScheduledJob

Das Get-ScheduledJob Cmdlet ruft alle geplanten Aufträge ab und gibt sie an das Cmdlet weiter, Enable-ScheduledJob um sie zu aktivieren.

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

Beispiel 3: Aktivieren ausgewählter geplanter Aufträge

In diesem Beispiel werden geplante Aufträge aktiviert, für die keine Netzwerkverbindung erforderlich ist.

Get-ScheduledJob | Get-ScheduledJobOption | Where-Object {$_.RunWithoutNetwork} |
    ForEach-Object {Enable-ScheduledJob -InputObject $_.JobDefinition}

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 Get-ScheduledJobOption Cmdlet, wodurch die Auftragsoptionen für jeden geplanten Auftrag abgerufen werden. Jedes Auftragsoptionenobjekt verfügt über eine JobDefinition-Eigenschaft, die den zugeordneten geplanten Auftrag enthält. Die JobDefinition-Eigenschaft wird verwendet, um den Befehl abzuschließen.

Der Befehl verwendet einen Pipelineoperator (|) zum Senden der Auftragsoptionen an das Where-Object Cmdlet, das geplante Auftragsoptionsobjekte auswählt, in denen die RunWithoutNetwork-Eigenschaft einen Wert aufweist $true. Ein anderer Pipelineoperator sendet die ausgewählten Objekte für geplante Auftragsoptionen an das ForEach-Object Cmdlet, das einen Enable-ScheduledJob Befehl für den geplanten Auftrag im Wert der JobDefinition-Eigenschaft jedes Auftragsoptionenobjekts ausführt.

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

Invoke-Command -ComputerName "Srv01,Srv10" -ScriptBlock {Enable-ScheduledJob -Name "Inventory"}

Dieser Befehl aktiviert geplante Aufträge mit der Zeichenfolge „test“ im Namen auf den beiden Remotecomputern Srv01 und Srv10.

Der Befehl verwendet das Invoke-Command Cmdlet, um einen Enable-ScheduledJob Befehl auf den Computern Srv01 und Srv10 auszuführen. Der Befehl verwendet den Parameter "Name " Enable-ScheduledJob , um den geplanten Auftrag "Inventar" auf jedem Computer zu aktivieren.

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

Aktiviert 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 aktivierenden 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 Enable-ScheduledJob.

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

-Name

Aktiviert 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 Enable-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, den er aktiviert hat.

Hinweise

  • Enable-ScheduledJob generiert keine Warnungen oder Fehler, wenn Sie ihn verwenden, um einen bereits aktivierten geplanten Auftrag zu aktivieren.