DSC ServiceSet-resurs

Gäller för: Windows PowerShell 4.0, Windows PowerShell 5.x

ServiceSet-resursen i Windows PowerShell Desired State Configuration (DSC) tillhandahåller en mekanism för att hantera tjänster på målnoden. Den här resursen är en sammansatt resurs som anropar tjänstresursen för varje tjänst som anges i egenskapen Namn .

Använd den här resursen när du vill konfigurera ett antal tjänster till samma tillstånd.

Anteckning

Den här dokumentationen för den här DSC-resursen omfattar den version som ingår i PowerShell före version 7.2. MODULen PSDscResources innehåller nya och uppdaterade DSC-resurser som stöds officiellt av Microsoft. Modulen PSDscResources är tillgänglig från PowerShell-galleriet.

Mer information och uppdaterad dokumentation finns i referensdokumentationen för PSDscResources.

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] ]
}

Egenskaper

Egenskap	Beskrivning
Name	Anger tjänstnamnen. Observera att detta ibland skiljer sig från visningsnamnen. Du kan hämta en lista över tjänsterna och deras aktuella tillstånd med cmdleten Get-Service .
StartupType	Anger starttypen för tjänsterna. De värden som tillåts för den här egenskapen är: Automatisk, Inaktiverad och Manuell.
BuiltInAccount	Anger det inloggningskonto som ska användas för tjänsterna. De värden som tillåts för den här egenskapen är: LocalService, LocalSystem och NetworkService.
Tillstånd	Anger det tillstånd som du vill säkerställa för tjänsterna: Stoppad eller Körs.
Autentiseringsuppgift	Anger autentiseringsuppgifter för det konto som tjänstresursen ska köras under. Den här egenskapen och egenskapen BuiltinAccount kan inte användas tillsammans.

Gemensamma egenskaper

Egenskap	Beskrivning
DependsOn	Anger att konfigurationen av en annan resurs måste köras innan den här resursen har konfigurerats. Om till exempel ID:t för det resurskonfigurationsskriptblock som du vill köra först är ResourceName och dess typ är ResourceType är DependsOn = "[ResourceType]ResourceName"syntaxen för att använda den här egenskapen .
Säkerställa	Anger om tjänsterna finns i systemet. Ställ in den här egenskapen på Frånvarande för att säkerställa att tjänsterna inte finns. Om du ställer in den på Presentera ser du till att det finns måltjänster. Standardvärdet är Present.
PsDscRunAsCredential	Anger autentiseringsuppgifterna för att köra hela resursen som.

Anteckning

Den vanliga egenskapen PsDscRunAsCredential lades till i WMF 5.0 för att tillåta körning av valfri DSC-resurs i kontexten för andra autentiseringsuppgifter. Mer information finns i Använda autentiseringsuppgifter med DSC-resurser.

Exempel

Följande konfiguration startar tjänsterna "Windows Audio" och "Remote Desktop Services".

configuration ServiceSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

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