Ресурс DSC WindowsOptionalFeatureSet

  • Статья

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

Ресурс WindowsOptionalFeatureSet в DSC Windows PowerShell предоставляет механизм включения дополнительных компонентов на целевом узле. Он является составным ресурсом, который вызывает ресурс WindowsOptionalFeature для каждого компонента, указанного в свойстве Name.

Используйте этот ресурс, если нужно настроить одинаковое состояние для нескольких дополнительных компонентов Windows.

Примечание

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

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

Синтаксис

WindowsOptionalFeatureSet [string] #ResourceName
{
    Name = [string[]]
    [ RemoveFilesOnDisable = [bool] ]
    [ LogPath = [string] ]
    [ NoWindowsUpdateCheck = [bool] ]
    [ LogLevel = [string] { ErrorsOnly | ErrorsAndWarning | ErrorsAndWarningAndInformation }  ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Enable | Disable }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Свойства

Свойство Описание
Имя Указывает имена компонентов, которые необходимо включить или отключить.
NoWindowsUpdateCheck Указывает, обращается ли система DISM к Центру обновления Windows при поиске исходных файлов для включения компонентов. Если задано значение $true, система DISM не обращается к Центру обновления Windows.
RemoveFilesOnDisable Задайте значение $true, чтобы удалить все файлы, связанные с компонентами, когда свойству Ensure присваивается значение Absent.
LogLevel Максимальный уровень результатов, показываемый в журналах. Допустимые значения: ErrorsOnly, ErrorsAndWarning и ErrorsAndWarningAndInformation.
LogPath Путь к файлу журнала, в котором поставщик ресурсов должен вести журнал работы.

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

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

Примечание

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