Enable-ScheduledJob

Enable-ScheduledJob コマンドレットは、Disable-ScheduledJob コマンドレットを使用して無効になっているジョブなど、無効になっているスケジュールされたジョブを再度有効にします。 有効なジョブは、トリガーされると自動的に実行されます。

スケジュールされたジョブを有効にするには、Enable-ScheduledJob コマンドレットによって、スケジュールされたジョブの Enabled プロパティが$Trueに設定されます。

Enabled-ScheduledJob は、Windows PowerShell に含まれている PSScheduledJob モジュールのジョブ スケジューリング コマンドレットのコレクションの 1 つです。

スケジュールされたジョブの詳細については、PSScheduledJob モジュールの About トピックを参照してください。 PSScheduledJob モジュールをインポートし、「Get-Help about_Scheduled*」と入力するか、about_Scheduled_Jobsを参照してください。

このコマンドレットは、Windows PowerShell 3.0 で導入されました。

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

このコマンドは、ローカル コンピューターで ID 2 のスケジュールされたジョブを有効にします。 出力には、コマンドの効果が表示されます。

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

このコマンドを実行すると、ローカル コンピューター上のすべてのスケジュールされたジョブが有効になります。 Get-ScheduledJob コマンドレットを使用して、スケジュールされたすべてのジョブを取得し、Enable-ScheduledJob コマンドレットを使用してジョブを有効にします。

Enable-ScheduledJob は、既に有効になっているスケジュールされたジョブを有効にした場合、警告やエラーを生成しないため、条件なしですべてのスケジュールされたジョブを有効にすることができます。

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

このコマンドは、ネットワーク接続を必要としないスケジュールされたジョブを有効にします。

このコマンドでは、Get-ScheduledJob コマンドレットを使用して、コンピューター上のすべてのスケジュールされたジョブを取得します。 パイプライン演算子は、スケジュールされたジョブを Get-ScheduledJobOption コマンドレットに送信し、スケジュールされた各ジョブのジョブ オプションを取得します。 各ジョブ オプション オブジェクトには、関連付けられているスケジュールされたジョブを含む JobDefinition プロパティがあります。 JobDefinition プロパティは、コマンドを完了するために使用されます。

このコマンドでは、パイプライン演算子 (|) を使用してジョブ オプションを Where-Object コマンドレットに送信します。これにより、RunWithoutNetwork プロパティの値が True ($true) のスケジュールされたジョブ オプション オブジェクトが選択されます。 別のパイプライン演算子は、選択したスケジュールされたジョブ オプション オブジェクトを ForEach-Object コマンドレットに送信します。このコマンドレットでは、スケジュールされたジョブに対して Enable-ScheduledJob コマンドを各ジョブ オプション オブジェクトの JobDefinition プロパティの値で実行します。

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

このコマンドは、Srv01 と Srv10 の 2 台のリモート コンピューターで、名前に "test" を持つスケジュールされたジョブを有効にします。

このコマンドは、Invoke-Command コマンドレットを使用して、Srv01 および Srv10 コンピューターで Enable-ScheduledJob コマンドを実行します。 このコマンドは、enable-ScheduledJob の Name パラメーターを使用して、各コンピューターでスケジュールされたジョブのインベントリを有効にします。

ScheduledJobDefinition

スケジュールされたジョブをパイプ処理して、Enable-ScheduledJobを できます。

None or Microsoft.PowerShell.ScheduledJob.ScheduledJobDefinition

Passthru パラメーターを使用すると、Enable-ScheduledJob は、有効にされたスケジュールされたジョブを返します。 それ以外の場合、このコマンドレットは出力を生成しません。

• Enable-ScheduledJob を使用して、既に有効になっているスケジュールされたジョブを有効にした場合、警告やエラーは生成されません。