AWSSupport-ManageWindowsService - AWS Systems Manager Referência do runbook de automação

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

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)

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 | Automático | Demanda | Desativado | 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