WindowsFeature

  • Artikel

Übersicht

Installieren oder Deinstallieren einer Windows-Rolle oder eines Features.

Syntax

WindowsFeature [String] #ResourceName
{
    Name = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Ensure = [string]{ Absent | Present }]
    [IncludeAllSubFeature = [bool]]
    [LogPath = [string]]
    [PsDscRunAsCredential = [PSCredential]]
}

BESCHREIBUNG

Mit der WindowsFeature Ressource können Sie sicherstellen, ob eine Windows-Rolle oder ein Feature auf einem Windows Server installiert ist. Verwenden Sie zum Verwalten eines Clientcomputers die WindowsOptionalFeature-Ressource.

Requirements (Anforderungen)

  • Der Zielcomputer muss Windows Server 2008 oder höher ausführen.
  • Der Zielcomputer muss Zugriff auf das DISM PowerShell-Modul haben.
  • Der Zielcomputer muss Zugriff auf das ServerManager PowerShell-Modul haben.

Eigenschaften

Schlüsseleigenschaften

Name

Geben Sie den Namen der Rolle oder des Features als Zeichenfolge an.

Dieser Wert für diese Eigenschaft sollte identisch mit der Name-Eigenschaft der Rolle oder des Features sein, nicht die DisplayName-Eigenschaft . Um die verfügbaren Rollen und Features für einen Computer auflisten zu können, verwenden Sie das Get-WindowsFeature Cmdlet.

Type: System.String

Optionale Eigenschaften

Anmeldeinformationen

Geben Sie die Anmeldeinformationen für ein Konto an, um die Rolle oder das Feature hinzuzufügen oder zu entfernen.

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

Geben Sie an, ob die Rolle oder das Feature installiert werden soll. Legen Sie diese Eigenschaft fest, Present um die Rolle oder das Feature zu installieren, wenn sie nicht installiert ist. Legen Sie diese Eigenschaft fest, Absent um die Rolle oder das Feature zu deinstallieren, wenn sie installiert ist.

Standardwert: Present.

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

IncludeAllSubFeature

Geben Sie an, ob jedes Unterfeature des Features oder der Rolle installiert werden soll. Legen Sie diese Eigenschaft fest, $true um fehlende Unterfeatures zu installieren. Legen Sie diese Eigenschaft fest, $false um Unterfeatures zu ignorieren. Unabhängig von der Einstellung dieser Eigenschaft entfernt die Ressource alle Unterfeatures, wenn "Sicherstellen " festgelegt Absentist.

Standardwert: $false.

Type: System.Boolean
Behavior: Write
Default Value: false

LogPath

Geben Sie den Pfad zu einer Datei an, um die Installation oder Deinstallation des Features oder der Rolle zu protokollieren.

Type: System.String
Default Value: None

Schreibgeschützte Eigenschaften

DisplayName

Der Anzeigename der abgerufenen Rolle oder des Features.

Type: System.String

Beispiele