次の方法で共有

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 使用します。

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

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

既定値は $false です。

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

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

既定値は $false です。

Type: System.Boolean
Default Value: false

読み取り専用プロパティ

CustomProperties

文字列の配列としての Windows オプション機能のカスタム プロパティ。

Type: System.String[]

説明

Windows の省略可能な機能の説明を文字列として指定します。

Type: System.String

DisplayName

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

Type: System.String

例