ServiceSet

Artigo
05/05/2023

Sinopse

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

Syntax

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 gerir vários serviços ao mesmo tempo com configurações partilhadas mas limitadas. Este recurso só pode atualizar ou remover os serviços existentes. Não pode criar serviços. Para obter mais controlo sobre a configuração dos seus serviços, consulte o recurso Serviço.

Importante

Os recursos compósitos não funcionam com Invoke-DscResource. Este recurso só é utilizável dentro de uma Configuration definição.

Requisitos

Nenhum.

Propriedades

Propriedades principais

Name

Especifique os nomes dos serviços como uma variedade de cordas.

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

Type: System.String[]
Behavior: Key

Propriedades opcionais

BuiltInAccount

Especifique o nome da conta da máquina 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 esta propriedade com a propriedade Credencial .

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

Credencial

Especifique a credencial para 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 esta conta o direito "Iniciar sessão como serviço".

Não especifique esta propriedade com a propriedade BuiltInAccount .

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

Garantir

Especificar se os serviços devem existir. Para adicionar ou atualizar um serviço, desaveiu esta propriedade para Present. Para remover um serviço, desemote esta propriedade para Absent.

O valor predefinido é Present.

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

Tipo de Arranque

Especificar como os serviços devem comportar-se no arranque do sistema. O valor deve ser um dos seguintes:

Automatic - O serviço é iniciado pelo sistema operativo no arranque do sistema. Se um serviço iniciado automaticamente depender de um serviço iniciado manualmente, o serviço iniciado manualmente também é iniciado automaticamente no arranque do sistema.
Disabled - O serviço é desativado e não pode ser iniciado por um utilizador ou aplicação.
Manual - O serviço é iniciado apenas manualmente, por um utilizador, utilizando o Gestor de Controlo de Serviço, ou por uma aplicação.

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

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

Estado

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

Running - O recurso inicia o serviço se ainda não tiver começado.
Stopped - O recurso para o serviço se estiver a funcionar.
Ignore - O recurso não inicia nem para o serviço.

O valor predefinido é Running.

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

Partilhar via