DSC-WindowsFeatureSet ResourceDSC WindowsFeatureSet Resource

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

De WindowsFeatureSet 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 WindowsFeatureSet 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. Deze bron is een samengestelde bron die roept de WindowsFeature resource voor elke functie die is opgegeven in de Name eigenschap.This resource is a composite resource that calls the WindowsFeature resource for each feature specified in the Name property.

Gebruik deze bron als u wilt configureren, een aantal functies van Windows naar dezelfde toestand.Use this resource when you want to configure a number of Windows Features to the same state.

SyntaxisSyntax

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

}

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
NaamName De namen van de functies of onderdelen die u wilt zorgen worden toegevoegd of verwijderd.The names of the roles or features that you want to ensure are added or removed. Dit is hetzelfde als de naam eigenschap van de Get-WindowsFeature cmdlet, en niet de weergavenaam van de functies of onderdelen.This is the same as the Name property of the Get-WindowsFeature cmdlet, and not the display name of the roles or features.
referentieCredential De referenties toevoegen of verwijderen van de functies of onderdelen.The credentials to use to add or remove the roles or features.
Zorg ervoor datEnsure Hiermee wordt aangegeven of de functies of onderdelen worden toegevoegd.Indicates whether the roles or features are added. Om ervoor te zorgen dat de functies of onderdelen zijn toegevoegd, stel deze eigenschap in op 'Aanwezig' om ervoor te zorgen dat de functies of onderdelen zijn verwijderd, de eigenschap instellen op 'Afwezig'.To ensure that the roles or features are added, set this property to "Present" To ensure that the roles or features are removed, set the property to "Absent".
IncludeAllSubFeatureIncludeAllSubFeature Deze eigenschap instellen op $true om op te nemen van alle vereiste subonderdelen met van de functies die u met opgeeft de naam eigenschap.Set this property to $true to include all required subfeatures with of the features you specify with the Name property.
LogboekpadLogPath Het pad naar een logboekbestand waar u de resourceprovider aan te melden van de bewerking.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

De volgende configuratie zorgt ervoor dat de webserver (IIS) en SMTP-Server functies en alle subfuncties van elke, worden geïnstalleerd.The following configuration ensures that the Web-Server (IIS) and SMTP Server features, and all subfeatures of each, are installed.

configuration FeatureSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Node localhost
    {

        WindowsFeatureSet WindowsFeatureSetExample
        {
            Name                    = @("SMTP-Server", "Web-Server")
            Ensure                  = 'Present'
            IncludeAllSubFeature    = $true
        }
    }
}