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