ProcessSet

摘要

使用常用设置管理多个 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

可选属性

凭据

指定要运行其下进程的帐户凭据。

如果此属性设置为本地系统帐户,则无法设置 StandardOutputPathStandardInputPathWorkingDirectory 属性。 如果这样做,资源将引发无效的参数异常。

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 属性 Absent 设置为本地系统帐户或 将 Credential 属性设置为本地系统帐户时,请勿设置此属性。 如果这样做,资源将引发无效的参数异常。

Type: System.String
Default Value: None

StandardOutputPath

指定文件的完整路径,以便进程向其写入其标准输出流。 不支持相对路径。 如果文件存在,则会覆盖该文件。

Ensure 属性 Absent 设置为本地系统帐户或 将 Credential 属性设置为本地系统帐户时,请勿设置此属性。 如果这样做,资源将引发无效的参数异常。

Type: System.String
Default Value: None

WorkingDirectory

为进程的工作目录指定文件夹的完整路径。 不支持相对路径。

Ensure 属性 Absent 设置为本地系统帐户或 将 Credential 属性设置为本地系统帐户时,请勿设置此属性。 如果这样做,资源将引发无效的参数异常。

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

示例