DSC ServiceSet-erőforrás

Érintett kiadások: Windows PowerShell 4.0, Windows PowerShell 5.x

A Windows PowerShell Desired State Configuration (DSC) ServiceSet-erőforrása egy mechanizmust biztosít a célcsomópont szolgáltatásainak kezelésére. Ez az erőforrás egy összetett erőforrás , amely meghívja a Szolgáltatás erőforrást a Name tulajdonságban megadott minden egyes szolgáltatáshoz.

Ezt az erőforrást akkor használja, ha több 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

ServiceSet [string] #ResourceName
{
    Name = [string[]]
    [ StartupType = [string] { Automatic | Disabled | Manual }  ]
    [ BuiltInAccount = [string] { LocalService | LocalSystem | NetworkService }  ]
    [ State = [string] { Running | Stopped }  ]
    [ Credential = [PSCredential] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Tulajdonságok

Tulajdonság	Leírás
Name (Név)	A szolgáltatásneveket jelzi. Vegye figyelembe, hogy ez néha eltér a megjelenített nevektől. A parancsmaggal Get-Service lekérheti a szolgáltatások listáját és aktuális állapotát.
StartupType	A szolgáltatások indítási típusát jelzi. A tulajdonsághoz engedélyezett értékek a következők: Automatikus, Letiltott és Kézi.
BuiltInAccount	A szolgáltatásokhoz használandó bejelentkezési fiókot jelzi. A tulajdonsághoz engedélyezett értékek a következők: LocalService, LocalSystem és NetworkService.
Állapot	Azt az állapotot jelzi, amelyet biztosítani szeretne a szolgáltatásokhoz: Leállítva vagy Fut.
Hitelesítő adat	A szolgáltatáserőforrás által futtatott fiók hitelesítő adatait jelzi. Ez a tulajdonság és a BuiltinAccount tulajdonság nem használható együtt.

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 szolgáltatások léteznek-e a rendszeren. Állítsa ezt a tulajdonságot a Hiányzó értékre, és győződjön meg arról, hogy a szolgáltatások nem léteznek. A Megjelenítés értékre állítása biztosítja a célszolgáltatások meglétét. 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ó elindítja a "Windows Audio" és a "Távoli asztali szolgáltatások" szolgáltatásokat.

configuration ServiceSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {
        ServiceSet ServiceSetExample
        {
            Name        = @("TermService", "Audiosrv")
            StartupType = "Manual"
            State       = "Running"
        }
    }
}