Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# `AWSSupport-ActivateWindowsWithAmazonLicense`
<a name="automation-awssupport-activatewindowswithamazonlicense"></a>

 **Descripción** 

El `AWSSupport-ActivateWindowsWithAmazonLicense` manual activa una instancia de Amazon Elastic Compute Cloud (Amazon EC2) para Windows Server con una licencia proporcionada por Amazon. La automatización verifica y configura los ajustes necesarios del sistema operativo del servicio de administración de claves e intenta realizar la activación. Esto incluye las rutas del sistema operativo a los servidores de administración de claves de Amazon y la configuración del sistema operativo del servicio de administración de claves. Si se configura el `AllowOffline` parámetro para `true` que la automatización se dirija correctamente a las instancias que no están gestionadas por la instancia AWS Systems Manager, pero que requieren una parada y un inicio de la instancia.

**nota**  
Este manual no se puede usar en el modelo Bring Your Own License (BYOL) Windows Server instancias. Para obtener más información acerca del uso de su propia licencia, consulte [Licencias de Microsoft en AWS](https://aws.amazon.com/windows/resources/licensing/). 

[Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-ActivateWindowsWithAmazonLicense)

**Tipo de documento**

Automatización

**Propietario**

Amazon

**Plataformas**

Windows

**Parámetros**
+ AllowOffline

  Tipo: cadena

  Valores válidos: true \$1 false

  Predeterminado: false

  Descripción: (opcional) establézcalo en `true` si permite una corrección de activación de Windows sin conexión en caso de que la solución de problemas en línea produzca un error o que la instancia proporcionada no sea una instancia administrada.
**importante**  
El método offline requiere que la EC2 instancia proporcionada se detenga y, a continuación, se inicie. Se perderán los datos almacenados en los volúmenes de almacén de instancias. La dirección IP pública cambiará si no se utiliza una dirección IP elástica.
+ AutomationAssumeRole

  Tipo: cadena

  Descripción: (opcional) el Nombre de recurso de Amazon (ARN) del rol de AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos.
+ ForceActivation

  Tipo: cadena

  Valores válidos: true \$1 false

  Predeterminado: false

  Descripción: (opcional) establecerlo en `true` si desea continuar incluso si Windows ya está activado.
+ InstanceId

  Tipo: cadena

  Descripción: ID (obligatorio) de la EC2 instancia gestionada para Windows Server.
+ SubnetId

  Tipo: cadena

  Predeterminado: CreateNew VPC

  Descripción: (opcional) Solo sin conexión: el ID de subred de la instancia de EC2 Rescue que se utiliza para solucionar los problemas sin conexión. Utilice `SelectedInstanceSubnet` para utilizar la misma subred que la instancia, o utilice `CreateNewVPC` para crear una nueva VPC. IMPORTANTE: La subred debe estar en la misma InstanceId zona de disponibilidad y debe permitir el acceso a los puntos finales de SSM.

**Permisos de IAM necesarios**

El parámetro `AutomationAssumeRole` requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

Recomendamos que la EC2 instancia que recibe el comando tenga una función de IAM con la política gestionada por **SSMManagedInstanceCoreAmazon** adjunta. Debes tener al menos **ssm: StartAutomationExecution** y **ssm: SendCommand** para ejecutar la automatización y enviar el comando a la instancia, además de **ssm: GetAutomationExecution** para poder leer el resultado de la automatización. Para obtener información sobre la corrección sin conexión, consulte los permisos que necesita `AWSSupport-StartEC2RescueWorkflow`.

 **Pasos de documentos** 

1. `aws:assertAwsResourceProperty`: comprueba que la plataforma de la instancia proporcionada sea Windows.

1. `aws:assertAwsResourceProperty`: confirma que la instancia proporcionada es una instancia gestionada:

   1. (Solución de activación en línea) Si la instancia de entrada es una instancia administrada, ejecute el PowerShell script `aws:runCommand` para intentar corregir la activación de Windows.

   1. (Solución de activación sin conexión) Si la instancia de entrada no es una instancia administrada:

      1. `aws:assertAwsResourceProperty`: verifica que el indicador `AllowOffline` esté establecido en `true`. En caso afirmativo, comienza la corrección sin conexión; de lo contrario, la automatización de trabajo finaliza.

      1. `aws:executeAutomation`: invoca `AWSSupport-StartEC2RescueWorkflow` con el script de corrección fuera de línea para la activación de Windows. El script usa EC2 Config o EC2 Launch, según la versión del sistema operativo.

      1. `aws:executeAwsApi`: lee el resultado de `AWSSupport-StartEC2RescueWorkflow`.

 **Salidas** 

activateWindows.Output

getActivateWindowsOfflineResult.Salida