

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

 **Description** 

Le `AWSSupport-UpgradeWindowsAWSDrivers` runbook met à niveau ou répare le stockage et AWS les pilotes réseau sur l'instance EC2 spécifiée. Le runbook tente d'installer les dernières versions des AWS pilotes en ligne en appelant l'agent SSM. Si l'agent SSM n'est pas joignable, le runbook peut effectuer une installation hors ligne des AWS pilotes si cela est explicitement demandé. 

 Ce runbook est compatible avec les systèmes d'exploitation suivants : 
+ Windows Server 2016
+ Windows Server 2019
+ Windows Server 2022
+ Windows Server 2025

**Note**  
La mise à niveau en ligne et hors ligne créera une AMI avant toute tentative d'opération, qui persistera une fois l'automatisation terminée. Vous devez sécuriser l'accès à l'AMI ou le supprimer. La méthode en ligne redémarre l'instance dans le cadre du processus de mise à niveau, tandis que la méthode hors connexion nécessite l'arrêt, puis le redémarrage de l'instance EC2 fournie.

**Important**  
Si vos instances se connectent à AWS Systems Manager l'aide de points de terminaison VPC, ce runbook échouera s'il n'est pas utilisé dans la région us-east-1. Ce runbook échouera également sur un contrôleur de domaine. Pour mettre à jour les pilotes AWS PV sur un contrôleur de domaine, voir [Mettre à niveau un contrôleur de domaine (mise à niveau AWS PV)](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/Upgrading_PV_drivers.html#aws-pv-upgrade-dc).

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

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Windows

**Paramètres**
+ AllowOffline

  Type : Chaîne

  Valeurs valides : true \$1 false

  Valeur par défaut : false

  Description : (Facultatif) Définissez ce paramètre sur true si vous autorisez la mise à niveau des pilotes hors connexion si l'installation en ligne ne peut pas être effectuée. Remarque : le mode hors connexion nécessite l'arrêt, puis le redémarrage de l'instance EC2. 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 : Chaîne

  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.
+ ForceUpgrade

  Type : Chaîne

  Valeurs valides : true \$1 false

  Valeur par défaut : false

  Description : (Facultatif et hors connexion uniquement) définissez ce paramètre sur true si vous autorisez la mise à niveau des pilotes hors connexion même si les derniers pilotes sont déjà installés sur votre instance.
+ InstanceId

  Type : Chaîne

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

  Type : Chaîne

  Par défaut : SelectedInstanceSubnet

  Description : (Facultatif) Hors ligne uniquement : ID de sous-réseau de l'instance EC2 Rescue utilisée pour effectuer la mise à niveau des pilotes hors ligne. Si aucun ID de sous-réseau n'est spécifié, Systems Manager Automation créera un nouveau VPC.
**Important**  
Le sous-réseau doit se trouver dans la même zone de disponibilité que les points de terminaison SSM InstanceId, 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.

L'instance EC2 recevant la commande doit au minimum avoir un rôle IAM qui inclut des autorisations pour **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. Vous pouvez joindre la stratégie gérée par `AmazonSSMManagedInstanceCore` Amazon à votre rôle IAM pour fournir ces autorisations. Nous vous recommandons toutefois d'utiliser le rôle IAM Automation `AmazonSSMAutomationRole` à cette fin. Pour plus d'informations, consultez [Utiliser IAM pour configurer les rôles pour l'automatisation](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-permissions.html).

Si vous effectuez une mise à niveau hors connexion, veuillez consulter les autorisations requises par [`AWSSupport-StartEC2RescueWorkflow`](automation-awssupport-startec2rescueworkflow.md).

 **Étapes de document** 

1. `aws:assertAwsResourceProperty`- Vérifie que l'instance d'entrée est Windows.

1. `aws:assertAwsResourceProperty`- Vérifie que l'instance d'entrée est une instance gérée. Si tel est le cas, la mise à niveau en ligne démarre. Dans le cas contraire, la mise à niveau hors connexion est évaluée.

   1. (Mise à niveau en ligne) Si l'instance d'entrée est une instance gérée :

      1. `aws:createImage`- Crée une sauvegarde AMI.

      1. `aws:createTags`- Marque la sauvegarde de l'AMI.

      1. `aws:runCommand`- Installe le pilote réseau ENA.

      1. `aws:runCommand`- Installe le NVMe pilote.

      1. `aws:runCommand`- Installe le pilote AWS PV.

   1. (Mise à niveau 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, la mise à niveau hors ligne démarre, sinon l'automatisation prend fin.

      1. `aws:changeInstanceState`- Arrêtez l'instance source.

      1. `aws:changeInstanceState`- Arrêtez de force l'instance source.

      1. `aws:createImage`- Créez une sauvegarde AMI de l'instance source.

      1. `aws:createTags`- Marquez la sauvegarde AMI de l'instance source.

      1. `aws:executeAwsApi`- Activez l'ENA pour l'instance

      1. `aws:assertAwsResourceProperty`- Affirmez le ForceUpgrade drapeau.

      1. Forcer la mise à niveau hors ligne) Si **ForceUpgrade = true**, exécutez `aws:executeAutomation` pour appeler le script de mise à niveau forcée `AWSSupport-StartEC2RescueWorkflow` avec les pilotes. Cette opération installe les pilotes quelle que soit la version actuelle qui est installée.

      1. (Mise à niveau hors ligne) Si **ForceUpgrade = false**, exécutez `aws:executeAutomation` pour appeler `AWSSupport-StartEC2RescueWorkflow` avec le script de mise à niveau des pilotes.

 **Sorties** 

preUpgradeBackup.ImageId

preOfflineUpgradeBackup. ImageId

`installAwsEnaNetworkDriverOnInstance.Output`

`installAWSNVMeOnInstance.Output`

`installAWSPVDriverOnInstance.Output`

upgradeDriversOffline.Sortie

forceUpgradeDriversHors ligne. Sortie