ProcessSet

[アーティクル]
05/05/2023

構文

共通の設定を使用して複数の Windows プロセスを管理します。

構文

ProcessSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Path = [String[]]
    [Ensure = [String]]
    [Credential = [PSCredential]]
    [StandardOutputPath = [String]]
    [StandardErrorPath = [String]]
    [StandardInputPath = [String]]
    [WorkingDirectory = [String]]
}

説明

ProcessSet複合リソースを使用すると、限られた一連の共通オプションを使用して複数の Windows プロセスを構成できます。プロセスに引数を渡す機能など、より詳細な制御を使用してプロセスを管理するには、 WindowsProcess リソースを使用します。

要件

[なし] :

キーのプロパティ

パス

プロセスの実行可能ファイルへのパスを指定します。環境変数を使用してファイルに PATH アクセスできる場合は、ファイルの名前を指定できます。それ以外の場合は、ファイルへの完全なパスを指定します。相対パスはサポートされていません。

Type: System.String[]
Behavior: Key

省略可能なプロパティ

資格情報

プロセスを実行するアカウントの資格情報を指定します。

このプロパティがローカルシステムアカウントに設定されている場合、 StandardOutputPath、 StandardInputPath、または WorkingDirectory プロパティを設定することはできません。その場合、リソースは無効な引数例外をスローします。

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

プロセスを実行するかどうかを指定します。プロセスが Present 実行されていない場合にプロセスを開始するには、このプロパティを設定します。プロセスが Absent 実行されている場合にプロセスを停止するには、このプロパティを設定します。

既定値は Present です。

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

StandardErrorPath

プロセスが標準エラーストリームを書き込むためのファイルへの完全なパスを指定します。相対パスはサポートされていません。ファイルが存在する場合は上書きされます。

Ensure プロパティをに設定する場合は、このプロパティをAbsent設定しないでください。その場合、リソースは無効な引数例外をスローします。

Type: System.String
Default Value: None

StandardInputPath

プロセスが標準入力ストリームとして読み取るファイルへの完全なパスを指定します。相対パスはサポートされていません。

Ensure プロパティをローカルシステムアカウントに設定する場合、または Credential プロパティをAbsent設定する場合は、このプロパティを設定しないでください。その場合、リソースは無効な引数例外をスローします。

Type: System.String
Default Value: None

StandardOutputPath

プロセスが標準出力ストリームを書き込むためのファイルへの完全パスを指定します。相対パスはサポートされていません。ファイルが存在する場合は上書きされます。

Type: System.String
Default Value: None

WorkingDirectory

プロセスの作業ディレクトリのフォルダーへの完全なパスを指定します。相対パスはサポートされていません。

Type: System.String
Default Value: None

読み取り専用プロパティ

HandleCount

プロセスによって開かれたハンドルの数。

Type: System.SInt32
Behavior: Read

NonPagedMemorySize

プロセスに割り当てられた非ページメモリの量 (バイト単位)。

Type: System.UInt64
Behavior: Read

PagedMemorySize

プロセスに割り当てられたページングされたメモリの量 (バイト単位)。

Type: System.UInt64
Behavior: Read

ProcessCount

現在実行中の特定のプロセスのインスタンスの数。

Type: System.SInt32
Behavior: Read

ProcessId

プロセスの一意識別子。

Type: System.SInt32
Behavior: Read

VirtualMemorySize

プロセスに割り当てられた仮想メモリの量 (バイト単位)。

Type: System.UInt64
Behavior: Read

次の方法で共有