DSC Service ResourceDSC Service Resource

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

De Service in Windows PowerShell Desired State Configuration (DSC)-bron biedt een mechanisme voor het beheren van services in het doelknooppunt.The Service resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage services on the target node.

SyntaxisSyntax

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

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
NaamName Geeft de servicenaam.Indicates the service name. Houd er rekening mee dat soms dit van de weergegeven naam verschilt.Note that sometimes this is different from the display name. U kunt een lijst van de services en de huidige staat met de cmdlet Get-Service ophalen.You can get a list of the services and their current state with the Get-Service cmdlet.
BuiltInAccountBuiltInAccount Hiermee geeft u het account aanmelden om te gebruiken voor de service.Indicates the sign-in account to use for the service. 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.
referentieCredential Hiermee geeft u referenties voor het account waaronder de service wordt uitgevoerd.Indicates credentials for the account that the service 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".
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
StatusState Geeft de status die u wilt zorgen voor de service.Indicates the state you want to ensure for the service.
BeschrijvingDescription Hiermee geeft u de beschrijving van de doelservice.Indicates the description of the target service.
DisplayNameDisplayName Geeft de naam van de doelservice.Indicates the display name of the target service.
Zorg ervoor datEnsure Hiermee wordt aangegeven of de doelservice op het systeem bestaat.Indicates whether the target service exists on the system. Deze eigenschap instellen op afwezig om ervoor te zorgen dat de doelservice niet bestaat.Set this property to Absent to ensure that the target service does not exist. Instellen op aanwezig (de standaardwaarde) zorgt ervoor dat de doelservice bestaat.Setting it to Present (the default value) ensures that target service exists.
PadPath Geeft het pad naar het binaire bestand voor een nieuwe service.Indicates the path to the binary file for a new service.

VoorbeeldExample

configuration ServiceTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration
    Node localhost
    {

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