DSC WindowsFeature erőforrás

A következőkre vonatkozik: Windows PowerShell 4.0, Windows PowerShell 5.x

A WindowsFeature erőforrás a Windows PowerShell Desired State Configuration (DSC) szolgáltatásban egy olyan mechanizmust biztosít, amellyel biztosítható, hogy a szerepkörök és szolgáltatások hozzá legyenek adva vagy eltávolítva legyenek a célcsomóponton.

Megjegyzés

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

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

Syntax

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

Tulajdonságok

Tulajdonság	Leírás
Name (Név)	Annak a szerepkörnek vagy szolgáltatásnak a nevét jelzi, amelyet biztosítani szeretne a hozzáadáshoz vagy az eltávolításhoz. Ez ugyanaz, mint a Get-WindowsFeature parancsmag Name tulajdonsága, és nem a szerepkör vagy szolgáltatás megjelenítendő neve.
Hitelesítő adat	A szerepkör vagy szolgáltatás hozzáadásához vagy eltávolításához használandó hitelesítő adatokat jelzi.
IncludeAllSubFeature	Állítsa be ezt a tulajdonságot úgy, hogy $true biztosítsa az összes szükséges altevékenység állapotát a Name (Név ) tulajdonsággal megadott funkció állapotával.
LogPath	Egy naplófájl elérési útját jelzi, 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 típusa ResourceType, akkor a tulajdonság használatának szintaxisa a DependsOn = "[ResourceType]ResourceName"következő: .
Biztosítja	Azt jelzi, hogy a szerepkör vagy szolgáltatás hozzáadva van-e. A szerepkör vagy szolgáltatás hozzáadásának biztosításához állítsa ezt a tulajdonságot Present (Bemutató) értékre. A szerepkör vagy szolgáltatás eltávolításának biztosításához állítsa a tulajdonságot Hiányzó értékre. Az alapértelmezett érték a Jelen.
PsDscRunAsCredential	Beállítja a hitelesítő adatokat a teljes erőforrás futtatásához.

Megjegyzés

A PsDscRunAsCredential common tulajdonság hozzá lett adva a WMF 5.0-s verziójához, hogy bármely DSC-erőforrást más hitelesítő adatokkal összefüggésben futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.

Példa

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
}