WindowsFeature

Краткий обзор

Установка или удаление роли или компонента Windows.

Синтаксис

WindowsFeature [String] #ResourceName
{
    Name = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [IncludeAllSubFeature = [bool]]
    [LogPath = [string]]
    [PsDscRunAsCredential = [PSCredential]]
}

Описание

Ресурс WindowsFeature позволяет проверить, установлена ли роль или компонент Windows на windows Server. Для управления клиентским компьютером используйте ресурс WindowsOptionalFeature.

Требования

  • Целевой компьютер должен работать под управлением Windows Server 2008 или более поздней версии.
  • Целевой компьютер должен иметь доступ к модулю PowerShell DISM .
  • Целевой компьютер должен иметь доступ к модулю PowerShell ServerManager .

Элемент Property

свойства ключа;

Имя

Укажите имя роли или компонента в виде строки.

Это значение для этого свойства должно совпадать со свойством Name роли или компонента, а не свойством DisplayName . Чтобы получить список доступных ролей и компонентов для компьютера, используйте Get-WindowsFeature командлет.

Type: System.String

Необязательные свойства

Учетные данные

Укажите учетные данные для учетной записи, чтобы добавить или удалить роль или функцию как.

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

Укажите, должна ли быть установлена роль или компонент. Задайте для этого свойства установку Present роли или компонента, если она не установлена. Установите это свойство, чтобы Absent удалить роль или компонент, если она установлена.

Значение по умолчанию — Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

IncludeAllSubFeature

Укажите, следует ли устанавливать все подподобия компонента или роли. Задайте для этого свойства установку $true отсутствующих подподобий. Задайте для этого свойства значение, чтобы $false игнорировать вложенные параметры. Независимо от параметра этого свойства, ресурс удаляет все подзаготовки, если задано значение Absent"Проверка".

Значение по умолчанию — $false.

Type: System.Boolean
Behavior: Write
Default Value: false

LogPath

Укажите путь к файлу для записи в журнал установки или удаления компонента или роли.

Type: System.String
Default Value: None

Свойства только для чтения

DisplayName

Отображаемое имя полученной роли или компонента.

Type: System.String

Примеры