DSC WindowsFeatureSet erőforrás

Érintett kiadások: Windows PowerShell 5.x

Az Windows PowerShell Desired State Configuration (DSC) WindowsFeatureSet erőforrása egy mechanizmust biztosít a szerepkörök és szolgáltatások célcsomóponton való hozzáadásához vagy eltávolításához. Ez az erőforrás egy összetett erőforrás , amely meghívja a WindowsFeature erőforrást a Name tulajdonságban megadott minden egyes funkcióhoz.

Ezt az erőforrást akkor használja, ha több Windows-szolgáltatást szeretne ugyanabban az állapotban konfigurálni.

Megjegyzés

A DSC-erőforrás dokumentációja a PowerShell 7.2-es verzió előtti verzióját ismerteti. A PSDscResources modul a Microsoft által hivatalosan támogatott új és frissített DSC-erőforrásokat tartalmaz. A PSDscResources modul a PowerShell-galéria érhető el.

További információkért és a frissített dokumentációért tekintse meg a PSDscResources referenciadokumentációját.

Syntax

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

Tulajdonságok

Tulajdonság	Leírás
Name (Név)	Azoknak a szerepköröknek vagy szolgáltatásoknak a nevét, amelyeket biztosítani szeretne, hozzáadják vagy eltávolítják. Ez megegyezik a Get-WindowsFeature parancsmag Name (Név) tulajdonságával, és nem a szerepkörök vagy szolgáltatások megjelenítendő nevével.
Forrás	A telepítéshez használandó forrásfájl helyét jelzi, ha szükséges.
IncludeAllSubFeature	Állítsa be ezt a tulajdonságot $true úgy, hogy az tartalmazza az összes szükséges altulajdonságot a Name tulajdonsággal megadott funkciókkal.
Hitelesítő adat	A szerepkörök vagy szolgáltatások hozzáadásához vagy eltávolításához használandó hitelesítő adatok.
LogPath	Egy naplófájl elérési útja, ahol azt szeretné, hogy az erőforrás-szolgáltató naplózza a műveletet.

Közös tulajdonságok

Tulajdonság	Leírás
DependsOn	Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt. Ha például az először futtatni kívánt erőforrás-konfigurációs szkriptblokk azonosítója ResourceName, és a típusa ResourceType, akkor a tulajdonság használatának szintaxisa a következő DependsOn = "[ResourceType]ResourceName": .
Biztosítja	Azt jelzi, hogy a szerepkörök vagy szolgáltatások hozzá lettek-e adva. A szerepkörök vagy szolgáltatások hozzáadásának biztosításához állítsa ezt a tulajdonságot Bemutató értékre. 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. Az alapértelmezett érték a Jelenik.
PsDscRunAsCredential	Beállítja a teljes erőforrás futtatásához szükséges hitelesítő adatokat.

Megjegyzés

A PsDscRunAsCredential közös tulajdonság hozzáadva a WMF 5.0-hoz, hogy bármely DSC-erőforrást más hitelesítő adatok kontextusában futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.

Példa

Az alábbi konfiguráció biztosítja, hogy a webkiszolgáló (IIS) és az SMTP-kiszolgáló funkciói, valamint mindegyik alfunkciója telepítve legyen.

configuration FeatureSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {

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