Ресурс WindowsProcess в DSC

Область применения: Windows PowerShell 4.0, Windows PowerShell 5.x

Ресурс WindowsProcess в DSC Windows PowerShell предоставляет механизм настройки процессов на целевом узле.

Примечание

В этой документации по этому ресурсу DSC рассматривается версия, которая входит в состав PowerShell до версии 7.2. Модуль PSDscResources содержит новые и обновленные ресурсы 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] ]
}

Свойства

Свойство	Описание
Аргументы	Указывает строку аргументов, которая будет передана процессу "как есть". Если необходимо передать несколько аргументов, поместите их все в эту строку.
Путь	Путь к исполняемому файлу процесса. Если это имя исполняемого файла (а не полный путь к нему), ресурс DSC будет искать переменную среды $env:Path, чтобы найти исполняемый файл. Если значение этого свойства — полный путь, ресурс DSC не будет использовать переменную среды $env:Path для поиска файла и вызовет ошибку в случае отсутствия пути. Относительные пути не допускаются.
Учетные данные	Указывает учетные данные для запуска процесса.
StandardErrorPath	Указывает путь к каталогу для записи стандартных ошибок. Все существующие файлы в этом каталоге будут перезаписаны.
StandardInputPath	Указывает расположение стандартного ввода.
StandardOutputPath	Указывает расположение стандартного вывода. Все существующие файлы в этом каталоге будут перезаписаны.
WorkingDirectory	Указывает расположение, которое будет использоваться в качестве текущего рабочего каталога для процесса.

Общие свойства

Свойство	Описание
DependsOn	Указывает, что перед настройкой этого ресурса необходимо запустить настройку другого ресурса. Например, если идентификатор первого запускаемого блока сценария для конфигурации ресурса — ResourceName, а его тип — ResourceType, то синтаксис использования этого свойства таков: DependsOn = "[ResourceType]ResourceName".
Ensure	Указывает, существует ли процесс. Присвойте этому свойству значение Present , чтобы убедиться, что процесс существует. В противном случае установите для него значение Отсутствует. Значение по умолчанию — Present.
PsDscRunAsCredential	Задает учетные данные для выполнения всего ресурса от другого имени.