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

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

Enabled-ScheduledJob ist eine Sammlung von Cmdlets zur Auftragsplanung 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

PS C:\> Enable-ScheduledJob -ID 2 -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    True

Dieser Befehl aktiviert den geplanten Auftrag mit der ID 2 auf dem lokalen Computer. Die Ausgabe veranschaulicht die Auswirkungen des Befehls.

Beispiel 2: Aktivieren aller geplanten Aufträge

PS C:\> Get-ScheduledJob | Enable-ScheduledJob -Passthru
Id         Name            Triggers        Command                                  Enabled
--         ----            --------        -------                                  -------
1          ArchiveProje... {}              C:\Scripts\Archive-DxProjects.ps1        True
2          Inventory       {1, 2}          \\Srv01\Scripts\Get-FullInventory.ps1    True
4          Test-HelpFiles  {1}             .\Test-HelpFiles.ps1                     True
5          TestJob         {1, 2}          .\Run-AllTests.ps1                       True

Dieser Befehl aktiviert alle geplanten Aufträge auf dem lokalen Computer. Es verwendet das Cmdlet Get-ScheduledJob, um alle geplanten Aufträge abzurufen, und das Cmdlet Enable-ScheduledJob , um sie zu aktivieren.

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

Beispiel 3: Aktivieren ausgewählter geplanter Aufträge

PS C:\> Get-ScheduledJob | Get-ScheduledJobOption | Where-Object {$_.RunWithoutNetwork} | ForEach-Object {Enable-ScheduledJob -InputObject $_.JobDefinition}

Dieser Befehl aktiviert geplante Aufträge, die keine Netzwerkverbindung benötigen.

Der Befehl verwendet das Cmdlet Get-ScheduledJob, um alle geplanten Aufträge auf dem Computer abzurufen. Ein Pipelineoperator sendet die geplanten Aufträge an das Cmdlet Get-ScheduledJobOption, das die Auftragsoptionen jedes geplanten Auftrags abruft. Jedes Objekt für Auftragsoptionen 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 (|), um die Auftragsoptionen an das Cmdlet Where-Object zu senden, das geplante Auftragsoptionsobjekte auswählt, in denen die RunWithoutNetwork-Eigenschaft den Wert True ($true) aufweist. Ein anderer Pipelineoperator sendet die ausgewählten Objekte für geplante Aufträge an das Cmdlet ForEach-Object, das einen Befehl Enable-ScheduledJob für den geplanten Auftrag im Wert der JobDefinition-Eigenschaft jedes Auftragsoptionenobjekts ausführt.

Beispiel 4: Aktivieren geplanter Aufträge auf einem Remotecomputer

PS C:\> 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 Cmdlet Invoke-Command, um einen Befehl Enable-ScheduledJob auf den Computern Srv01 und Srv10 auszuführen. Der Befehl verwendet den Name-Parameter von Enable-ScheduledJob, um den geplanten Auftrag Inventory 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 übergeben.

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:False
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 übergeben.

Ausgaben

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Bei Verwendung des Passthru-Parameters gibt Enable-ScheduledJob den geplanten Auftrag zurück, der aktiviert wurde. Andernfalls wird von diesem Cmdlet keine Ausgabe generiert.

Hinweise

  • Enable-ScheduledJob generiert keine Warnungen oder Fehler, wenn Sie damit einen geplanten Auftrag aktivieren, der bereits aktiviert ist.