WindowsProcess

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

構文

Windows プロセスを開始または停止します。

構文

WindowsProcess [String] #ResourceName
{
    Arguments = [string]
    Path = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [PsDscRunAsCredential = [PSCredential]]
    [StandardErrorPath = [string]]
    [StandardInputPath = [string]]
    [StandardOutputPath = [string]]
    [WorkingDirectory = [string]]
}

説明

リソース WindowsProcess を使用すると、プロセスが実行されているかどうかを確認できます。

要件

[なし] :

キーのプロパティ

引数

プロセスを開始するときに文字列として渡す引数の完全な一覧を指定します。プロセスに引数が必要ない場合は、このプロパティを空の文字列 ('') に設定します。

Type: System.String

パス

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

Type: System.String

省略可能なプロパティ

資格情報

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

このプロパティがローカルシステムアカウントに設定されている場合、 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.Int32
Behavior: Read

NonPagedMemorySize

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

Type: System.UInt64
Behavior: Read

PagedMemorySize

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

Type: System.UInt64
Behavior: Read

ProcessCount

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

Type: System.Int32
Behavior: Read

ProcessId

プロセスの一意識別子。

Type: System.Int32
Behavior: Read

VirtualMemorySize

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

Type: System.UInt64
Behavior: Read

次の方法で共有