ServiceSet

  • Artigo

Sinopse

Gerenciar vários serviços com configurações comuns.

Sintaxe

ServiceSet [String] #ResourceName
{
    [DependsOn = [String[]]]
    [PsDscRunAsCredential = [PSCredential]]
    Name = [String[]]
    [Ensure = [String]]
    [StartupType = [String]]
    [BuiltInAccount = [String]]
    [State = [String]]
    [Credential = [PSCredential]]
}

Descrição

ServiceSet é um recurso composto que torna mais simples gerenciar vários serviços ao mesmo tempo com configurações compartilhadas, mas limitadas. Esse recurso só pode atualizar ou remover serviços existentes. Ele não pode criar serviços. Para obter mais controle sobre a configuração de seus serviços, consulte o recurso serviço.

Importante

Os recursos compostos não funcionam com Invoke-DscResource. Esse recurso só pode ser usado dentro de uma Configuration definição.

Requisitos

Nenhum.

Propriedades

Propriedades da chave

Nome

Especifique os nomes dos serviços como uma matriz de cadeias de caracteres.

Isso pode ser diferente do nome de exibição do serviço. Para recuperar uma lista de todos os serviços com seus nomes e estados atuais, use o Get-Service cmdlet.

Type: System.String[]
Behavior: Key

Propriedades opcionais

BuiltInAccount

Especifique o nome da conta do computador para executar o serviço como. A conta deve ter acesso ao executável de cada serviço para iniciar o serviço.

Não especifique essa propriedade com a propriedade Credential .

Type: System.String
Accepted Values:
  - LocalService
  - LocalSystem
  - NetworkService
Default Value: Null

Credencial

Especifique a credencial de uma conta para executar os serviços como. A conta deve ter acesso ao executável de cada serviço para iniciar esse serviço. O recurso concede automaticamente a essa conta o direito "Fazer logon como serviço".

Não especifique essa propriedade com a propriedade BuiltInAccount .

Type: System.Management.Automation.PSCredential
Default Value: None

Ensure

Especifique se os serviços devem existir. Para adicionar ou atualizar um serviço, defina essa propriedade como Present. Para remover um serviço, defina essa propriedade como Absent.

O valor padrão é Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

StartupType

Especifique como os serviços devem se comportar na inicialização do sistema. O valor deve ser um dos seguintes:

  • Automatic - O serviço é iniciado pelo sistema operacional na inicialização do sistema. Se um serviço iniciado automaticamente depender de um serviço iniciado manualmente, o serviço iniciado manualmente também será iniciado automaticamente na inicialização do sistema.
  • Disabled - O serviço está desabilitado e não pode ser iniciado por um usuário ou aplicativo.
  • Manual - O serviço é iniciado apenas manualmente, por um usuário, usando o Service Control Manager ou por um aplicativo.

Se o serviço não existir, o valor padrão será Automatic.

Type: System.String
Behavior: Write
Accepted Values:
  - Automatic
  - Disabled
  - Manual
Default Value: None

Estado

Especifique se os serviços devem ser executados. O valor deve ser um dos seguintes:

  • Running - O recurso iniciará o serviço se ele ainda não tiver sido iniciado.
  • Stopped - O recurso interrompe o serviço se ele estiver em execução.
  • Ignore - O recurso não inicia nem interrompe o serviço.

O valor padrão é Running.

Type: System.String
Accepted Values:
  - Running
  - Stopped
  - Ignore
Default Value: Running

Exemplos