WindowsOptionalFeature

  • 项目

摘要

启用或禁用 Windows 可选功能。

语法

WindowsOptionalFeature [String] #ResourceName
{
    Name = [string]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [LogLevel = [string]{ ErrorsAndWarning | ErrorsAndWarningAndInformation | ErrorsOnly }]
    [LogPath = [string]]
    [NoWindowsUpdateCheck = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [RemoveFilesOnDisable = [bool]]
}

说明

资源 WindowsOptionalFeature 允许你确保 Windows 可选功能是在 Windows 客户端计算机上启用或禁用的。 若要管理 Windows Server 的角色和功能，请使用 WindowsFeature 资源。

要求

  • 目标计算机必须运行 Windows 客户端操作系统、Windows Server 2012或更高版本或 Nano Server。
  • 目标计算机必须有权访问 DISM PowerShell 模块

键属性

名称

将 Windows 可选功能的名称指定为字符串。

此属性的此值应与 Windows 可选功能的 FeatureName 属性相同。 若要列出计算机的可用可选功能，请使用 Get-WindowsOptionalFeature cmdlet。

Type: System.String

可选属性

Ensure

指定是否应启用 Windows 可选功能。 将此属性设置为 Present 在禁用 Windows 可选功能时启用。 将此属性设置为 Absent 禁用 Windows 可选功能（如果已启用）。

默认值为 Present。

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

LogLevel

指定要在 DISM 日志中显示为字符串的输出信息。 有效选项包括：

  • ErrorsOnly - 资源仅记录错误。
  • ErrorsAndWarning - 资源记录错误和警告。
  • ErrorsAndWarningAndInformation - 资源记录错误、警告和调试信息。

默认值为 ErrorsAndWarningAndInformation。

Type: System.String
Accepted Values:
  - ErrorsOnly
  - ErrorsAndWarning
  - ErrorsAndWarningAndInformation
Default Value: ErrorsAndWarningAndInformation

LogPath

指定要记录启用或禁用 Windows 可选功能的文件的路径。

如果未设置，资源会将日志 %WINDIR%\Logs\Dism\dism.log写入到 。

Type: System.String
Default Value: None

NoWindowsUpdateCheck

指定在搜索源文件以启用 Windows 可选功能时，DISM 联系人是否Windows Update (WU) 。 将此属性设置为 $true 防止 DISM 与 WU 联系。

默认值为 $false。

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

指定资源是否应在禁用 Windows 可选功能时删除与 Windows 可选功能关联的所有文件。 将此属性设置为 $true 删除所有关联的文件。

默认值为 $false。

Type: System.Boolean
Default Value: false

只读属性

CustomProperties

Windows 可选功能的自定义属性作为字符串数组。

Type: System.String[]

说明

Windows 可选功能的说明为字符串。

Type: System.String

DisplayName

Windows 可选功能的显示名称作为字符串。

Type: System.String

示例