DSC-WindowsFeature-ResourceDSC WindowsFeature Resource

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

De WindowsFeature resource in Windows PowerShell Desired State Configuration (DSC) biedt een mechanisme om ervoor te zorgen dat functies en onderdelen worden toegevoegd of verwijderd in een doelknooppunt.The WindowsFeature resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to ensure that roles and features are added or removed on a target node.

SyntaxisSyntax

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

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
NaamName Hiermee geeft u de naam van de rol of functie die u wilt zorgen toegevoegd of verwijderd.Indicates the name of the role or feature that you want to ensure is added or removed. Dit is hetzelfde als de naam eigenschap uit de Get-WindowsFeature cmdlet, en niet de weergavenaam van de rol of functie.This is the same as the Name property from the Get-WindowsFeature cmdlet, and not the display name of the role or feature.
referentieCredential Hiermee geeft u de referenties toevoegen of verwijderen van de rol of functie.Indicates the credentials to use to add or remove the role or feature.
Zorg ervoor datEnsure Hiermee wordt aangegeven of de rol of functie is toegevoegd.Indicates if the role or feature is added. Om ervoor te zorgen dat de rol of functie is toegevoegd, stel deze eigenschap in op 'Aanwezig' om ervoor te zorgen dat de rol of functie wordt verwijderd, de eigenschap instellen op 'Afwezig'.To ensure that the role or feature is added, set this property to "Present" To ensure that the role or feature is removed, set the property to "Absent".
IncludeAllSubFeatureIncludeAllSubFeature Deze eigenschap instellen op $true om te controleren of de status van alle vereiste subonderdelen met de status van de functie die u met opgeeft de naam eigenschap.Set this property to $true to ensure the state of all required subfeatures with the state of the feature you specify with the Name property.
LogboekpadLogPath Geeft het pad naar een logboekbestand waar u de resourceprovider aan te melden van de bewerking.Indicates the path to a log file where you want the resource provider to log the operation.
dependsOnDependsOn Hiermee wordt aangegeven dat de configuratie van een andere resource uitvoeren moet voordat deze bron is geconfigureerd.Indicates that the configuration of another resource must run before this resource is configured. Bijvoorbeeld, als de ID van de resourceconfiguratie scriptblok die u wilt uitvoeren eerst is ResourceName en het type ResourceType, de syntaxis voor het gebruik van deze eigenschap is DependsOn = "[ResourceType]ResourceName".For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
BronSource Geeft de locatie van het bronbestand moet worden gebruikt voor de installatie, indien nodig.Indicates the location of the source file to use for installation, if necessary.

VoorbeeldExample

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
}