Ресурс DSC ProcessSet

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

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

Примечание

В этой документации по этому ресурсу DSC рассматривается версия, которая входит в состав PowerShell до версии 7.2. Модуль PSDscResources содержит новые и обновленные ресурсы DSC, которые официально поддерживаются корпорацией Майкрософт. Модуль PSDscResources доступен из коллекции PowerShell.

Дополнительные сведения и обновленную документацию см. в справочной документации по PSDscResources.

Синтаксис

ProcessSet [string] #ResourceName
{
    Path = [string]
    [ Credential = [PSCredential] ]
    [ StandardOutputPath = [string] ]
    [ StandardErrorPath = [string] ]
    [ StandardInputPath = [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	Задает учетные данные для выполнения всего ресурса от другого имени.

Примечание

В WMF 5.0 было добавлено общее свойство PsDscRunAsCredential, разрешающее запуск любого ресурса DSC в контексте других учетных данных. Дополнительные сведения см. в разделе Использование учетных данных с ресурсами DSC.