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 モジュールの概要トピックを参照してください。
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 コマンドレットに送信し、スケジュールされたジョブのすべてのジョブ トリガーを取得します。 もう 1 つのパイプライン演算子により、ジョブ トリガーを 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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
有効にするジョブ トリガーを指定します。 ScheduledJobTrigger オブジェクトを含む変数を入力するか、ScheduledJobTrigger オブジェクトを取得するコマンドまたは式 (Get-JobTrigger コマンドなど) を入力します。 ScheduledJobTrigger オブジェクトを Enable-JobTrigger にパイプすることもできます。
Type: | ScheduledJobTrigger[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
作業中の項目を表すオブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
ジョブ トリガーを Enable-JobTrigger にパイプできます。
出力
None
このコマンドレットは出力を生成しません。
メモ
- Enable-JobTrigger では、既に有効になっているジョブ トリガーを有効にした場合、エラーや警告は生成されません。
関連リンク
- about_Scheduled_Jobs
- Add-JobTrigger
- Disable-JobTrigger
- Disable-ScheduledJob
- Enable-JobTrigger
- Enable-ScheduledJob
- Get-JobTrigger
- Get-ScheduledJob
- Get-ScheduledJobOption
- New-JobTrigger
- New-ScheduledJobOption
- Register-ScheduledJob
- Remove-JobTrigger
- Set-JobTrigger
- Set-ScheduledJob
- Set-ScheduledJobOption
- Unregister-ScheduledJob