Recurso Service de DSC
Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.x
O recurso Service na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para gerenciar serviços no nó de destino.
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
Service [string] #ResourceName
{
Name = [string]
[ BuiltInAccount = [string] { LocalService | LocalSystem | NetworkService } ]
[ Credential = [PSCredential] ]
[ StartupType = [string] { Automatic | Disabled | Manual } ]
[ State = [string] { Running | Stopped } ]
[ Dependencies = [string[]] ]
[ Description = [string] ]
[ DisplayName = [string] ]
[ Path = [string] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Propriedades
Propriedade | Descrição |
---|---|
Nome | Indica o nome do serviço. Observe que, às vezes, é diferente do nome de exibição. É possível obter uma lista dos serviços e seus estados atuais com o cmdlet Get-Service . |
BuiltInAccount | Indica a conta de entrada que deve ser usada para o serviço. Os valores permitidos para essa propriedade são: LocalService, LocalSystem e NetworkService. |
Credencial | Indica as credenciais para a conta em que o serviço será executado. Essa propriedade e a propriedade BuiltinAccount não podem ser usadas juntas. |
StartupType | Indica o tipo de inicialização para o serviço. Os valores permitidos para essa propriedade são: Automático, Desabilitado e Manual. |
Estado | Indica o estado que você deseja garantir para o serviço. Os valores são: Em execução ou Parado. |
Dependências | Uma matriz dos nomes das dependências que o serviço deve ter. |
Descrição | Indica a descrição do serviço de destino. |
DisplayName | Indica o nome de exibição do serviço de destino. |
Caminho | Indica o caminho para o arquivo binário para um novo serviço. |
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 o serviço de destino existe no sistema. Defina essa propriedade como Ausente para garantir que o serviço de destino não exista. Defini-la como Present garantirá que o serviço de destino exista. 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
configuration ServiceTest
{
Import-DscResource -ModuleName PSDesiredStateConfiguration
Node localhost
{
Service ServiceExample
{
Name = "TermService"
StartupType = "Manual"
State = "Running"
}
}
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de