New-ScheduledTaskAction

[アーティクル]
11/16/2015

New-ScheduledTaskAction

Creates a scheduled task action.

構文

Parameter Set: Exec
New-ScheduledTaskAction [-Execute] <String> [[-Argument] <String> ] [[-WorkingDirectory] <String> ] [-AsJob] [-CimSession <CimSession[]> ] [-Id <String> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

詳細説明

The New-ScheduledTaskAction cmdlet creates an object that contains the definition of a scheduled task action. A scheduled task action represents a command that a task executes when Task Scheduler runs the task. You can use a task action definition to register a new scheduled task or update an existing task registration.

A task can have a single action or a maximum of 32 actions. When you specify multiple actions, Task Scheduler executes the actions sequentially. The Task Scheduler service controls tasks activation, and it hosts the tasks that it starts.

パラメーター

-Argument<String>

Specifies arguments for the command-line operation.

エイリアス	なし
必須?	false
位置は?	2
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-AsJob

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-CimSession<CimSession[]>

リモートセッションまたはリモートコンピューターでコマンドレットを実行します。New-CimSession コマンドレットや Get-CimSession コマンドレットの出力など、コンピューター名またはセッションオブジェクトを入力します。既定値は、ローカルコンピューターで実行中の現在のセッションです。

エイリアス	Session
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Execute<String>

Specifies the path to an executable file.

エイリアス	なし
必須?	true
位置は?	1
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Id<String>

Specifies an identifier of an action. Task Scheduler uses this identifier for logging.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-ThrottleLimit<Int32>

このコマンドレットを実行するために確立できる最大同時操作数を指定します。このパラメーターを省略するか、値として 0 を入力した場合、Windows PowerShell® では、コンピューターで実行している CIM コマンドレットの数に基づいて、コマンドレットに対する最適なスロットル制限を計算します。スロットル制限は現在のコマンドレットのみに適用され、セッションまたはコンピューターには適用されません。

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-WorkingDirectory<String>

Specifies a directory where Task Scheduler will run the task. If you do not specify a working directory, Task Scheduler runs the task in the %windir%\system32 directory.

エイリアス	なし
必須?	false
位置は?	3
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

Microsoft.Management.Infrastructure.CimInstance#MSFT_TaskAction

例

Example 1: Create a scheduled task action

This command creates a new scheduled task action that runs PowerShell.exe.

PS C:\> New-ScheduledTaskAction -Execute "PowerShell.exe"

New-ScheduledTaskAction