DSC WindowsFeature-resource

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.x

De WindowsFeature-resource in Windows PowerShell Desired State Configuration (DSC) biedt een mechanisme om ervoor te zorgen dat rollen en functies worden toegevoegd of verwijderd op een doelknooppunt.

Notitie

Deze documentatie van deze DSC-resource heeft betrekking op de versie die is opgenomen in PowerShell vóór versie 7.2. De PSDscResources-module bevat nieuwe en bijgewerkte DSC-resources die officieel worden ondersteund door Microsoft. De psdscResources-module is beschikbaar via de PowerShell Gallery.

Zie de psdscResources-referentiedocumentatie voor meer informatie en bijgewerkte documentatie.

Syntax

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

Eigenschappen

Eigenschap	Beschrijving
Naam	Geeft de naam aan van de rol of functie die u wilt toevoegen of verwijderen. Dit is hetzelfde als de eigenschap Name van de cmdlet Get-WindowsFeature en niet de weergavenaam van de rol of functie.
Referentie	Geeft de referenties aan die moeten worden gebruikt om de rol of functie toe te voegen of te verwijderen.
IncludeAllSubFeature	Stel deze eigenschap in op $true om de status van alle vereiste subfuncties te controleren met de status van de functie die u opgeeft met de eigenschap Naam .
Logboekpad	Geeft het pad aan naar een logboekbestand waar de resourceprovider de bewerking moet vastleggen.

Algemene eigenschappen

Eigenschap	Beschrijving
DependsOn	Geeft aan dat de configuratie van een andere resource moet worden uitgevoerd voordat deze resource wordt geconfigureerd. Als de id van het resourceconfiguratiescriptblok dat u als eerste wilt uitvoeren bijvoorbeeld ResourceName is en het type ResourceType is, is DependsOn = "[ResourceType]ResourceName"de syntaxis voor het gebruik van deze eigenschap .
Verifiëren	Geeft aan of de rol of functie is toegevoegd. Stel deze eigenschap in op Presenteren om ervoor te zorgen dat de rol of functie wordt toegevoegd. Stel de eigenschap in op Afwezig om ervoor te zorgen dat de rol of functie wordt verwijderd. De standaardwaarde is Aanwezig.
PsDscRunAsCredential	Hiermee stelt u de referentie voor het uitvoeren van de hele resource als in.

Notitie

De algemene eigenschap PsDscRunAsCredential is toegevoegd in WMF 5.0 om het uitvoeren van een DSC-resource in de context van andere referenties toe te staan. Zie Referenties gebruiken met DSC-resources voor meer informatie.

Voorbeeld

WindowsFeature RoleExample
{
    Ensure = "Present"
    # Alternatively, to ensure the role is uninstalled, set Ensure to "Absent"
    Name = "Web-Server" # Use the Name property from Get-WindowsFeature
}