Recurso do ServiceSet DSC

Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.x

O recurso ServiceSet na DSC (Configuração de Estado Desejado) do Windows PowerShell oferece um mecanismo para gerenciar serviços no nó de destino. Esse recurso é um recurso composto que chama o Recurso de serviço para cada serviço especificado na propriedade Name.

Use esse recurso quando desejar configurar vários serviços para o mesmo estado.

Observação

Esta documentação desse recurso DSC aborda a versão incluída no PowerShell antes da versão 7.2. O módulo PSDscResources contém recursos de DSC novos e atualizados com suporte oficial da Microsoft. O módulo PSDscResources está disponível na Galeria do PowerShell.

Para obter mais informações e documentação atualizada, consulte a documentação de referência PSDscResources.

Sintaxe

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

Propriedades

Propriedade	Descrição
Nome	Indica os nomes do serviço. Observe que, às vezes, isso é diferente dos nomes de exibição. É possível obter uma lista dos serviços e seus estados atuais com o cmdlet Get-Service.
StartupType	Indica o tipo de inicialização para os serviços. Os valores permitidos para essa propriedade são: Automático, Desabilitado e Manual.
BuiltInAccount	Indica a conta de credenciais a ser usada para os serviços. Os valores permitidos para essa propriedade são: LocalService, LocalSystem e NetworkService.
Estado	Indica o estado que você deseja garantir para os serviços: Parado ou Em execução.
Credencial	Indica as credenciais para a conta sob a qual o serviço será executado. Essa propriedade e a propriedade BuiltinAccount não podem ser usadas juntas.

Propriedades comuns

Propriedade	Descrição
DependsOn	Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado. 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".
Ensure	Indica se os serviços existem no sistema. Defina essa propriedade como Ausente para garantir que os serviços não existam. Defini-la como Present garantirá que os serviços de destino existam. O valor padrão é Present.
PsDscRunAsCredential	Define a credencial para executar todo o recurso.

Observação

A propriedade comum PsDscRunAsCredential foi adicionada ao WMF 5.0 para permitir a execução de qualquer recurso de DSC no contexto de outras credenciais. Para saber mais, confira Usar credenciais com recursos de DSC.

Exemplo

A configuração a seguir inicia os serviços "Áudio do Windows" e "Serviços de Área de Trabalho Remota".

configuration ServiceSetTest
{
    Import-DscResource -ModuleName PSDesiredStateConfiguration

    Node localhost
    {
        ServiceSet ServiceSetExample
        {
            Name        = @("TermService", "Audiosrv")
            StartupType = "Manual"
            State       = "Running"
        }
    }
}