Freigeben über

WindowsOptionalFeature

  • Artikel

Übersicht

Aktivieren oder Deaktivieren eines optionalen Windows-Features.

Syntax

WindowsOptionalFeature [String] #ResourceName
{
    Name = [string]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [LogLevel = [string]{ ErrorsAndWarning | ErrorsAndWarningAndInformation | ErrorsOnly }]
    [LogPath = [string]]
    [NoWindowsUpdateCheck = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
    [RemoveFilesOnDisable = [bool]]
}

BESCHREIBUNG

Mit der WindowsOptionalFeature Ressource können Sie sicherstellen, ob ein optionales Windows-Feature auf einem Windows-Clientcomputer aktiviert oder deaktiviert ist. 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.
  • Zielcomputer muss Zugriff auf das DISM PowerShell-Modul haben

Schlüsseleigenschaften

Name

Geben Sie den Namen des optionalen Windows-Features als Zeichenfolge an.

Dieser Wert für diese Eigenschaft sollte identisch mit der FeatureName-Eigenschaft des 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 das optionale Windows-Feature aktiviert werden soll. Legen Sie diese Eigenschaft fest, Present um das optionale Windows-Feature zu aktivieren, wenn sie deaktiviert ist. Legen Sie diese Eigenschaft fest, Absent um das optionale Windows-Feature zu deaktivieren, wenn sie aktiviert ist.

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 des 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 des 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 dem optionalen Windows-Feature zugeordnet sind, wenn Sie sie deaktivieren. Legen Sie diese Eigenschaft fest, $true um alle zugeordneten Dateien zu entfernen.

Standardwert: $false.

Type: System.Boolean
Default Value: false

Schreibgeschützte Eigenschaften

CustomProperties

Die benutzerdefinierten Eigenschaften des windows-Optionalfeatures als Array von Zeichenfolgen.

Type: System.String[]

Beschreibung

Die Beschreibung des optionalen Windows-Features als Zeichenfolge.

Type: System.String

DisplayName

Der Anzeigename des optionalen Windows-Features als Zeichenfolge.

Type: System.String

Beispiele