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

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

通过