

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# `AWSSupport-ManageWindowsService`
<a name="automation-awssupport-managewindowsservice"></a>

 **Descrição** 

O runbook `AWSSupport-ManageWindowsService` permite que você pare, inicie, reinicie, pause ou desative qualquer serviço do Windows na instância de destino.

[Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-ManageWindowsService)

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Windows

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
+ InstanceId

  Tipo: string

  Descrição: (obrigatório) o ID da instância gerenciada para gerenciar os serviços de
+ ServiceAction

  Tipo: string

  Valores permitidos: Check,Restart,Force-Restart,Start,Stop,Force-Stop,Pause

  Padrão: Check

  Descrição: (obrigatório) uma ação a ser aplicada ao serviço do Windows. Observe que `Force-Restart` e `Force-Stop` podem ser usados para reiniciar e interromper um serviço que tem serviços dependentes. 
+ StartupType

  Tipo: string

  Valores válidos: Verificar \$1 Automático \$1 Demanda \$1 Desativado \$1 DelayedAutoStart

  Padrão: Check

  Descrição: (Obrigatório) Um tipo de startup a ser aplicado ao serviço Windows.
+ WindowsServiceName

  Tipo: string

  Descrição: (Obrigatório) Um nome de serviço válido do Windows.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.

É recomendável que a EC2 instância que recebe o comando tenha uma função do IAM com a política gerenciada SSMManaged InstanceCore da **Amazon** Amazon anexada. O usuário deve ter pelo menos **ssm: StartAutomationExecution** e **ssm: SendCommand** para executar a automação e enviar o comando para a instância, além de **ssm: GetAutomationExecution** para poder ler a saída da automação.

 **Etapas do documento** 

`aws:runCommand`- Execute o PowerShell script para aplicar a configuração desejada ao serviço Windows na instância de destino.

 **Saídas** 

manageWindowsService.Saída