Recurso do ServiceSet DSCDSC ServiceSet Resource

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

O recurso ServiceSet na DSC (Configuração de Estado Desejado) do Windows PowerShell oferece um mecanismo para gerenciar serviços no nó de destino.The ServiceSet resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage services on the target node. Esse recurso é um recurso composto que chama o Recurso de serviço para cada serviço especificado na propriedade Name.This resource is a composite resource that calls the Service resource for each service specified in the Name property.

Use esse recurso quando desejar configurar vários serviços para o mesmo estado.Use this resource when you want to configure a number of services to the same state.

SintaxeSyntax

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

}

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
NomeName Indica os nomes do serviço.Indicates the service names. Observe que, às vezes, isso é diferente dos nomes de exibição.Note that sometimes this is different from the display names. É 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.
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
BuiltInAccountBuiltInAccount Indica a conta de credenciais a ser usada para os serviços.Indicates the sign-in account to use for the services. 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.
EstadoState Indica o estado que você deseja garantir para os serviços: Parado ou Em execução.Indicates the state you want to ensure for the services: Stopped or Running.
EnsureEnsure Indica se os serviços existem no sistema.Indicates whether the services exist on the system. Defina essa propriedade como Ausente para garantir que os serviços não existam.Set this property to Absent to ensure that the services do not exist. Configurá-la como Present (o valor padrão) garantirá que os serviços de destino existam.Setting it to Present (the default value) ensures that target services exist.
CredentialCredential Indica as credenciais para a conta sob a qual o serviço será executado.Indicates credentials for the account that the service resource 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".

ExemploExample

A configuração a seguir inicia os serviços "Áudio do Windows" e "Serviços de Área de Trabalho Remota".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"
        } 
    }
}