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

Укажите путь к исполняемому файлу процесса. Если файл доступен через 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

Укажите полный путь к файлу для чтения в качестве стандартного входного потока. Относительные пути не поддерживаются.

Не устанавливайте это свойство при задании свойства 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

Поделиться через