次の方法で共有


DSC WindowsProcess リソース

適用先:Windows PowerShell 4.0、Windows PowerShell 5.x

Windows PowerShell Desired State Configuration (DSC) の WindowsProcess リソースは、ターゲット ノードにプロセスを構成するためのメカニズムを備えています。

注意

この DSC リソースのこのドキュメントでは、バージョン 7.2 より前の PowerShell に含まれているバージョンについて説明します。 PSDscResources モジュールには、Microsoft によって正式にサポートされている新しい DSC リソースと更新された DSC リソースが含まれています。 PSDscResources モジュールは、PowerShell ギャラリーから入手できます。

詳細と更新されたドキュメントについては、 PSDscResources リファレンス ドキュメントを参照してください

構文

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

Properties

プロパティ 説明
引数 プロセスに渡す引数の文字列をそのまま示します。 複数の引数を渡す必要がある場合は、そのすべてをこの文字列内に配置します。
パス プロセスの実行可能ファイルのパス。 これが (完全修飾パスではなく) 実行可能ファイルの名前の場合、DSC リソースではその実行可能ファイルを見つけるために環境 $env:Path 変数が検索されます。 このプロパティの値が完全修飾パスの場合、DSC ではそのファイルを見つけるために $env:Path 変数は使用されず、パスが存在しない場合はエラーがスローされます。 相対パスは指定できません。
資格情報 プロセスを開始するための資格情報を示します。
StandardErrorPath 標準エラーを書き込むディレクトリ パスを示します。 既存のファイルは上書きされます。
StandardInputPath 標準入力の場所を示します。
StandardOutputPath 標準出力の書き込み場所を示します。 既存のファイルは上書きされます。
WorkingDirectory プロセスの現在の作業ディレクトリとして使用される場所を示します。

共通プロパティ

プロパティ 説明
DependsOn このリソースを構成する前に、他のリソースの構成を実行する必要があることを示します。 たとえば、最初に実行するリソース構成スクリプト ブロックの ID が ResourceName で、そのタイプが ResourceType である場合、このプロパティを使用する構文は DependsOn = "[ResourceType]ResourceName" になります。
Ensure プロセスが存在するかどうかを示します。 プロセスが存在することを確認するには、このプロパティを Present に設定します。 それ以外の場合は、 [Absent]\(不在\) に設定します。 既定値は Present です。
PsDscRunAsCredential リソース全体を実行するための資格情報を設定します。