Enable-ScheduledJob

Enable-ScheduledJob
    [-InputObject] <ScheduledJobDefinition>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Enable-ScheduledJob
    [-Id] <Int32>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Enable-ScheduledJob
    [-Name] <String>
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Mit dem Cmdlet Enable-ScheduledJob werden geplante Aufträge wieder aktiviert, die deaktiviert wurden, z. B. Aufträge, die mit dem Cmdlet Disable-ScheduledJob deaktiviert wurden. 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 gehört zu einer Sammlung von Cmdlets für die Auftragsplanung im PSScheduledJob-Modul , das in Windows PowerShell enthalten ist.

Weitere Informationen zu geplanten Aufträgen finden Sie in den Themen "Info" im PSScheduledJob-Modul. Importieren Sie das PSScheduledJob-Modul, und geben Sie dann Folgendes ein: Get-Help about_Scheduled* oder about_Scheduled_Jobs anzeigen.

Dieses Cmdlet wurde in Windows PowerShell 3.0 eingeführt.

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

Mit diesem Befehl wird der geplante Auftrag mit der ID 2 auf dem lokalen Computer aktiviert. Die Ausgabe zeigt die Wirkung des Befehls.

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

Mit diesem Befehl werden alle geplanten Aufträge auf dem lokalen Computer aktiviert. 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.

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

Dieser Befehl aktiviert geplante Jobs, für die keine Netzwerkverbindung erforderlich ist.

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 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 (|), um die Auftragsoptionen an das Cmdlet Where-Object zu senden, das Objekte für geplante Auftragsoptionen auswählt, in denen die RunWithoutNetwork-Eigenschaft den Wert True ($true) aufweist. Ein anderer Pipelineoperator sendet die ausgewählten Optionsobjekte für geplante Aufträge an das Cmdlet ForEach-Object, das einen Enable-ScheduledJob-Befehl für den geplanten Auftrag im Wert der JobDefinition-Eigenschaft jedes Auftragsoptionsobjekts ausführt.

PS C:\> Invoke-Command -ComputerName "Srv01,Srv10" -ScriptBlock {Enable-ScheduledJob -Name "Inventory"}

Mit diesem Befehl werden geplante Aufträge aktiviert, die "test" in ihren Namen auf zwei Remotecomputern haben, Srv01 und Srv10.

Der Befehl verwendet das Cmdlet Invoke-Command, um den Befehl Enable-ScheduledJob auf den Computern Srv01 und Srv10 auszuführen. Der Befehl verwendet denName-Parameter von Enable-ScheduledJob , um den geplanten Inventurauftrag auf jedem Computer zu aktivieren.

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Sie können einen geplanten Auftrag über die Pipeline an Enable-ScheduledJob übergeben.

Wenn Sie den Passthru-Parameter verwenden, gibt Enable-ScheduledJob den geplanten Auftrag zurück, der aktiviert wurde. Andernfalls generiert dieses Cmdlet keine Ausgabe.

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