WindowsFeature

Synopsis

Installera eller avinstallera en Windows-roll eller -funktion.

Syntax

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

Description

Med resursen WindowsFeature kan du kontrollera om en Windows-roll eller -funktion är installerad på en Windows Server. Om du vill hantera en klientdator använder du resursen WindowsOptionalFeature.

Krav

• Måldatorn måste köra Windows Server 2008 eller senare.
• Måldatorn måste ha åtkomst till DISM PowerShell-modulen.
• Måldatorn måste ha åtkomst till ServerManager PowerShell-modulen.

Egenskaper

Nyckelegenskaper

Name

Ange namnet på rollen eller funktionen som en sträng.

Det här värdet för den här egenskapen ska vara samma som egenskapen Namn för rollen eller funktionen, inte egenskapen DisplayName . Om du vill visa en lista över tillgängliga roller och funktioner för en dator använder du cmdleten Get-WindowsFeature .

Type: System.String

Valfria egenskaper

Autentiseringsuppgift

Ange autentiseringsuppgifterna för ett konto för att lägga till eller ta bort rollen eller funktionen som.

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

Säkerställa

Ange om rollen eller funktionen ska installeras. Ställ in den här egenskapen på Present för att installera rollen eller funktionen om den inte är installerad. Ställ in den här egenskapen på Absent för att avinstallera rollen eller funktionen om den är installerad.

Standardvärdet är Present.

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

IncludeAllSubFeature

Ange om du vill installera varje underfunktion för funktionen eller rollen. Ställ in den här egenskapen på $true för att installera eventuella saknade underfunktioner. Ställ in den här egenskapen på $false för att ignorera underfunktioner. Oavsett den här egenskapens inställning tar resursen bort alla underfunktioner om Se till är inställt på Absent.

Standardvärdet är $false.

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

LogPath

Ange sökvägen till en fil för att logga installationen eller avinstallationen av funktionen eller rollen.

Type: System.String
Default Value: None

Skrivskyddade egenskaper

DisplayName

Visningsnamnet för den hämtade rollen eller funktionen.

Type: System.String

Exempel

• Installera eller avinstallera en Windows-funktion