DSC WindowsFeatureSet-erőforrásDSC WindowsFeatureSet Resource

A következőkre vonatkozik: Windows PowerShell 5. xApplies To: Windows PowerShell 5.x

A Windows PowerShell desired State Configuration (DSC) WindowsFeatureSet erőforrása egy olyan mechanizmust biztosít, amely biztosítja, hogy a szerepkörök és szolgáltatások hozzá legyenek adva vagy el lesznek távolítva egy adott csomóponton.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. Ez az erőforrás egy összetett erőforrás , amely meghívja a WindowsFeature-erőforrást a Name (név ) tulajdonságban megadott egyes szolgáltatásokhoz.This resource is a composite resource that calls the WindowsFeature resource for each feature specified in the Name property.

Ezt az erőforrást akkor használja, ha több Windows-szolgáltatást szeretne konfigurálni ugyanahhoz az állapothoz.Use this resource when you want to configure a number of Windows Features to the same state.

SyntaxSyntax

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

TulajdonságokProperties

TulajdonságProperty LeírásDescription
NévName Azoknak a szerepköröknek vagy szolgáltatásoknak a nevét adja hozzá vagy távolítja el, amelyeket biztosítani kíván.The names of the roles or features that you want to ensure are added or removed. Ez ugyanaz, mint a Get-WindowsFeature parancsmag Name tulajdonsága, és nem a szerepkörök vagy szolgáltatások megjelenítendő neve.This is the same as the Name property of the Get-WindowsFeature cmdlet, and not the display name of the roles or features.
ForrásSource A telepítéshez használandó forrásfájl helyét jelzi, ha szükséges.Indicates the location of the source file to use for installation, if necessary.
IncludeAllSubFeatureIncludeAllSubFeature Ezt a tulajdonságot úgy állítsa be, hogy a $true Name (név ) tulajdonsággal megadott funkciókkal együtt tartalmazza az összes szükséges alszolgáltatást.Set this property to $true to include all required subfeatures with of the features you specify with the Name property.
Hitelesítő adatCredential A szerepkörök vagy szolgáltatások hozzáadásához vagy eltávolításához használandó hitelesítő adatok.The credentials to use to add or remove the roles or features.
LogPathLogPath A naplófájl elérési útja, amelyen az erőforrás-szolgáltató naplózni kívánja a műveletet.The path to a log file where you want the resource provider to log the operation.

Közös tulajdonságokCommon properties

TulajdonságProperty LeírásDescription
DependsOnDependsOn Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt.Indicates that the configuration of another resource must run before this resource is configured. Ha például az az erőforrás-konfigurációs parancsfájl blokkja, amelyet először szeretne futtatni, ResourceName, és a típusa ResourceType, a tulajdonság használatának szintaxisa a következő: 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".
BiztosításaEnsure Azt jelzi, hogy a szerepkörök vagy szolgáltatások hozzá lettek-e adva.Indicates whether the roles or features are added. A szerepkörök vagy szolgáltatások hozzáadásának biztosításához állítsa be ezta tulajdonságot.To ensure that the roles or features are added, set this property to Present. A szerepkörök vagy szolgáltatások eltávolításának biztosításához állítsa a tulajdonságot hiányzóértékre.To ensure that the roles or features are removed, set the property to Absent. Az alapértelmezett érték jelenvan.The default value is Present.
PsDscRunAsCredentialPsDscRunAsCredential Beállítja a teljes erőforrás futtatásához használt hitelesítő adatokat.Sets the credential for running the entire resource as.

Megjegyzés

A PsDscRunAsCredential Common tulajdonsága a WMF 5,0-ben lett hozzáadva, hogy bármely DSC-erőforrást más hitelesítő adatok kontextusában futtasson.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. További információ: a hitelesítő adatok használata a DSC-erőforrásokkal.For more information, see Use Credentials with DSC Resources.

PéldaExample

A következő konfiguráció biztosítja, hogy a webkiszolgáló (IIS) és az SMTP-kiszolgáló szolgáltatásai, valamint mindegyik alszolgáltatása telepítve legyen.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
        }
    }
}