WindowsOptionalFeatureSet

项目
05/05/2023

摘要

使用常用设置管理多个 Windows 可选功能。

语法

WindowsOptionalFeatureSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Name = [String[]]
    Ensure = [String]
    [RemoveFilesOnDisable = [Boolean]]
    [NoWindowsUpdateCheck = [Boolean]]
    [LogPath = [String]]
    [LogLevel = [String]]
}

说明

使用 WindowsOptionalFeatureSet 复合资源可以配置多个 Windows 可选功能。若要一次配置一个 Windows 可选功能，请使用 WindowsOptionalFeature 资源。若要管理 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 删除所有关联的文件。