Add-JobTrigger

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-InputObject] <ScheduledJobDefinition[]>
    [<CommonParameters>]

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-Name] <String[]>
    [<CommonParameters>]

Add-JobTrigger
    [-Trigger] <ScheduledJobTrigger[]>
    [-Id] <Int32[]>
    [<CommonParameters>]

Add-JobTrigger コマンドレットは、スケジュールされたジョブにジョブ トリガーを追加します。 これを使用して、複数のスケジュールされたジョブに複数のトリガーを追加できます。

ジョブ トリガーは、1 回限りまたは定期的なスケジュールで、またはイベントが発生したときに、スケジュールされたジョブを開始します。

Add-JobTrigger の Trigger パラメーターを使用して、追加するジョブ トリガーを識別します。 Add-JobTrigger の Name、ID、または InputObject パラメーターを使用して、トリガーが追加されるスケジュールされたジョブを識別します。

Trigger パラメーターの値のジョブ トリガーを作成するには、New-JobTrigger コマンドレットを使用するか、ハッシュ テーブルを使用してジョブ トリガーを指定します。

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

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

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

PS C:\> $Daily = New-JobTrigger -Daily -At 3AMPS
PS C:\> Add-JobTrigger -Trigger $Daily -Name "TestJob"

これらのコマンドは、日次ジョブ トリガーを TestJob スケジュールされたジョブに追加します。

最初のコマンドでは、New-JobTrigger コマンドレットを使用して、スケジュールされたジョブを毎日午前 3:00 に開始するジョブ トリガーを作成します。このコマンドは、ジョブ・トリガーを $Daily 変数に保存します。

2 番目のコマンドでは、 Add-JobTrigger コマンドレットを使用して、$Startup 変数のジョブ トリガーを TestJob スケジュールされたジョブに追加します。

PS C:\> Get-ScheduledJob | Add-JobTrigger -Trigger (New-JobTrigger -AtStartup)

このコマンドは、ローカル コンピューター上のすべてのスケジュールされたジョブに AtStartup ジョブ トリガーを追加します。 Get-ScheduledJob を使用して、コンピューター上のスケジュールされたすべてのジョブを取得します。 パイプライン演算子 (|) を使用してジョブを Add-JobTrigger コマンドレットに送信し、スケジュールされた各ジョブにジョブ トリガーを追加します。 Trigger パラメーターの値は、AtStartup ジョブ トリガーを作成する New-JobTrigger コマンドです。

PS C:\> $T = Get-JobTrigger -Name "BackupArchives"
PS C:\> Add-JobTrigger -Name "TestBackup,BackupLogs" -Trigger $T

これらのコマンドは、BackupArchives のスケジュールされたジョブからジョブ トリガーをコピーし、TestBackup および BackupLogs のスケジュールされたジョブに追加します。

最初のコマンドでは、Get-JobTrigger コマンドレットを使用して、BackupArchives スケジュールされたジョブのジョブ トリガーを取得します。 このコマンドは、トリガーを $t 変数に保存します。

2 番目のコマンドでは、 Add-JobTrigger コマンドレットを使用して、$t のジョブ トリガーを TestBackup ジョブと BackupLogs スケジュール ジョブに追加します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

ジョブ トリガーまたはスケジュールされたジョブを Add-JobTrigger にパイプできます。

このコマンドレットによる戻り値はありません。