次の方法で共有


Enable-JobTrigger

スケジュールされたジョブのジョブ トリガーを有効にします。

構文

Enable-JobTrigger
      [-InputObject] <ScheduledJobTrigger[]>
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Enable-JobTrigger コマンドレットは、スケジュールされたジョブのジョブ トリガー (Disable-JobTrigger コマンドレットを使用して無効にされたものなど) を再度有効にします。 有効なジョブ トリガーと再有効化されたジョブ トリガーは、スケジュールされたジョブをすぐに開始できます。Windows または Windows PowerShell を再起動する必要はありません。

このコマンドレットを使用するには、Get-JobTrigger コマンドレットを使用してジョブ トリガーを取得します。 次に、ジョブ トリガーをパイプ処理して Enable-JobTrigger を するか、InputObject パラメーターを使用します。

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

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

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

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

例 1: ジョブ トリガーを有効にする

PS C:\> Get-JobTrigger -Name Backup-Archives -TriggerID 1 | Enable-JobTrigger

このコマンドにより、ローカル コンピューター上のスケジュールされたジョブ Backup-Archives 最初のトリガー (ID=1) が有効になります。

このコマンドでは、Get-JobTrigger コマンドレットを使用してジョブ トリガーを取得します。 パイプライン オペレーターは、ジョブ トリガーを有効にする Enable-JobTrigger コマンドレットに送信します。

例 2: すべてのジョブ トリガーを有効にする

PS C:\> Get-ScheduledJob | Get-JobTrigger | Enable-JobTrigger

このコマンドでは、Get-ScheduledJob コマンドレットを使用して、ローカル コンピューターでスケジュールされたジョブを取得します。 パイプライン演算子 (|) は、スケジュールされたジョブを Get-JobTrigger コマンドレットに送信し、スケジュールされたジョブのすべてのジョブ トリガーを取得します。 別のパイプライン オペレーターは、ジョブ トリガーを有効にする Enable-JobTrigger コマンドレットに送信します。

例 3: リモート コンピューターでスケジュールされたジョブのジョブ トリガーを有効にする

PS C:\> Invoke-Command -ComputerName Server01 {Get-JobTrigger -Name DeployPackage | Where-Object {$_.Frequency -eq "AtLogon"} | Enable-JobTrigger}

このコマンドは、Server01 リモート コンピューター上の DeployPackage スケジュールされたジョブで AtLogon ジョブ トリガーを再度有効にします。

このコマンドでは、Invoke-Command コマンドレットを使用して、Server01 コンピューターでコマンドを実行します。 リモート コマンドは、Get-JobTrigger コマンドレットを使用して、DeployPackage のスケジュールされたジョブのジョブ トリガーを取得します。 パイプライン演算子は、atLogon ジョブ トリガーのみを返す Where-Object コマンドレットにジョブ トリガーを送信します。 パイプライン演算子は、AtLogon ジョブ トリガーを有効にする Enable-JobTrigger コマンドレットに送信します。

例 4: 無効なジョブ トリガーを表示する

PS C:\> Get-ScheduledJob | Get-JobTrigger | where {!$_.Enabled} | Format-Table Id, Frequency, At, DaysOfWeek, Enabled, @{Label="JobName";Expression={$_.JobDefinition.Name}}
Id Frequency At                     DaysOfWeek Enabled JobName
-- --------- --                     ---------- ------- -------
 1    Weekly 9/28/2011 3:00:00 AM   {Monday}   False   Backup-Archive
 2    Daily  9/29/2011 1:00:00 AM              False   Backup-Archive
 1    Weekly 10/20/2011 11:00:00 PM {Friday}   False   Inventory
 1    Weekly 11/2/2011 2:00:00 PM   {Monday}   False   Inventory

このコマンドは、テーブル内のすべてのスケジュールされたジョブのすべての無効なジョブ トリガーを表示します。 このようなコマンドを使用して、有効にする必要があるジョブ トリガーを検出できます。

このコマンドでは、Get-ScheduledJob コマンドレットを使用して、ローカル コンピューターでスケジュールされたジョブを取得します。 パイプライン演算子 (|) は、スケジュールされたジョブを Get-JobTrigger コマンドレットに送信し、スケジュールされたジョブのすべてのジョブ トリガーを取得します。 別のパイプライン演算子は、Where-Object コマンドレットにジョブ トリガーを送信します。このコマンドレットは、無効になっているジョブ トリガーのみを返します。つまり、ジョブ トリガーの Enabled プロパティの値が true ではありません。

別のパイプライン演算子は、無効なジョブ トリガーを Format-Table コマンドレットに送信します。このコマンドレットは、ジョブ トリガーの選択されたプロパティをテーブルに表示します。 プロパティには、ジョブ トリガーの JobDefinition プロパティにスケジュールされたジョブの名前を表示する新しい JobName プロパティが含まれています。

パラメーター

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

有効にするジョブ トリガーを指定します。 ScheduledJobTrigger オブジェクト 含む変数を入力するか、Get-JobTrigger コマンドなどの ScheduledJobTrigger オブジェクト 取得するコマンドまたは式を入力します。 また、ScheduledJobTrigger オブジェクトをパイプ処理して、Enable-JobTriggerすることもできます。

型:ScheduledJobTrigger[]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-PassThru

作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しません。

型:SwitchParameter
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

ScheduledJobTrigger

ジョブ トリガーをパイプ処理して、Enable-JobTriggerを できます。

出力

None

このコマンドレットは出力を生成しません。

メモ

  • Enable-JobTrigger 、既に有効になっているジョブ トリガーを有効にしてもエラーや警告は生成されません。