WindowsOptionalFeatureSet

Artikel
05/05/2023

Übersicht

Verwalten mehrerer optionaler Windows-Features mit allgemeinen Einstellungen.

Syntax

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

BESCHREIBUNG

Mit der WindowsOptionalFeatureSet zusammengesetzten Ressource können Sie mehrere optionale Windows-Features konfigurieren. Zum Konfigurieren eines optionalen Windows-Features verwenden Sie die WindowsOptionalFeature-Ressource. Um die Rollen und Features eines Windows Server zu verwalten, verwenden Sie die WindowsFeature-Ressource.

Requirements (Anforderungen)

Der Zielcomputer muss ein Windows-Clientbetriebssystem, Windows Server 2012 oder höher oder Nano Server ausführen.
Der Zielcomputer muss Zugriff auf das DISM PowerShell-Modul haben.

Schlüsseleigenschaften

Name

Geben Sie die Namen der optionalen Windows-Features als Array von Zeichenfolgen an.

Jeder Wert für diese Eigenschaft sollte identisch mit der FeatureName-Eigenschaft eines optionalen Windows-Features sein. Verwenden Sie zum Auflisten der verfügbaren optionalen Features für einen Computer das Get-WindowsOptionalFeature Cmdlet.

Type: System.String[]

Optionale Eigenschaften

Ensure

Geben Sie an, ob die optionalen Windows-Features aktiviert werden sollen. Legen Sie diese Eigenschaft fest, um Present die optionalen Windows-Features zu aktivieren. Legen Sie diese Eigenschaft fest, um Absent die optionalen Windows-Features zu deaktivieren.

Standardwert: Present.

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

LogLevel

Geben Sie die Ausgabeinformationen an, die im DISM-Protokoll als Zeichenfolge angezeigt werden sollen. Gültige Optionen:

ErrorsOnly - Die Ressource protokolliert nur Fehler.
ErrorsAndWarning - Die Ressourcen protokolliert Fehler und Warnungen.
ErrorsAndWarningAndInformation - Die Ressourcenprotokolle Fehler, Warnungen und Debuginformationen.

Standardwert: ErrorsAndWarningAndInformation.

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

LogPath

Geben Sie den Pfad zu einer Datei an, um das Aktivieren oder Deaktivieren der optionalen Windows-Features zu protokollieren.

Wenn nicht festgelegt, schreibt die Ressource das Protokoll in %WINDIR%\Logs\Dism\dism.log.

Type: System.String
Default Value: None

NoWindowsUpdateCheck

Geben Sie an, ob DISM-Kontakte Windows Update (WU) beim Suchen nach den Quelldateien zum Aktivieren der optionalen Windows-Features verwenden. Legen Sie diese Eigenschaft fest, um $true zu verhindern, dass DISM sich an WU wenden kann.

Standardwert: $false.

Type: System.Boolean
Default Value: false

RemoveFilesOnDisable

Geben Sie an, ob die Ressource alle Dateien entfernen soll, die den optionalen Windows-Features zugeordnet sind, wenn Sie sie deaktivieren. Legen Sie diese Eigenschaft fest, $true um alle zugeordneten Dateien zu entfernen.

Der Standardwert ist $false.

Type: System.Boolean
Default Value: false

Freigeben über