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 オプション機能を構成できます。一度に 1 つの Windows オプション機能を構成するには、 WindowsOptionalFeature リソースを使用します。 Windows Server の役割と機能を管理するには、 WindowsFeature リソースを使用します。

要件

ターゲットコンピューターは、Windows クライアントオペレーティングシステム、Windows Server 2012以降、または Nano Server を実行している必要があります。
ターゲットコンピューターは 、DISM PowerShell モジュールにアクセスできる必要があります。

キーのプロパティ

名前

文字列の配列として、Windows オプション機能の名前を指定します。

このプロパティの各値は、Windows オプション機能の FeatureName プロパティと同じである必要があります。コンピューターで使用できるオプション機能を一覧表示するには、コマンドレットを Get-WindowsOptionalFeature 使用します。

Type: System.String[]

省略可能なプロパティ

Ensure

Windows のオプション機能を有効にするかどうかを指定します。 Windows のオプション機能を Present 有効にするには、このプロパティを設定します。 Windows オプション機能を Absent 無効にするには、このプロパティを設定します。

既定値は 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

ソースファイルを検索するときに DISM 連絡先がWindows Update (WU) かどうかを指定して、Windows のオプション機能を有効にします。 DISM が WU に $true 接続できないようにするには、このプロパティを設定します。

既定値は $false です。

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

リソースを無効にするときに、Windows オプション機能に関連付けられているすべてのファイルを削除するかどうかを指定します。関連付けられているすべてのファイルを削除するには、 $true このプロパティを設定します。