DSC-szolgáltatás erőforrása

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

A Windows PowerShell Desired State Configuration szolgáltatáserőforrása (DSC) egy mechanizmust biztosít a célcsomópont szolgáltatásainak kezeléséhez.

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

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

Tulajdonságok

Tulajdonság	Leírás
Name (Név)	A szolgáltatás nevét jelzi. Vegye figyelembe, hogy ez néha eltér a megjelenített névtől. A parancsmaggal Get-Service lekérheti a szolgáltatások listáját és aktuális állapotát.
BuiltInAccount	A szolgáltatáshoz használni kívánt bejelentkezési fiókot jelzi. A tulajdonsághoz engedélyezett értékek a következők: LocalService, LocalSystem és NetworkService.
Hitelesítő adat	A szolgáltatás által futtatott fiók hitelesítő adatait jelzi. Ez a tulajdonság és a BuiltinAccount tulajdonság nem használható együtt.
StartupType	A szolgáltatás indítási típusát jelzi. A tulajdonsághoz engedélyezett értékek a következők: Automatikus, Letiltott és Manuális.
Állapot	A szolgáltatáshoz biztosítani kívánt állapotot jelzi. Az értékek a következők: Futtatás vagy Leállítva.
Függőségek	A szolgáltatásnak rendelkeznie kell függőségek nevének tömbje.
Leírás	A célszolgáltatás leírását jelzi.
DisplayName	A célszolgáltatás megjelenítendő nevét jelzi.
Elérési út	Egy új szolgáltatás bináris fájljának elérési útját jelzi.

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 célszolgáltatás létezik-e a rendszeren. Állítsa ezt a tulajdonságot Hiányzó értékre, hogy a célszolgáltatás ne legyen létezik. A Jelenlegi értékre állítása biztosítja, hogy a célszolgáltatás létezik. 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

configuration ServiceTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {

        Service ServiceExample
        {
            Name        = "TermService"
            StartupType = "Manual"
            State       = "Running"
        }
    }
}