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 或更高版本。
  • 目标计算机必须有权访问 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

示例