スケジュールされたタスクのインスタンスを作成します。New-ScheduledTask は、Task Scheduler サービスにオブジェクトを自動的に登録しません。
次のアプリケーションまたはファイル タイプのいずれかを実行するタスクを登録することができます。 Win32アプリケーション、Win16アプリケーション、OS/2アプリケーション、MS-DOSアプリケーション、バッチファイル（.bat）、コマンドファイル（.cmd）、または適切に登録されたファイルタイプ。
例
例 1: スケジュールされたタスクを定義し、後でそれを登録する
PS C:\> $A = New-ScheduledTaskAction -Execute "Taskmgr.exe"PS C:\> $T = New-ScheduledTaskTrigger -AtLogonPS C:\> $P = New-ScheduledTaskPrincipal "Contoso\Administrator"PS C:\> $S = New-ScheduledTaskSettingsSetPS C:\> $D = New-ScheduledTask -Action $A -Principal $P -Trigger $T -Settings $SPS C:\> Register-ScheduledTask T1 -InputObject $Dこの例では、一連のコマンドは、いくつかのコマンドレットと変数を使用して、スケジュールされたタスクを定義し、次にそれを登録します。
最初のコマンドは、New-ScheduledTaskActionコマンドレットを使用して、変数$Aに実行ファイルtskmgr.exeを割り当てます。
2番目のコマンドは、New-ScheduledTaskTriggerコマンドレットを使用して、変数$Tに値AtLogonを割り当てます。
3番目のコマンドは、スケジュールされたタスクContoso\Administratorの主体を変数$Pに割り当てます。
4番目のコマンドは、New-ScheduledTaskSettingsSetコマンドレットを使用してタスク設定オブジェクトを変数$Sに割り当てます。
5番目のコマンドは、新規タスクを作成し、タスク定義を変数$Dに割り当てます。
6番目のコマンドは、（仮に）後の時間に実行されます。新しいスケジュールされたタスクを登録し、$D変数を使用して定義します。
パラメータ
実行するタスクの作業項目の配列を指定します。複数のアクションを指定すると、それらは順番に実行します。タスクには最大32アクションまで指定可能です。
| Type: | CimInstance |
| Position: | 0 |
| 初期値： | None |
| Accept pipeline input.Positionは、タスクに入力できるパイプラインの位置を指定するもので、パイプラインの入力を受け付けます。 | False |
| ワイルドカード文字を受け入れる： | False |
コマンドレットをバックグラウンド・ジョブと して実行します。 このパラメーターは、完了までに長い時間がかかるコマンドを実行するために使用します。
| Type: | SwitchParameter |
| Position: | Named |
| 初期値： | None |
| パイプライン入力に対応しました。 | False |
| Accept wildcard characters: | False |
Run the cmdlet in a remote session or on a remote computing.このコマンドレットの実行は、リモート コンピュータで実行されます。New-CimSessionまたはGet-CimSessionコマンドレットの出力など、コンピューター名またはセッション オブジェクトを入力します。デフォルトは、ローカル コンピューター上の現在のセッションです。
| Type: | CimSession |
| Aliases: | Session |
| Position: | Named |
| Default value: | なし |
| パイプライン入力を許可: | なし |
| ワイルドカード文字を許可: |
タスクを簡潔に説明します。
| Type: | String |
| Position: | 4 |
| 初期値： | None |
| Accept pipeline input.Noteは、このタスクをサポートします。 | False |
| ワイルドカード文字を受け入れる: | False |
タスクが実行するセキュリティコンテキストを指定する。
| Type: | CimInstance |
| Position: | 3 |
| 初期値： | なし |
| パイプライン入力に対応しました。 | False |
| ワイルドカード文字を受け入れる: | False |
タスクスケジューラーサービスがタスク実行方法の決定に使用する設定オブジェクトを指定します。
| タイプ： | CimInstance |
| 位置： | 2 |
| 初期値： | None |
| Accept pipeline input.Noneは、パイプライン入力を受け入れるかどうかを指定します。 | False |
| Accept wildcard characters: | False |
ThrottleLimit
cmdlet 実行に設定できる最大同時処理回数を指定します。このパラメーターが省略された場合、または0の値が入力された場合、Windows PowerShell®はコンピューター上で実行されているCIMコマンドレットの数に基づいて、コマンドレットに最適なスロットル制限を計算します。スロットルリミットは現在のコマンドレットにのみ適用され、セッションやコンピューターには適用されません。
| Type: | Int32 |
| Position: | Named |
| 初期値： | None |
| Accept pipeline input.Defaultは、パイプライン入力を受け付けません。 | False |
| ワイルドカード文字を受け入れる: | False |
スケジュールタスクを開始させる、一つ以上のトリガーオブジェクトのアレイを特定します。
トリガーとは、基準を満たしたときにスケジュールされたタスクを開始する基準のセットです。タスクを開始するには、時間ベースのトリガーまたはイベントベースのトリガーを使用でき、1つまたは複数のトリガーでタスクを開始できます。
| Type: | CimInstance |
| Position: | 1 |
| 初期値です。 | なし |
| パイプライン入力を許可: | False |
| ワイルドカード文字を許可する: | False |
| False |
出力
CimInstance
- Disable-ScheduledTask
- Enable-
- Disable-ScheduledTask
CimInstance
Outputs
- Export-ScheduledTask
- Get-ScheduledTask
- New-ScheduledTaskAction
- New-ScheduledTaskSettingsSet
- New-ScheduledTaskPrincipal
- New-ScheduledTaskTrigger
- Register-ScheduledTask
- Set-ScheduledTask
- Start-ScheduledTask
- Stop-ScheduledTask
- Unregister-ScheduledTask
Outputs