Recurso Service de DSCDSC Service Resource

Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

O recurso Service na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para gerenciar serviços no nó de destino.The Service resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage services on the target node.

SintaxeSyntax

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

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
NomeName Indica o nome do serviço.Indicates the service name. Observe que, às vezes, é diferente do nome de exibição.Note that sometimes this is different from the display name. É possível obter uma lista dos serviços e seus estados atuais com o cmdlet Get-Service.You can get a list of the services and their current state with the Get-Service cmdlet.
BuiltInAccountBuiltInAccount Indica a conta de entrada que deve ser usada para o serviço.Indicates the sign-in account to use for the service. Os valores permitidos para essa propriedade são: LocalService, LocalSystem e NetworkService.The values that are allowed for this property are: LocalService, LocalSystem, and NetworkService.
CredentialCredential Indica as credenciais para a conta em que o serviço será executado.Indicates credentials for the account that the service will run under. Essa propriedade e a propriedade BuiltinAccount não podem ser usadas juntas.This property and the BuiltinAccount property cannot be used together.
DependsOnDependsOn Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado.Indicates that the configuration of another resource must run before this resource is configured. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será 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 Indica o tipo de inicialização para o serviço.Indicates the startup type for the service. Os valores permitidos para essa propriedade são: Automatic, Disabled e ManualThe values that are allowed for this property are: Automatic, Disabled, and Manual
EstadoState Indica o estado que você deseja garantir para o serviço.Indicates the state you want to ensure for the service.
DescriçãoDescription Indica a descrição do serviço de destino.Indicates the description of the target service.
DisplayNameDisplayName Indica o nome de exibição do serviço de destino.Indicates the display name of the target service.
EnsureEnsure Indica se o serviço de destino existe no sistema.Indicates whether the target service exists on the system. Defina essa propriedade como Ausente para garantir que o serviço de destino não exista.Set this property to Absent to ensure that the target service does not exist. Configurá-la como Present (o valor padrão) garante que o grupo exista.Setting it to Present (the default value) ensures that target service exists.
CaminhoPath Indica o caminho para o arquivo binário para um novo serviço.Indicates the path to the binary file for a new service.

ExemploExample

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

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