DSC ServiceSet-resursDSC ServiceSet Resource

Gäller för: Windows PowerShell 4,0, Windows PowerShell 5. xApplies To: 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.The ServiceSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage services on the target node. Den här resursen är en sammansatt resurs som anropar tjänst resursen för varje tjänst som anges i egenskapen Name .This resource is a composite resource that calls the Service resource for each service specified in the Name property.

Använd den här resursen när du vill konfigurera ett antal tjänster till samma tillstånd.Use this resource when you want to configure a number of services to the same state.

Anteckning

Den här dokumentationen av DSC-resursen omfattar den version som ingår i PowerShell.This documentation of this DSC resource covers the version that is included with PowerShell. PSDscResources -modulen innehåller nya och uppdaterade som officiellt stöds av Microsoft.The PSDscResources module contains new and updated that are officially supported by Microsoft. PSDscResources -modulen är tillgänglig från PowerShell-galleriet.The PSDscResources module is available from the PowerShell Gallery.

Mer information och uppdaterad dokumentation finns i README i GitHub-lagringsplatsen.For more information and updated documentation, see the README in the GitHub repository.

SyntaxSyntax

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

EgenskaperProperties

EgenskapProperty BeskrivningDescription
NamnName Anger tjänst namn.Indicates the service names. Observera att ibland skiljer det sig från visnings namnen.Note that sometimes this is different from the display names. Du kan hämta en lista över tjänsterna och deras aktuella status med Get-Service cmdleten.You can get a list of the services and their current state with the Get-Service cmdlet.
Startuptype tjänstStartupType Anger start typen för tjänsterna.Indicates the startup type for the services. De värden som tillåts för den här egenskapen är: Automatisk , inaktive rad och manuell .The values that are allowed for this property are: Automatic , Disabled , and Manual .
BuiltInAccountBuiltInAccount Anger det inloggnings konto som ska användas för tjänsterna.Indicates the sign-in account to use for the services. De värden som tillåts för den här egenskapen är: LocalService , LocalSystem och NetworkService .The values that are allowed for this property are: LocalService , LocalSystem , and NetworkService .
TillståndState Anger det tillstånd som du vill säkerställa för tjänsterna: stoppas eller körs .Indicates the state you want to ensure for the services: Stopped or Running .
AutentiseringsuppgiftCredential Anger autentiseringsuppgifter för det konto som tjänst resursen kommer att köras under.Indicates credentials for the account that the service resource will run under. Den här egenskapen och egenskapen BuiltinAccount kan inte användas tillsammans.This property and the BuiltinAccount property cannot be used together.

Gemensamma egenskaperCommon properties

EgenskapProperty BeskrivningDescription
DependsOnDependsOn Anger att konfigurationen av en annan resurs måste köras innan den här resursen har kon figurer ATS.Indicates that the configuration of another resource must run before this resource is configured. Exempel: om ID: t för skript blocket för resurs konfigurationen som du vill köra först är ResourceName och dess typ är ResourceType, är syntaxen för att använda den här egenskapen DependsOn = "[ResourceType]ResourceName" .For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".
KontrolEnsure Anger om tjänsterna finns i systemet.Indicates whether the services exist on the system. Ange den här egenskapen som saknas för att säkerställa att tjänsterna inte finns.Set this property to Absent to ensure that the services do not exist. Att ställa in det för att Visa garanterar att mål tjänsterna finns.Setting it to Present ensures that target services exist. Standardvärdet finns .The default value is Present .
PsDscRunAsCredentialPsDscRunAsCredential Anger autentiseringsuppgifter för att köra hela resursen som.Sets the credential for running the entire resource as.

Anteckning

Den gemensamma egenskapen PsDscRunAsCredential har lagts till i WMF 5,0 för att tillåta körning av DSC-resurser i kontexten för andra autentiseringsuppgifter.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. Mer information finns i använda autentiseringsuppgifter med DSC-resurser.For more information, see Use Credentials with DSC Resources.

ExempelExample

Följande konfiguration startar tjänsterna Windows Audio och Fjärrskrivbordstjänster.The following configuration starts the "Windows Audio" and "Remote Desktop Services" services.

configuration ServiceSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Node localhost
    {
        ServiceSet ServiceSetExample
        {
            Name        = @("TermService", "Audiosrv")
            StartupType = "Manual"
            State       = "Running"
        }
    }
}