WindowsFeatureSet

  • 项目

摘要

使用常用设置管理多个 Windows 角色或功能。

语法

WindowsFeatureSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Name = [String[]]
    [Ensure = [String]]
    [Source = [String]]
    [IncludeAllSubFeature = [Boolean]]
    [Credential = [PSCredential]]
    [LogPath = [String]]
}

说明

利用该 WindowsFeatureSet 资源，可以使用一组有限的常见选项配置多个 Windows 角色或功能。 若要管理具有更多控制权的角色或功能，请使用 WindowsFeature 资源。 若要管理客户端计算机，请使用 WindowsOptionalFeature 资源。

要求

  • 目标计算机必须运行 Windows Server 2008 或更高版本。
  • 目标计算机必须有权访问 DISM PowerShell 模块。
  • 目标计算机必须有权访问 ServerManager PowerShell 模块。

属性

密钥属性

名称

将角色或特征的名称指定为字符串数组。

此属性的值应与每个角色或功能的 Name 属性相同，而不是其 DisplayName 属性。 若要列出计算机的可用角色和功能，请使用 Get-WindowsFeature cmdlet。

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
Behavior: Read

示例