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
Примеры
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по