

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

 **Description** 

Le `AWSSupport-ActivateWindowsWithAmazonLicense` runbook active une instance Amazon Elastic Compute Cloud (Amazon EC2) pour Windows Server avec une licence fournie par Amazon. L'automatisation vérifie et configure les paramètres requis du système d'exploitation du service de gestion des clés et tente l'activation. Cela inclut les itinéraires du système d'exploitation vers les serveurs de gestion des clés d'Amazon et les paramètres du système d'exploitation du service de gestion des clés. La définition du `AllowOffline` paramètre sur `true` permet à l'automatisation de cibler avec succès les instances qui ne sont pas gérées par AWS Systems Manager, mais nécessitent l'arrêt et le démarrage de l'instance.

**Note**  
Ce runbook ne peut pas être utilisé sur le modèle Bring Your Own License (BYOL) Windows Server instances. Pour plus d'informations sur l'utilisation de votre propre licence, consultez [Licences Microsoft sur AWS](https://aws.amazon.com/windows/resources/licensing/). 

[Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-ActivateWindowsWithAmazonLicense)

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Windows

**Paramètres**
+ AllowOffline

  Type : String

  Valeurs valides : true \$1 false

  Valeur par défaut : false

  Description : (Facultatif) Réglez-le sur `true` si vous autorisez une correction d'activation Windows hors ligne en cas d'échec du dépannage en ligne ou si l'instance fournie n'est pas une instance gérée.
**Important**  
La méthode hors ligne nécessite que l' EC2 instance fournie soit arrêtée puis démarrée. Les données stockées sur les volumes de stockage d'instance seront perdues. L'adresse IP publique change si vous n'utilisez pas une adresse IP Elastic.
+ AutomationAssumeRole

  Type : String

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
+ ForceActivation

  Type : String

  Valeurs valides : true \$1 false

  Valeur par défaut : false

  Description : (Facultatif) Réglez-le sur `true` si vous souhaitez continuer même si Windows est déjà activé.
+ InstanceId

  Type : String

  Description : ID (obligatoire) de votre EC2 instance gérée pour Windows Server.
+ SubnetId

  Type : String

  Par défaut : CreateNew VPC

  Description : (Facultatif) Hors ligne uniquement : ID de sous-réseau de l'instance EC2 Rescue utilisée pour effectuer le dépannage hors ligne. `SelectedInstanceSubnet`Utilisez-le pour utiliser le même sous-réseau que votre instance ou `CreateNewVPC` pour créer un nouveau VPC. IMPORTANT : Le sous-réseau doit se trouver dans la même zone de disponibilité que les points de InstanceId terminaison SSM et il doit autoriser l'accès à ceux-ci.

**Autorisations IAM requises**

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.

Nous recommandons que l' EC2 instance recevant la commande ait un rôle IAM associé à la politique gérée par **SSMManagedInstanceCoreAmazon**. Vous devez avoir au moins **ssm : StartAutomationExecution** et **ssm : SendCommand** pour exécuter l'automatisation et envoyer la commande à l'instance, plus **ssm : GetAutomationExecution** pour pouvoir lire le résultat de l'automatisation. Pour la correction hors ligne, consultez les autorisations requises par`AWSSupport-StartEC2RescueWorkflow`.

 **Étapes de document** 

1. `aws:assertAwsResourceProperty`- Vérifiez que la plate-forme de l'instance fournie est Windows.

1. `aws:assertAwsResourceProperty`- Vérifiez que l'instance fournie est une instance gérée :

   1. (Correctif d'activation en ligne) Si l'instance d'entrée est une instance gérée, exécutez `aws:runCommand` le PowerShell script afin de tenter de corriger l'activation de Windows.

   1. (Correctif d'activation hors connexion) Si l'instance d'entrée n'est pas une instance gérée :

      1. `aws:assertAwsResourceProperty`- Vérifie que le `AllowOffline` drapeau est réglé sur. `true` Dans ce cas, le correctif hors ligne démarre ; sinon, l'automatisation prend fin.

      1. `aws:executeAutomation`- Appelez `AWSSupport-StartEC2RescueWorkflow` avec le script de correction hors ligne d'activation de Windows. Le script utilise EC2 Config ou EC2 Launch, selon la version du système d'exploitation.

      1. `aws:executeAwsApi`- Lisez le résultat de`AWSSupport-StartEC2RescueWorkflow`.

 **Sorties** 

activateWindows.Output

getActivateWindowsOfflineResult.Sortie