DSC ServiceSet-ResourceDSC ServiceSet Resource

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

De ServiceSet in Windows PowerShell Desired State Configuration (DSC)-bron biedt een mechanisme voor het beheren van services in het doelknooppunt.The ServiceSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage services on the target node. Deze bron is een samengestelde bron die roept de Service resource voor elke service die is opgegeven in de Name eigenschap.This resource is a composite resource that calls the Service resource for each service specified in the Name property.

Gebruik deze bron als u wilt configureren, een aantal services naar dezelfde toestand.Use this resource when you want to configure a number of services to the same state.

SyntaxisSyntax

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

}

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
NaamName Hiermee geeft u de servicenamen van de.Indicates the service names. Houd er rekening mee dat soms dit van de weergavenamen verschilt.Note that sometimes this is different from the display names. U krijgt een lijst van de services en de huidige staat met de Get-Service cmdlet.You can get a list of the services and their current state with the Get-Service cmdlet.
StartupTypeStartupType Hiermee geeft het opstarttype voor de service.Indicates the startup type for the service. De waarden die zijn toegestaan voor deze eigenschap zijn: automatische, uitgeschakelde, en handmatigThe values that are allowed for this property are: Automatic, Disabled, and Manual
BuiltInAccountBuiltInAccount Hiermee geeft u het aanmeldingsaccount voor de services.Indicates the sign-in account to use for the services. De waarden die zijn toegestaan voor deze eigenschap zijn: LocalService, LocalSystem, en NetworkService.The values that are allowed for this property are: LocalService, LocalSystem, and NetworkService.
StatusState Geeft de status die u wilt zorgen voor de services: gestopt of met.Indicates the state you want to ensure for the services: Stopped or Running.
Zorg ervoor datEnsure Geeft aan of de services op het systeem zijn.Indicates whether the services exist on the system. Deze eigenschap instellen op afwezig om ervoor te zorgen dat de services niet bestaan.Set this property to Absent to ensure that the services do not exist. Instellen op aanwezig (de standaardwaarde) zorgt ervoor dat de doelservices bestaat.Setting it to Present (the default value) ensures that target services exist.
referentieCredential Hiermee geeft u referenties voor het account waaronder resource voor de service wordt uitgevoerd.Indicates credentials for the account that the service resource will run under. Deze eigenschap en de BuiltinAccount eigenschap kan niet samen worden gebruikt.This property and the BuiltinAccount property cannot be used together.
dependsOnDependsOn Hiermee wordt aangegeven dat de configuratie van een andere resource uitvoeren moet voordat deze bron is geconfigureerd.Indicates that the configuration of another resource must run before this resource is configured. Bijvoorbeeld, als de ID van de resourceconfiguratie scriptblok die u wilt uitvoeren eerst is ResourceName en het type ResourceType, de syntaxis voor het gebruik van deze eigenschap is 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".

VoorbeeldExample

De volgende configuratie start de services 'Windows Audio' en 'Extern bureaublad-Services'.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"
        }
    }
}