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 選用功能相關聯的所有檔案。將此屬性設定為 $true ，以移除所有相關聯的檔案。