New-JobTrigger

New-JobTrigger コマンドレットは、スケジュールされたジョブを 1 回限りまたは定期的なスケジュールで開始するジョブ トリガー、またはイベントが発生したときに開始するジョブ トリガーを作成します。

New-JobTrigger が返す ScheduledJobTrigger オブジェクトを使用して、新規または既存のスケジュールされたジョブのジョブ トリガーを設定できます。 また、Get-JobTrigger コマンドレットを使用して既存のスケジュールされたジョブのジョブ トリガーを取得するか、ハッシュ テーブル値を使用してジョブ トリガーを表すことで、ジョブ トリガーを作成することもできます。

ジョブ トリガーを作成するときは、New-ScheduledJobOption コマンドレットで指定されたオプションの既定値を確認します。 これらのオプションは、タスク スケジューラの対応するオプションと同じ有効な値と既定値を持ち、スケジュールされたジョブのスケジュール設定とタイミングに影響します。

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

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

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

PS C:\> New-JobTrigger -Once -At "1/20/2012 3:00 AM"

このコマンドでは、 New-JobTrigger コマンドレットを使用して、スケジュールされたジョブを 1 回だけ開始するジョブ トリガーを作成します。 At パラメーターの値は、Windows PowerShell が DateTime オブジェクトに変換する文字列です。 At パラメーターの値には、時刻だけでなく明示的な日付が含まれます。 日付を省略した場合、トリガーは現在の日付と午前 3 時の時刻で作成されます。これは、過去の時刻を表す可能性があります。

PS C:\> New-JobTrigger -Daily -At "4:15 AM" -DaysInterval 3
Id         Frequency       Time                   DaysOfWeek              Enabled
--         ---------       ----                   ----------              -------
0          Daily           9/21/2012 4:15:00 AM                           True

このコマンドは、スケジュールされたジョブを午前 4 時 15 分に 3 日ごとに開始するジョブ トリガーを作成します。

At パラメーターの値には日付が含まれていないため、現在の日付は、DateTime オブジェクトの日付値として使用されます。 日付と時刻が過去の場合、スケジュールされたジョブは次の出現時点で開始されます。これは、At パラメーター値から 3 日後。

PS C:\> New-JobTrigger -Weekly -DaysOfWeek Monday, Wednesday, Friday -At "23:00" -WeeksInterval 4
Id Frequency Time                  DaysOfWeek                  Enabled
-- --------- ----                  ----------                  -------
0  Weekly    9/21/2012 11:00:00 PM {Monday, Wednesday, Friday} True

このコマンドは、スケジュールされたジョブを 4 週間ごとに月曜日、水曜日、金曜日の 2300 時 (午後 11:00) に開始するジョブトリガーを作成します。

など、-DaysOfWeek 1, 5 パラメーター値を整数で入力することもできます。

PS C:\> New-JobTrigger -AtLogOn -User Domain01\Admin01

このコマンドは、ドメイン管理者がコンピューターにログオンするたびにスケジュールされたジョブを開始するジョブ トリガーを作成します。

PS C:\> New-JobTrigger -Daily -At 1:00 -RandomDelay 00:20:00

このコマンドは、スケジュールされたジョブを毎日午前 1:00 に開始するジョブトリガーを作成します。 このコマンドでは、RandomDelay パラメーターを使用して、最大遅延時間を 20 分に設定します。 その結果、ジョブは毎日午前 1 時から午前 1 時 20 分の間に実行され、間隔は擬似ランダムに変化します。

サンプリング、負荷分散、およびその他の管理タスクにはランダムな遅延を使用できます。 遅延値を設定するときは、New-ScheduledJobOption コマンドレットの有効値と既定値を確認し、遅延をオプション設定と調整します。

The first command uses the **New-JobTrigger** cmdlet to create a job trigger that starts a job every Monday, Wednesday, and Friday at 12:01 AM. The command saves the job trigger in the $T variable.
PS C:\> $T = New-JobTrigger -Weekly -DaysOfWeek 1,3,5 -At 12:01AM


The second command uses the Register-ScheduledJob cmdlet to create a scheduled job that starts a job every Monday, Wednesday, and Friday at 12:01 AM. The value of the *Trigger* parameter is the trigger that is stored in the $T variable.
PS C:\> Register-ScheduledJob -Name Test-HelpFiles -FilePath C:\Scripts\Test-HelpFiles.ps1 -Trigger $T

これらのコマンドは、ジョブトリガーを使用して、新しいスケジュールされたジョブを作成します。

PS C:\> Add-JobTrigger -Name SynchronizeApps -Trigger (New-JobTrigger -Daily -At 3:10AM)

この例では、既存のスケジュールされたジョブにジョブ トリガーを追加する方法を示します。 スケジュールされたジョブに複数のジョブ トリガーを追加できます。

このコマンドでは、Add-JobTrigger コマンドレットを使用して、ジョブ トリガーを SynchronizeApps スケジュールされたジョブに追加します。 Trigger パラメーターの値は、毎日午前 3 時 10 分にジョブを実行する New-JobTrigger コマンドです。

コマンドが完了すると、SynchronizeApps は、ジョブ トリガーで指定された時間に実行されるスケジュールされたジョブになります。

PS C:\> New-JobTrigger -Once -At "09/12/2013 1:00:00" -RepetitionInterval (New-TimeSpan -Hours 1) -RepetitionDuration (New-Timespan -Hours 48)

このコマンドは、2013 年 9 月 12 日午前 1 時から 48 時間 60 分ごとにジョブを実行するジョブ トリガーを作成します。

PS C:\> Get-JobTrigger -Name SecurityCheck | Set-JobTrigger -RepetitionInterval 0:00 -RepetitionDuration 0:00

このコマンドは、ジョブ・トリガーの有効期限が切れるまで 60 分ごとに実行されるようにトリガーされる SecurityCheck ジョブを強制的に停止します。

ジョブが繰り返されないようにするために、コマンドは Get-JobTrigger を使用して SecurityCheck ジョブのジョブ トリガーを取得し、Set-JobTrigger コマンドレットを使用してジョブ トリガーの繰り返し間隔と繰り返し時間をゼロ (0) に変更します。

PS C:\> New-JobTrigger -Once -At "9/21/2012 0am" -RepetitionInterval (New-TimeSpan -Hour 12) -RepetitionDuration ([TimeSpan]::MaxValue)

次のコマンドは、12 時間ごとに無期限にスケジュールされたジョブを実行するジョブ トリガーを作成します。 スケジュールは明日 (2012 年 9 月 21 日) 午前 0 時 (午前 0 時) に開始されます。

None

このコマンドレットに入力をパイプすることはできません。

ScheduledJobTrigger

• ジョブ トリガーはディスクに保存されません。 ただし、スケジュールされたジョブはディスクに保存され、Get-JobTrigger を使用してスケジュールされた任意のジョブのジョブ トリガーを取得できます。

• New-JobTrigger は、過去の日付の 1 回限りのトリガーなど、スケジュールされたジョブを実行しないジョブトリガーの作成を妨げません。

• Register-ScheduledJob コマンドレットは、 New-JobTrigger または Get-JobTrigger コマンドレットによって返されるオブジェクトなどの ScheduledJobTrigger オブジェクト、またはトリガー値を含むハッシュ テーブルを受け入れます。

  ハッシュ テーブルを送信するには、次のキーを使用します。

  @{Frequency="Once" (or Daily, Weekly, AtStartup, AtLogon);At="3am" (または任意の有効な時間文字列)。 DaysOfWeek="Monday", "Wednesday" (または曜日の名前の任意の組み合わせ) Interval=2 (または任意の有効な周波数間隔)。 RandomDelay="30minutes" (または任意の有効な timespan 文字列) User="Domain1\User01 (または、 AtLogon の頻度値でのみ使用される任意の有効なユーザー) }