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-ActivateWindowsWithAmazonLicense`
<a name="automation-awssupport-activatewindowswithamazonlicense"></a>

 **Descrição** 

O `AWSSupport-ActivateWindowsWithAmazonLicense` runbook ativa uma instância do Amazon Elastic Compute Cloud (Amazon EC2) para Windows Server com uma licença fornecida pela Amazon. A automação verifica e define as configurações necessárias do sistema operacional do serviço de gerenciamento de chaves e tenta a ativação. Isso inclui rotas do sistema operacional para os servidores de gerenciamento de chaves do Amazon e configurações do sistema operacional do serviço de gerenciamento de chaves. Definir o `AllowOffline` parâmetro para `true` permitir que a automação atinja com sucesso instâncias que não são gerenciadas por AWS Systems Manager, mas exigem uma parada e início da instância.

**nota**  
Este runbook não pode ser usado no modelo Bring Your Own License (BYOL) Windows Server instâncias. Para obter informações sobre como usar sua própria licença, consulte [Licenciamento da Microsoft na AWS](https://aws.amazon.com/windows/resources/licensing/). 

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

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Windows

**Parâmetros**
+ AllowOffline

  Tipo: string

  Valores válidos: True \$1 False

  Padrão: False

  Descrição: (opcional) defina como `true` se você permitir a correção da ativação do Windows offline caso houver falha na correção de problemas online ou caso a instância fornecida não seja uma instância gerenciada.
**Importante**  
O método off-line exige que a EC2 instância fornecida seja interrompida e depois iniciada. Dados armazenados em volumes de armazenamento de instâncias serão perdidos. O endereço IP público será alterado se você não estiver usando um IP elástico.
+ 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.
+ ForceActivation

  Tipo: string

  Valores válidos: True \$1 False

  Padrão: False

  Descrição: (opcional) defina como `true` se você deseja continuar, mesmo se o Windows já estiver ativado.
+ InstanceId

  Tipo: string

  Descrição: ID (obrigatório) da sua EC2 instância gerenciada para Windows Server.
+ SubnetId

  Tipo: string

  Padrão: CreateNew VPC

  Descrição: (Opcional) Somente off-line - O ID de sub-rede da instância do EC2 Rescue usado para realizar a solução de problemas off-line. Use `SelectedInstanceSubnet` para usar a mesma sub-rede como sua instância, ou `CreateNewVPC` para criar uma nova VPC. IMPORTANTE: A sub-rede deve estar na mesma InstanceId zona de disponibilidade e permitir o acesso aos endpoints do SSM.

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

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

Recomendamos 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. Você 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. Para a correção offline, consulte as permissões exigidas pelo `AWSSupport-StartEC2RescueWorkflow`.

 **Etapas do documento** 

1. `aws:assertAwsResourceProperty`: verifique se a plataforma da instância fornecida é Windows.

1. `aws:assertAwsResourceProperty`: confirme se a instância fornecida é uma instância gerenciada:

   1. (Correção de ativação online) Se a instância de entrada for uma instância gerenciada, execute `aws:runCommand` para executar o PowerShell script para tentar corrigir a ativação do Windows.

   1. (Correção de ativação offline) Se a instância de entrada não for uma instância gerenciada:

      1. `aws:assertAwsResourceProperty`: verifica se o sinalizador `AllowOffline` está definido como `true`. Se esse for o caso, a correção offline é iniciada; caso contrário, o fluxo de trabalho termina.

      1. `aws:executeAutomation`: invocar `AWSSupport-StartEC2RescueWorkflow` com o script de correção offline de ativação do Windows. O script usa EC2 Config ou EC2 Launch, dependendo da versão do sistema operacional.

      1. `aws:executeAwsApi`: lê o resultado de `AWSSupport-StartEC2RescueWorkflow`.

 **Saídas** 

activateWindows.Output

getActivateWindowsOfflineResult.Saída