

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.

# Instantanés Amazon EBS basés sur Windows VSS et compatibles avec l’application
<a name="application-consistent-snapshots"></a>

Vous pouvez prendre des instantanés compatibles avec l’application de tous les volumes Amazon EBS associés à vos instances Amazon EC2 Windows à l’aide de la [commande d’exécution AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html). Le processus d’instantané utilise le service [Volume Shadow Copy Service (VSS)](https://learn.microsoft.com/en-us/windows-server/storage/file-server/volume-shadow-copy-service) de Windows pour effectuer des sauvegardes au niveau du volume EBS des applications compatibles avec VSS. Les instantanés incluent des données de transactions en attente entre ces applications et le disque. Vous n’avez pas besoin de fermer vos instances ni de les déconnecter lorsque vous devez sauvegarder tous les volumes attachés.

L’utilisation d’instantanés EBS basés sur VSS n’entraîne aucun coût supplémentaire. Vous payez uniquement pour les instantanés EBS créés par le processus de sauvegarde. Pour plus d’informations, consultez la section [Comment mes instantanés Amazon EBS sont-ils facturés ?](https://repost.aws/knowledge-center/ebs-snapshot-billing)

**Note**  
Les instantanés Windows VSS compatibles avec l’application ne sont pris en charge qu’avec les instances Windows.

**Topics**
+ [Qu’est-ce qu’ VSS ?](#application-consistent-snapshots-how)
+ [Fonctionnement de la solution d’instantané Amazon EBS basée sur VSS](#how-vss-works)
+ [Conditions préalables pour VSS](application-consistent-snapshots-prereqs.md)
+ [Créer des instantanés VSS](create-vss-snaps.md)
+ [Résoudre les problèmes liés aux instantanés VSS](application-consistent-snapshots-troubleshooting.md)
+ [Options de restauration pour la solution AWS VSS](application-consistent-snapshots-restore.md)
+ [Historique des versions](vss-comps-history.md)

## Qu’est-ce qu’ VSS ?
<a name="application-consistent-snapshots-how"></a>

Volume Shadow Copy Service (VSS) est une technologie de sauvegarde et de restauration incluse dans Microsoft Windows. Elle peut créer des copies de sauvegarde, ou des instantanés, de fichiers ou de volumes informatiques pendant leur utilisation. Pour plus d’informations, consultez [Volume Shadow Copy Service](https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/ee923636(v=ws.10)?redirectedfrom=MSDN).

Pour créer un instantané de la cohérence de l’application, les composants logiciels suivants sont impliqués.
+ *Service VSS* : partie intégrante du système d’exploitation Windows
+ *Demandeur VSS* : le logiciel qui demande la création de copies instantanées
+ *Enregistreur VSS* : généralement fourni dans le cadre d’une application, telle que SQL Server, pour garantir un ensemble de données cohérent à sauvegarder
+ *Fournisseur VSS* : le composant qui crée les copies instantanées des volumes sous-jacents

La solution d’instantané Amazon EBS basée sur Windows VSS se compose de plusieurs documents de commande d’exécution du gestionnaire de systèmes (SSM) qui facilitent la création de sauvegardes, et d’un [ package de distribution du gestionnaire de systèmes](https://docs.aws.amazon.com/systems-manager/latest/userguide/distributor.html), caller `AwsVssComponents`, qui comprend un *demandeur EC2 VSS* et un *fournisseur EC2 VSS*. Le package `AwsVssComponents` doit être installé sur les instances Windows EC2 pour prendre des instantanés de volumes EBS de la cohérence de l’application. Le schéma suivant illustre la relation entre ces composants logiciels.

![\[Composants du logiciel VSS\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/vss_components.png)


## Fonctionnement de la solution d’instantané Amazon EBS basée sur VSS
<a name="how-vss-works"></a>

Le processus de création de scripts d’instantanés EBS compatibles avec l’application et basés sur VSS se compose des étapes suivantes.

1. Terminez le [Conditions préalables à la création d’instantanés EBS basés sur Windows VSS](application-consistent-snapshots-prereqs.md).

1. Entrez les paramètres du document SSM `AWSEC2-VssInstallAndSnapshot` et exécutez ce document en utilisant Run Command. Pour de plus amples informations, veuillez consulter [Exécuter le document VssInstallAndSnapshot de commande AWSEC2 - (recommandé)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).

1. Le service Windows VSS de votre instance coordonne toutes les I/O opérations en cours d'exécution des applications. 

1. Le système vide tous les I/O tampons et interrompt temporairement toutes les opérations. I/O Cette interruption dure, au maximum, dix secondes.

1. Pendant cette suspension, le système crée des instantanés de tous les volumes attachés à l’instance.

1. La pause est levée et le fonctionnement I/O reprend. 

1. Le système ajoute tous les nouveaux instantanés à la liste des instantanés EBS. **Le système étiquette tous les instantanés EBS basés sur VSS créés avec succès par ce processus avec:true. AppConsistent**

1. Si vous devez effectuer une restauration à partir d’un instantané, vous pouvez utiliser le processus EBS standard de création d’un volume à partir d’un instantané. Vous pouvez également restaurer tous les volumes vers une instance en utilisant un exemple de script. Cette procédure est décrite dans la section [Utilisez la solution AWS VSS pour restaurer les données de votre instance](application-consistent-snapshots-restore.md).

# Conditions préalables à la création d’instantanés EBS basés sur Windows VSS
<a name="application-consistent-snapshots-prereqs"></a>

Vous pouvez créer des instantanés EBS basés sur VSS avec Systems Manager Run Command ou Amazon Data AWS Backup Lifecycle Manager. Les conditions suivantes s’appliquent à toutes les solutions.

**[Configuration système requise](#vss-sys-reqs)**  
Assurez-vous que votre instance Windows EC2 répond à toutes les exigences du système pour créer des instantanés basés sur VSS, y compris les versions prises en charge du système d'exploitation Windows, du framework .NET et de l' AWS Tools for Windows PowerShell agent. PowerShell AWS Systems Manager 

**[Autorisations IAM](vss-iam-reqs.md)**  
Le rôle IAM associé à votre instance Amazon EC2 Windows doit être autorisé à créer des instantanés compatibles avec l’application à l’aide de VSS. Pour accorder les autorisations nécessaires, vous pouvez associer la politique gérée `AWSEC2VssSnapshotPolicy` à votre profil d’instance.

**[Composants VSS](application-consistent-snapshots-getting-started.md)**  
Pour créer des instantanés cohérents avec les applications sur les systèmes d’exploitation Windows, le package `AwsVssComponents` doit être installé sur l’instance. Le package contient un agent VSS EC2 sur instance qui fonctionne en tant que demandeur VSS et fournisseur VSS EC2 pour les volumes EBS.

## Configuration système requise
<a name="vss-sys-reqs"></a>

**Installer l’agent du gestionnaire de systèmes**  
Le VSS est orchestré par l'agent Systems Manager à l'aide de. PowerShell Assurez-vous que vous avez installé SSM Agent version `3.0.502.0` ou une version ultérieure sur votre instance EC2. Si vous utilisez déjà une ancienne version de SSM Agent, mettez-la à jour à l’aide de la fonctionnalité Exécuter la commande. Pour plus d’informations, consultez les sections [Configuration de Systems Manager pour des instances Amazon EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html) et [Utilisation de SSM Agent sur des instances Amazon EC2 pour Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent-windows.html) dans le *Guide de l’utilisateur AWS Systems Manager *.

**Exigences des instances Windows Amazon EC2**  
Les instantanés EBS basés sur VSS sont pris en charge dans le cas des instances exécutant Windows Server 2016 et les versions ultérieures.

**Version de .NET Framework**  
Le package `AwsVssComponents` nécessite .NET Framework version `4.6` ou ultérieure. Les versions du système d’exploitation Windows antérieures à Windows Server 2016 utilisent par défaut une version antérieure du cadre .NET. Si votre instance utilise une version antérieure du cadre .NET, vous devez installer la version `4.6` ou une version ultérieure à l’aide de la mise à jour de Windows.

**AWS Tools for Windows PowerShell version**  
Assurez-vous que votre instance exécute la AWS Tools for Windows PowerShell version `3.3.48.0` ou une version ultérieure. Pour vérifier votre version, exécutez la commande suivante dans le PowerShell terminal de l'instance.  

```
C:\> Get-AWSPowerShellVersion
```
Si vous devez effectuer une mise à jour AWS Tools for Windows PowerShell sur votre instance, consultez la section [Installation du AWS Tools for Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up-windows.html) dans le *guide de Outils AWS pour PowerShell l'utilisateur*.

** PowerShell Version Windows**  
Assurez-vous que votre instance exécute la version PowerShell majeure de Windows `3``4`, ou`5`. Pour vérifier votre version, exécutez la commande suivante dans un PowerShell terminal de l'instance.  

```
C:\> $PSVersionTable.PSVersion
```

**PowerShell mode de langue**  
Assurez-vous que le mode de PowerShell langue de votre instance est défini sur`FullLanguage`. Pour plus d’informations, veuillez consulter [about\$1Language\$1Modes](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_language_modes?view=powershell-7.3) dans la documentation Microsoft.

# Utiliser une politique gérée par IAM pour accorder des autorisations pour les instantanés basés sur VSS
<a name="vss-iam-reqs"></a>

La politique AWSEC2VssSnapshotPolicy gérée permet à Systems Manager d’effectuer les actions suivantes sur votre instance Windows :
+ Créez et balisez des instantanés EBS
+ Créez et étiquetez Amazon Machine Images (AMIs)
+ Attachez des métadonnées telles que l’ID du périphérique aux balises d’instantané par défaut créées par VSS.

Cette rubrique décrit les détails des autorisations pour la politique gérée par VSS et explique comment l’associer au rôle IAM de votre profil d’instance EC2.

**Topics**
+ [AWSEC2VssSnapshotPolicydétails de la politique gérée](#vss-iam-manpol-AWSEC2VssSnapshotPolicy)
+ [Associez la politique de gestion des instantanés VSS à votre rôle de profil d’instance](#vss-snapshots-attach-policy)

## AWSEC2VssSnapshotPolicydétails de la politique gérée
<a name="vss-iam-manpol-AWSEC2VssSnapshotPolicy"></a>

Une politique AWS gérée est une politique autonome proposée par Amazon aux AWS clients. AWS les politiques gérées sont conçues pour accorder des autorisations pour les cas d'utilisation courants. Vous ne pouvez pas modifier les autorisations définies dans les politiques AWS gérées. Toutefois, vous pouvez copier la politique et l’utiliser comme référence pour une [politique gérée par le client](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#customer-managed-policies) spécifique à votre cas d’utilisation.

 Pour plus d'informations sur les politiques AWS gérées, voir les [politiques AWS gérées](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) dans le *guide de l'utilisateur IAM*.

Pour utiliser la politique **AWSEC2VssSnapshotPolicy**gérée, vous pouvez l’associer au rôle IAM associé à vos instances Windows EC2. Cette politique permet à la solution EC2 VSS de créer et d'ajouter des balises aux Amazon Machine Images (AMIs) et aux instantanés EBS. Pour associer la politique, consultez [Associez la politique de gestion des instantanés VSS à votre rôle de profil d’instance](#vss-snapshots-attach-policy).

### Autorisations octroyées par AWSEC2VssSnapshotPolicy
<a name="vss-iam-manpol-AWSEC2VssSnapshotPolicy-details"></a>

La **AWSEC2VssSnapshotPolicy**politique inclut les autorisations Amazon EC2 suivantes pour permettre à Amazon EC2 de créer et de gérer des instantanés VSS en votre nom. Vous pouvez associer cette politique gérée au rôle de profil d’instance IAM que vous utilisez pour vos instances Windows EC2.
+ **ec2 : CreateTags** — Ajoutez des balises aux instantanés EBS AMIs pour aider à identifier et à classer les ressources.
+ **ec2 : DescribeInstanceAttribute** — Récupérez les volumes EBS et les mappages de périphériques de blocs correspondants attachés à l'instance cible.
+ **ec2 : CreateSnapshots** — Créez des instantanés des volumes EBS.
+ **ec2 : CreateImage** — Créez une AMI à partir d'une instance EC2 en cours d'exécution.
+ **ec2 : DescribeImages** — Récupère les informations pour EC2 AMIs et les instantanés.
+ **ec2 : DescribeSnapshots** — Déterminez l'heure de création et le statut des instantanés afin de vérifier la cohérence de l'application.

**Note**  
Pour afficher les détails relatifs aux autorisations pour cette politique, consultez [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSEC2VssSnapshotPolicy.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSEC2VssSnapshotPolicy.html) dans la *Référence des politiques gérées AWS *.

### Simplifier les autorisations pour des cas d’utilisation spécifiques - niveau avancé
<a name="scope-down-perms"></a>

La politique `AWSEC2VssSnapshotPolicy` gérée inclut des autorisations pour toutes les manières dont vous pouvez créer des instantanés basés sur VSS. Vous pouvez créer une politique personnalisée qui inclut uniquement les autorisations dont vous avez besoin.

**Cas d'utilisation : créer une AMI, Cas d'utilisation : utiliser AWS Backup un service**

Si vous utilisez exclusivement `CreateAmi` cette option, ou si vous créez des instantanés basés sur VSS uniquement via le AWS Backup service, vous pouvez rationaliser les déclarations de politique comme suit.
+ Omettez les déclarations de politique identifiées par l'énoncé suivant IDs (SIDs) :
  + `CreateSnapshotsWithTag`
  + `CreateSnapshotsAccessInstance`
  + `CreateSnapshotsAccessVolume`
+ Ajustez l’`CreateTagsOnResourceCreation`énoncé comme suit :
  + Supprimer `arn:aws:ec2:*:*:snapshot/*` des ressources.
  + Supprimer `CreateSnapshots` de la `ec2:CreateAction` condition.
+ Ajustez l’`CreateTagsAfterResourceCreation`instruction pour la `arn:aws:ec2:*:*:snapshot/*` supprimer des ressources.
+ Ajustez l’`DescribeImagesAndSnapshots`instruction à supprimer `ec2:DescribeSnapshots` de l’action de la déclaration.

**Cas d’utilisation : Snapshot uniquement**

Si vous n’utilisez pas `CreateAmi` cette option, vous pouvez rationaliser les déclarations de politique comme suit.
+ Omettez les déclarations de politique identifiées par l'énoncé suivant IDs (SIDs) :
  + `CreateImageAccessInstance`
  + `CreateImageWithTag`
+ Ajustez l’`CreateTagsOnResourceCreation`énoncé comme suit :
  + Supprimer `arn:aws:ec2:*:*:image/*` des ressources.
  + Supprimer `CreateImage` de la `ec2:CreateAction` condition.
+ Ajustez l’`CreateTagsAfterResourceCreation`instruction pour la `arn:aws:ec2:*:*:image/*` supprimer des ressources.
+ Ajustez l’`DescribeImagesAndSnapshots`instruction à supprimer `ec2:DescribeImages` de l’action de la déclaration.

**Note**  
Pour garantir que votre politique personnalisée fonctionne comme prévu, nous vous recommandons de consulter et d’intégrer régulièrement des mises à jour à la politique gérée.

## Associez la politique de gestion des instantanés VSS à votre rôle de profil d’instance
<a name="vss-snapshots-attach-policy"></a>

Pour accorder des autorisations pour les instantanés basés sur VSS pour votre instance Windows EC2, vous pouvez associer la politique **AWSEC2VssSnapshotPolicy**gérée à votre rôle de profil d’instance comme suit. Il est important de vous assurer que votre instance répond à toutes les exigences[Configuration système requise](application-consistent-snapshots-prereqs.md#vss-sys-reqs).

**Note**  
Pour utiliser la politique gérée, la version `AwsVssComponents` du package `2.3.1` ou une version ultérieure doit être installée sur votre instance. Pour l’historique des versions, voir[AwsVssComponents versions du package](vss-comps-history.md#AwsVssComponents-history).

1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Dans le volet de navigation, choisissez **Rôles** pour afficher la liste des rôles IAM auxquels vous avez accès.

1. Sélectionnez le lien **Nom** du rôle associé à votre instance. La page contenant les détails du rôle s’ouvre.

1. Pour joindre la politique gérée, choisissez **Ajouter des autorisations**, dans le coin supérieur droit du panneau de liste. Ensuite choisissez **Associer des politiques** dans la liste déroulante.

1. Pour rationaliser les résultats, saisissez le nom de la stratégie dans la barre de recherche (`AWSEC2VssSnapshotPolicy`).

1. Cochez la case située en regard du nom de la stratégie à associer, puis sélectionnez **Ajouter des autorisations**.

# Gestion du package de composants VSS pour les instantanés EBS basés sur Windows VSS
<a name="application-consistent-snapshots-getting-started"></a>

Avant de créer des instantanés EBS basés sur VSS, assurez-vous que la dernière version du package de composants VSS est installée sur votre instance Windows. Il y a plusieurs façons d’installer le package `AwsVssComponents` sur une instance existante, comme suit :
+ (Recommandé) [Exécuter le document VssInstallAndSnapshot de commande AWSEC2 - (recommandé)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot). Cela s’installe ou se met à jour automatiquement si nécessaire à chaque exécution.
+ [Installer manuellement les composants VSS sur une instance EC2 Windows](#install-vss-comps).
+ [Mettez à jour le paquet de composants VSS sur votre instance EC2 Windows](#update-vss-comps).

Vous pouvez également créer une AMI avec EC2 Image Builder qui utilise le composant géré `aws-vss-components-windows` pour installer le package `AwsVssComponents` pour l’image. Le composant géré utilise AWS Systems Manager Distributor pour installer le package. Une fois qu’Image Builder a créé l’image, le package VSS est installé sur chaque instance que vous lancez depuis l’AMI associée. Pour plus d’informations sur la création d’une AMI sur laquelle le package VSS est installé, veuillez consulter la rubrique [Distributor package managed components for Windows](https://docs.aws.amazon.com/imagebuilder/latest/userguide/mgdcomponent-distributor-win.html) dans le *Guide de l’utilisateur EC2 Image Builder*.

**Topics**
+ [Installer manuellement](#install-vss-comps)
+ [Mettre les composants à jour](#update-vss-comps)

## Installer manuellement les composants VSS sur une instance EC2 Windows
<a name="install-vss-comps"></a>

Les composants VSS doivent être installés sur votre instance EC2 Windows avant que vous puissiez créer des instantanés cohérents avec l’application à l’aide de Systems Manager. Si vous n’exécutez pas le document de commande `AWSEC2-VssInstallAndSnapshot` pour installer ou mettre à jour automatiquement le package chaque fois que vous créez des instantanés cohérents avec les applications, vous devez installer le package manuellement.

Vous devez également effectuer l’installation manuellement si vous envisagez d’utiliser l’une des méthodes suivantes pour créer des instantanés cohérents avec les applications à partir de votre instance EC2.
+ Créez des instantanés VSS à l'aide de AWS Backup
+ Création d’instantanés VSS à l’aide d’Amazon Data Lifecycle Manager

Si vous devez effectuer une installation manuelle, nous vous recommandons d'utiliser le dernier package de composants AWS VSS pour améliorer la fiabilité et les performances des instantanés cohérents avec les applications sur vos instances Windows EC2.

**Note**  
Pour installer ou mettre à jour automatiquement le package `AwsVssComponents` chaque fois que vous créez des instantanés cohérents avec les applications, nous vous recommandons d’utiliser Systems Manager pour exécuter le document. `AWSEC2-VssInstallAndSnapshot` Pour de plus amples informations, veuillez consulter [Exécuter le document VssInstallAndSnapshot de commande AWSEC2 - (recommandé)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).

Pour installer les composants VSS sur une instance Windows Amazon EC2, suivez les étapes correspondant à votre environnement préféré.

------
#### [ Console ]

**Pour installer les composants VSS à l’aide de SSM Distributor**

1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, choisissez **Fonctionnalité Exécuter la commande**.

1. Choisissez **Run Command (Exécuter la commande)**.

1. Pour le **document de commande**, cliquez sur le bouton à côté de **AWS-Configure AWSPackage**.

1. Dans **Command parameters (Paramètres de la commande)**, procédez comme suit :

   1. Vérifiez que l’option **Action** est définie sur **Install (Installer)**.

   1. Pour **Nom**, saisissez `AwsVssComponents`.

   1. Pour **Version**, saisissez un numéro de version ou laissez le champ vide pour que Systems Manager installe la dernière version.

1. Dans la section **Targets (Cibles)**, identifiez les instances sur lesquelles vous souhaitez exécuter cette opération en spécifiant les balises ou en sélectionnant manuellement les instances.
**Note**  
Si vous choisissez de sélectionner les instances manuellement et qu’une instance que vous vous attendez à voir ne figure pas dans la liste, consultez [Où sont mes instances ?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) dans le *Guide de l’utilisateur AWS Systems Manager * pour obtenir des conseils de résolution d’incident.

1. Pour **Autres paramètres** :
   + (Facultatif) Pour **Comment (Commentaire)**, saisissez les informations relatives à cette commande.
   + Pour **Délai (secondes)**, précisez le nombre de secondes durant lesquelles le système doit attendre avant de mettre en échec l’exécution de la commande globale. 

1. (Facultatif) Pour **Contrôle du débit** :
   + Pour **Concurrency (Simultanéité)**, spécifiez un nombre ou un pourcentage d’instances sur lesquelles exécuter simultanément la commande.
**Note**  
Si vous avez sélectionné des cibles en choisissant des balises Amazon EC2, et que vous n’êtes pas sûr du nombre d’instances qui utilisent les balises sélectionnées, limitez le nombre d’instances pouvant exécuter simultanément le document en spécifiant un pourcentage.
   + Pour **Seuil d’erreur**, spécifiez quand arrêter l’exécution de la commande sur d’autres instances après son échec sur un nombre ou un pourcentage d’instances. Si, par exemple, vous spécifiez trois erreurs, Systems Manager cesse d’envoyer la commande à la réception de la quatrième erreur. Les instances sur lesquelles la commande est en cours de traitement peuvent également envoyer des erreurs.

1. (Facultatif) Dans la section **Output options (Options de sortie)**, si vous souhaitez enregistrer la sortie de la commande dans un fichier, sélectionnez **Enable writing to an S3 bucket (Autoriser l’écriture dans un compartiment S3)** Spécifiez les noms du compartiment et (facultatif) du préfixe (dossier).
**Note**  
Les autorisations S3 qui accordent la possibilité d’écrire les données dans un compartiment S3 sont celles du profil d’instance attribué à l’instance, et non celles de l’utilisateur qui effectue cette tâche. Pour plus d’informations, consultez la section [Configuration des autorisations d’instance EC2](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-instance-permissions.html#instance-profile-add-permissions) dans le *Guide de l’utilisateur AWS Systems Manager *. 

1. (Facultatif) Spécifiez les options pour les **notifications SNS**.

   Pour plus d’informations sur la configuration des notifications Amazon SNS pour Run Command, consultez [Configuration des notifications Amazon SNS pour AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/monitoring-sns-notifications.html).

1. Cliquez sur **Exécuter**.

------
#### [ AWS CLI ]

Utilisez la procédure suivante pour télécharger et installer le package `AwsVssComponents` sur vos instances en utilisant Run Command depuis AWS CLI. Le programme installe deux composants : un demandeur VSS et un fournisseur VSS. Le système copie ces composants dans un répertoire sur l’instance, puis enregistre la DLL du fournisseur comme fournisseur VSS.

**Pour installer le package VSS**  
Exécutez la commande suivante pour télécharger et installer les composants VSS requis pour Systems Manager.

```
aws ssm send-command \
    --document-name "AWS-ConfigureAWSPackage" \
    --instance-ids "i-1234567890abcdef0" \
    --parameters '{"action":["Install"],"name":["AwsVssComponents"]}'
```

------
#### [ PowerShell ]

Suivez la procédure ci-dessous pour télécharger et installer le `AwsVssComponents` package sur vos instances à l'aide de la commande Exécuter la commande depuis les outils pour Windows PowerShell. Le programme installe deux composants : un demandeur VSS et un fournisseur VSS. Le système copie ces composants dans un répertoire sur l’instance, puis enregistre la DLL du fournisseur comme fournisseur VSS.

**Pour installer le package VSS**  
Exécutez la commande suivante pour télécharger et installer les composants VSS requis pour Systems Manager.

```
Send-SSMCommand `
    -DocumentName "AWS-ConfigureAWSPackage" `
    -InstanceId "i-1234567890abcdef0" `
    -Parameter @{'action'='Install';'name'='AwsVssComponents'}
```

------

### Vérifiez la signature sur les composants AWS VSS
<a name="verify-ssm-comps"></a>

Utilisez la procédure suivante pour vérifier la signature sur le package `AwsVssComponents`.

1. Connectez-vous à votre instance Windows. Pour de plus amples informations, veuillez consulter [Se connecter à votre instance Windows à l’aide de RDP](connecting_to_windows_instance.md).

1. Accédez à C:\$1Program Files \$1 Amazon \$1AwsVssComponents.

1. Ouvrez le menu contextuel (clic droit) pour `ec2-vss-agent.exe`, puis choisissez **Propriétés**.

1. Accédez à l’onglet **Signatures numériques** et vérifiez que le nom du signataire est Amazon Web Services Inc.

1. Suivez les étapes précédentes pour vérifier la signature sur `Ec2VssInstaller` et `Ec2VssProvider.dll`.

## Mettez à jour le paquet de composants VSS sur votre instance EC2 Windows
<a name="update-vss-comps"></a>

Nous vous recommandons de maintenir les composants VSS à jour avec la dernière version recommandée. Il existe plusieurs façons de mettre à jour les composants lorsqu’une nouvelle version du package `AwsVssComponents` est publiée.

**Méthodes de mise à jour**
+ Vous pouvez répéter les étapes décrites [Installer manuellement les composants VSS sur une instance EC2 Windows](#install-vss-comps) lors de la publication d'une nouvelle version des composants AWS VSS.
+ Vous pouvez configurer une association Systems Manager State Manager pour télécharger et installer automatiquement de nouveaux composants VSS ou des composants mis à jour lorsque le package `AwsVssComponents` est disponible.
+ Vous pouvez installer ou mettre à jour automatiquement le package `AwsVssComponents` chaque fois que vous créez des instantanés cohérents avec les applications, lorsque vous utilisez Systems Manager pour exécuter le document `AWSEC2-VssInstallAndSnapshot`.

**Note**  
Nous vous recommandons d’utiliser Systems Manager pour exécuter le document de commande `AWSEC2-VssInstallAndSnapshot`, qui installe ou met à jour automatiquement le package `AwsVssComponents` avant qu’il ne crée les instantanés cohérents avec les applications. Pour de plus amples informations, veuillez consulter [Exécuter le document VssInstallAndSnapshot de commande AWSEC2 - (recommandé)](create-vss-snapshots-ssm.md#create-with-AWSEC2-VssInstallAndSnapshot).

Pour créer une association Systems Manager State Manager, suivez les étapes correspondant à votre environnement préféré.

------
#### [ Console ]

Lorsque vous créez une association Systems Manager State Manager, deux options s’offrent à vous pour mettre à jour le package `AwsVssComponents`, comme suit :

**Désinstaller et réinstaller**  
Cette méthode télécharge et installe le package sans aucune condition préalable supplémentaire.

**Mettre à jour en place**  
Cela permet d’effectuer une mise à jour en place du package et de remplir les conditions préalables suivantes :  
+ La version de l’agent SSM installée sur l’instance doit être la version `3.3.808.0` ou ultérieure. Pour plus d’informations, consultez [Utilisation de l’agent SSM sur les instances EC2 pour Windows Server](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-agent-windows.html) dans le *Guide de l’utilisateur AWS Systems Manager *.
+ Si elle est spécifiée, la version `AwsVssComponents` du package doit être la version `2.5.0` ou ultérieure. Les versions antérieures ne prennent pas en charge les mises à jour en place.
Si votre instance ne répond pas à ces conditions préalables, la mise à jour en place échouera. Utilisez plutôt l’option **Désinstaller et réinstaller**.

**Pour créer une association State Manager**

1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le volet de navigation, sélectionnez **State Manager**.

   Ou, si la page d’accueil de Systems Manager s’ouvre en premier, ouvrez le volet de navigation, puis choisissez **State Manager**.

1. Sélectionnez **Créer une association**.

1. Dans le champ **Name (Nom)**, saisissez un nom évocateur.

1. Dans la liste des **documents**, choisissez **AWSPackageAWS-Configure**.

1. Dans la section **Paramètres**, sélectionnez **Installer** dans la liste **Action**.

1. Pour **Type d’installation**, sélectionnez **Désinstaller et réinstaller** ou **Mettre à jour en place**.

1. Dans le champ **Nom**, saisissez `AwsVssComponents`. Vous pouvez ne rien inscrire dans les champs **Version** et **Additional Arguments (Arguments supplémentaires)**.

1. Dans la section **Targets (Cibles)**, sélectionnez une option.
**Note**  
Si vous choisissez de cibler les instances à l’aide de balises, et que vous spécifiez des balises qui correspondent à des instances Linux, l’association réussit sur l’instance Windows, mais échoue sur les instances Linux. Le statut global de l’association indique **Failed**.

1. Dans la section **Spécifier le programme**, sélectionnez une option. 

1. Dans la section **Advanced options (Options avancées)**, pour **Compliance severity (Sévérité de conformité)**, sélectionnez un niveau de sévérité pour l’association. Pour plus d’informations, consultez la section [En savoir plus sur la conformité des associations](https://docs.aws.amazon.com/systems-manager/latest/userguide/compliance-about.html). Pour les **Calendriers de modifications**, sélectionnez un calendrier de modifications préconfiguré. Pour de plus amples informations, consultez [AWS Systems Manager Change Calendar](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-change-calendar.html).

1. Pour **Contrôle du débit**, procédez comme suit :
   + Dans **Concurrency (Simultanéité)**, spécifiez un nombre ou un pourcentage de nœuds gérés sur lesquels exécuter simultanément la commande.
   + Dans **Error threshold (Seuil d’erreur)**, indiquez quand arrêter l’exécution de la commande sur les autres nœuds gérés après l’échec de celle-ci sur un certain nombre ou un certain pourcentage de nœuds.

1. (Facultatif) Dans **Options de sortie**, pour enregistrer la sortie de la commande dans un fichier, sélectionnez **Autoriser l’écriture dans un compartiment S3**. Saisissez les noms de compartiment et de préfixe (dossier) dans les zones.

1. Sélectionnez **Create association (Créer une association)**, puis **Close (Fermer)**. Le système tente de créer l’association sur les instances et applique immédiatement l’état.
**Note**  
Si les instances EC2 pour Windows Server affichent le statut **Failed**, vérifiez que l'agent SSM est en cours d'exécution sur l'instance et vérifiez que l'instance est configurée avec un rôle Gestion des identités et des accès AWS (IAM) pour Systems Manager. Pour plus d'informations, consultez [la section Configuration AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-ec2.html).

------
#### [ AWS CLI ]

Utilisez la commande [create-association](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html) pour mettre à jour un package de distributeur selon un calendrier défini sans mettre l’application associée hors ligne. Seuls les fichiers nouveaux ou mis à jour dans le package sont remplacés.

**Pour créer une association State Manager**  
Exécutez la commande suivante pour créer une association. La valeur de `--name`, le nom du document, est toujours `AWS-ConfigureAWSPackage`. La commande suivante utilise la clé `InstanceIds` pour spécifier les instances cibles.

```
aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters action=Install,installationType="Uninstall and reinstall",name=AwsVssComponents \
    --targets Key=InstanceIds,Values=i-1234567890abcdef0,i-000011112222abcde
```

------
#### [ PowerShell ]

**Pour créer une association State Manager**  
Utilisez l'SSMAssociationapplet de commande [New-](https://docs.aws.amazon.com/powershell/latest/reference/items/New-SSMAssociation.html).

```
New-SSMAssociation `
    -Name "AWS-ConfigureAWSPackage" `
    -Parameter  @{
        "action" = "Install"
        "installationType" = "Uninstall and reinstall"
        "name" = "AwsVssComponents"
    } `
    -Target @{
        "Key" = "InstanceIds" 
        "Values" = @("i-1234567890abcdef0", "i-000011112222abcde")
    }
```

------

# Créez des instantanés EBS basés sur VSS pour votre instance Windows EC2
<a name="create-vss-snaps"></a>

Une fois que vous avez satisfait à toutes les exigences[Conditions préalables à la création d’instantanés EBS basés sur Windows VSS](application-consistent-snapshots-prereqs.md), vous pouvez utiliser l’une des méthodes suivantes pour créer des instantanés basés sur VSS à partir de votre instance EC2.

**AWS Systems Manager documents de commande**  
[Utiliser les documents de commande de Systems Manager](create-vss-snapshots-ssm.md)pour créer des instantanés basés sur VSS.  
Pour automatiser les sauvegardes, vous pouvez créer une tâche de fenêtre de AWS Systems Manager maintenance qui utilise le document de `AWSEC2-VssInstallAndSnapshot` commande. Pour plus d’informations, consultez [Utilisation des fenêtres de maintenance (console)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-working.html) dans le *Guide de l’utilisateur AWS Systems Manager *.

**AWS Backup**  
Vous pouvez créer une sauvegarde VSS lors de l'utilisation en AWS Backup activant VSS dans la console ou la CLI. Pour plus d’informations sur cette fonction, consultez.[Creating Windows VSS backups](https://docs.aws.amazon.com/aws-backup/latest/devguide/windows-backups.html) dans le *Guide du développeur AWS Backup *.  
AWS Backup n'installe pas automatiquement le `AwsVssComponents` package sur votre instance. Vous devez effectuer une installation manuelle sur votre instance. Pour de plus amples informations, veuillez consulter [Installer manuellement les composants VSS sur une instance EC2 Windows](application-consistent-snapshots-getting-started.md#install-vss-comps).

**Amazon Data Lifecycle Manager**  
Vous pouvez créer des instantanés VSS à l’aide d’Amazon Data Lifecycle Manager en activant les pré-scripts et les post-scripts dans vos politiques de cycle de vie des instantanés. Pour plus d’informations, consultez [Automatiser les instantanés cohérents avec les applications dans](https://docs.aws.amazon.com/ebs/latest/userguide/automate-app-consistent-backups.html) le guide de l’utilisateur *Amazon* EBS.  
Amazon Data Lifecycle Manager n’installe pas automatiquement le package `AwsVssComponents` sur votre instance. Vous devez effectuer une installation manuelle sur votre instance. Pour de plus amples informations, veuillez consulter [Installer manuellement les composants VSS sur une instance EC2 Windows](application-consistent-snapshots-getting-started.md#install-vss-comps).

# Utilisez des documents de commande de Systems Manager pour créer des instantanés basés pour VSS
<a name="create-vss-snapshots-ssm"></a>

Vous pouvez utiliser des documents de AWS Systems Manager commande pour créer des instantanés basés sur VSS. Le contenu suivant présente les documents de commande disponibles et les paramètres d’exécution utilisés par ces documents pour créer vos instantanés.

Avant d’utiliser l’un des documents de commande de Systems Manager, assurez-vous d’avoir respecté toutes les [Conditions préalables à la création d’instantanés EBS basés sur Windows VSS](application-consistent-snapshots-prereqs.md).

**Topics**
+ [Paramètres des documents d’instantanés VSS Systems Manager](#create-vss-snapshots-ssm-params)
+ [Exécution de documents de commande d’instantanés VSS Systems Manager](#create-vss-snapshots-ssm-methods)

## Paramètres des documents d’instantanés VSS Systems Manager
<a name="create-vss-snapshots-ssm-params"></a>

Les documents Systems Manager qui créent des instantanés VSS utilisent tous les paramètres suivants, sauf indication contraire :

**AmiName**(chaîne, facultatif)  
Si l'**CreateAmi**option est définie sur`True`, spécifiez le nom de l'AMI créée par la sauvegarde.

**description** : (chaîne, facultatif)  
Spécifiez une description pour les instantanés ou les images créés par ce processus.

**CollectDiagnosticLogs**(chaîne, facultatif)  
Pour collecter plus d’informations lors des étapes de création d’instantanés et d’AMI, définissez ce paramètre sur « `True` ». La valeur par défaut de ce paramètre est « `False` ». Les journaux de diagnostic consolidés sont enregistrés sous `.zip` forme d’archive au format à l’emplacement suivant sur votre instance :  
`C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip`

**CopyOnly**(chaîne, facultatif)  
Si vous utilisez la sauvegarde native de SQL Server en plus de AWS VSS, l'exécution d'une sauvegarde avec copie uniquement empêche AWS VSS de rompre la chaîne de sauvegarde différentielle native. Pour effectuer une opération de sauvegarde par copie uniquement, définissez ce paramètre sur `True`.  
La valeur par défaut de ce paramètre est`False`, ce qui oblige AWS VSS à effectuer une opération de sauvegarde complète.

**CreateAmi**(chaîne, facultatif)  
Pour créer une Amazon Machine Image (AMI) basée sur VSS afin de sauvegarder votre instance, définissez ce paramètre sur `True`. La valeur par défaut de ce paramètre est `False`, qui sauvegarde votre instance avec un instantané EBS à la place.  
Pour plus d’informations sur la création d’une AMI à partir d’une instance , consultez la page [Créer une AMI basée sur Amazon EBS](creating-an-ami-ebs.md).

**executionTimeout** (chaîne, facultatif)  
Indiquez la durée maximale en secondes pour exécuter le processus de création d’instantanés sur l’instance ou pour créer une AMI à partir de l’instance. L’augmentation de ce délai d’expiration permet à la commande d’attendre plus longtemps pour que VSS commence à se figer et termine le balisage des ressources qu’elle crée. Ce délai ne s’applique qu’aux étapes de création d’instantané ou d’AMI. L’étape initiale d’installation ou de mise à jour du package `AwsVssComponents` n’est pas incluse dans le délai d’expiration.

**ExcludeBootVolume**(chaîne, facultatif)  
Ce paramètre exclut les volumes de démarrage du processus de sauvegarde si vous créez des instantanés. Pour exclure les volumes de démarrage de vos instantanés, définissez **ExcludeBootVolume**les paramètres sur `True` et **CreateAmi**sur`False`.  
Si vous créez une AMI pour votre sauvegarde, ce paramètre doit être défini sur `False`. La valeur par défaut de ce paramètre est `False`.

**NoWriters**(chaîne, facultatif)  
Définissez ce paramètre sur `True` pour exclure les enregistreurs VSS d’application du processus de capture instantanée. L’exclusion d’enregistreurs VSS d’application peut vous aider à résoudre les conflits avec des composants de sauvegarde VSS tiers. La valeur par défaut de ce paramètre est `False`.  
Si `SaveVssMetadata` est `True`, ce paramètre doit être réglé sur `False`.

**SaveVssMetadata**(chaîne, facultatif)  
Pour enregistrer les fichiers de métadonnées VSS lors de chaque instantané, définissez ce paramètre sur`True`. La valeur par défaut est `False`. Ces fichiers permettent de savoir quels composants ou rédacteurs ont été inclus dans une opération de sauvegarde, ainsi que les fichiers et volumes associés à chaque instantané. Les fichiers de métadonnées sont utilisés lors de la restauration d'une base de données SQL à l'aide de la solution de restauration VSS. Pour plus d'informations sur la restauration d'une base de données SQL à partir de snapshots VSS, voir [Utiliser un runbook d'automatisation pour restaurer votre base de données à partir de snapshots de solution AWS VSS](https://docs.aws.amazon.com/sql-server-ec2/latest/userguide/ms-ssdb-ec2-restore-vss.html).  
Le nom des fichiers de métadonnées contient l’identifiant du jeu de snapshots associé. Vous pouvez les trouver à l’emplacement suivant sur votre instance :  

```
C:\ProgramData\Amazon\AwsVss\VssMetadata\
```
+ L’enregistrement des fichiers de métadonnées VSS nécessite la version 2.4.0 ou ultérieure `AwsVssComponents` du package. Si une version antérieure de votre instance est installée, la définition sur `SaveVssMetadata` `True` entraîne l’échec de la création du snapshot.
+ Les paramètres de `NoWriters` et de `SaveVssMetadata` s’excluent mutuellement. Si les deux sont définis sur, la création d’un instantané `True` échoue.

**tags** (chaîne, facultatif)  
Nous vous recommandons de baliser vos instantanés et vos images pour vous aider à localiser et à gérer vos ressources, par exemple pour restaurer des volumes à partir d’une liste d’instantanés. Le système ajoute la `Name` clé, avec une valeur vide dans laquelle vous pouvez spécifier le nom que vous souhaitez appliquer à vos instantanés ou images de sortie.  
Si vous souhaitez spécifier des balises supplémentaires, séparez-les par un point-virgule. Par exemple, `Key=Environment,Value=Test;Key=User,Value=TestUser1`.  
Les clés et valeurs des balises ne doivent contenir que des caractères alphanumériques et les caractères spéciaux suivants : `() ./\-"'@_+:={}`.
Par défaut, le système ajoute les balises réservées suivantes pour les instantanés et les images basés sur VSS.  
+ **Appareil** : pour les instantanés basés sur VSS, il s’agit du nom de périphérique du volume EBS capturé par le cliché.
+ **AppConsistent**— Cette balise indique la création réussie d'un instantané ou d'un AMI basé sur VSS.
+ **AwsVssConfig**— Cela identifie les instantanés et ceux AMIs qui sont créés avec le VSS activé. La balise inclut des méta-informations telles que la `AwsVssComponents` version et l’ID du Snapshot Set.
La spécification de l’une de ces balises réservées dans votre liste de paramètres provoquera une erreur.

**VssVersion**(chaîne, facultatif)  
Pour le document `AWSEC2-VssInstallAndSnapshot` uniquement, vous pouvez spécifier le paramètre `VssVersion` pour installer une version spécifique du package `AwsVssComponents` sur votre instance. Laissez ce paramètre vide pour installer la version par défaut recommandée.  
Si la version spécifiée du package `AwsVssComponents` est déjà installée, le script ignore l’étape d’installation et passe à l’étape de sauvegarde. Pour obtenir la liste des versions de package `AwsVssComponents` et du support d’exploitation, consultez [AWS Historique des versions de la solution VSS](vss-comps-history.md).

## Exécution de documents de commande d’instantanés VSS Systems Manager
<a name="create-vss-snapshots-ssm-methods"></a>

Vous pouvez créer des instantanés EBS basés sur VSS avec des documents de AWS Systems Manager commande comme suit.

### Exécuter le document VssInstallAndSnapshot de commande AWSEC2 - (recommandé)
<a name="create-with-AWSEC2-VssInstallAndSnapshot"></a>

Lorsque vous exécutez AWS Systems Manager le `AWSEC2-VssInstallAndSnapshot` document, le script exécute les étapes suivantes.

1. Le script commence par installer ou mettre à jour le package `AwsVssComponents` sur votre instance, selon qu’il est déjà installé ou non.

1. Le script crée les instantanés cohérents avec l’application une fois la première étape terminée.

Pour exécuter le document `AWSEC2-VssInstallAndSnapshot`, suivez les étapes correspondant à votre environnement préféré.

------
#### [ Console ]

**Créer des instantanés EBS basés sur VSS à partir de la console**

1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le volet de navigation, sélectionnez **Exécuter une commande**. Cela permet d’afficher une liste des commandes en cours d’exécution dans votre compte, le cas échéant.

1. Sélectionnez **Run Command (Exécuter la commande)**. Cela permet d’ouvrir la liste des documents de commande auxquels vous avez accès.

1. Sélectionnez `AWSEC2-VssInstallAndSnapshot` dans la liste des documents de commande. Pour rationaliser les résultats, vous pouvez saisir tout ou partie du nom du document. Vous pouvez également filtrer par propriétaire, par type de plateforme ou par balise.

   Lorsque vous sélectionnez un document de commande, les détails apparaissent sous la liste.

1. Sélectionnez `Default version at runtime` dans la liste **Version du document**.

1. Configurez les **paramètres de commande** pour définir la manière dont `AWSEC2-VssInstallAndSnapshot` va installer le package `AwsVssComponents` et va effectuer une sauvegarde à l’aide d’une AMI ou d’instantanés VSS. Pour plus de détails sur les paramètres, veuillez consulter la rubrique [Paramètres des documents d’instantanés VSS Systems Manager](#create-vss-snapshots-ssm-params).

1. Pour **Sélection de la cible**, spécifiez des balises ou sélectionnez des instances manuellement afin d’identifier les instances sur lesquelles vous souhaitez exécuter cette opération.
**Note**  
Si vous sélectionnez les instances manuellement et qu’une instance que vous vous attendez à voir ne figure pas dans la liste, consultez [Où sont mes instances ?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) pour obtenir des conseils de résolution d’incident.

1. Pour des paramètres supplémentaires permettant de définir le comportement de Exécuter la commande Systems Manager, tels que **Contrôle du débit**, entrez des valeurs comme décrit dans [Exécution des commande à partir de la console](https://docs.aws.amazon.com/systems-manager/latest/userguide/running-commands-console.html).

1. Cliquez sur **Run (Exécuter)**.

   En cas de réussite, la commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant `AppConsistent`. Si l’exécution de la commande a échoué, consultez la sortie de commande Systems Manager pour en connaître les raisons. Si la commande a réussi mais que la sauvegarde d’un volume spécifique a échoué, vous pouvez résoudre l’échec dans la liste des volumes EBS.

------
#### [ AWS CLI ]

Vous pouvez exécuter les commandes suivantes dans le AWS CLI pour créer des instantanés EBS basés sur VSS et obtenir l'état de la création de vos instantanés.

**Créez des instantanés EBS basés sur VSS**  
Exécutez la commande suivante pour créer des instantanés EBS basés sur VSS. Pour créer les instantanés, vous devez identifier les instances à l’aide du paramètre `--instance-ids`. Pour plus d’informations sur les autres paramètres que vous pouvez utiliser, veuillez consulter la rubrique [Paramètres des documents d’instantanés VSS Systems Manager](#create-vss-snapshots-ssm-params).

```
aws ssm send-command \
	--document-name "AWSEC2-VssInstallAndSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"],"VssVersion":[""]}'
```

En cas de réussite, le document de commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant `AppConsistent`. Si l’exécution de la commande a échoué, consultez la sortie de commande pour en connaître les raisons.

**Obtenir le statut de la commande**  
Pour obtenir l’état actuel des instantanés, exécutez la commande suivante à l’aide de l’ID de commande renvoyé par **send-command**.

```
aws ssm get-command-invocation
	--instance-ids "i-01234567890abcdef" \
	--command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
	--plugin-name "CreateVssSnapshot"
```

------
#### [ PowerShell ]

Exécutez les commandes suivantes AWS Tools for Windows PowerShell pour créer des instantanés EBS basés sur VSS et obtenir l'état d'exécution actuel pour la création de votre sortie. Spécifiez les paramètres décrits dans la liste précédente pour modifier le comportement du processus de capture instantanée.

**Créez des instantanés EBS basés sur VSS avec Tools for Windows PowerShell**  
Exécutez la commande suivante pour créer des instantanés EBS basés sur VSS ou. AMIs

```
Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
```

**Obtenir le statut de la commande**  
Pour obtenir l’état actuel des instantanés, exécutez la commande suivante à l’aide de l’ID de commande renvoyé par **Send-SSMCommand**.

```
Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"
```

En cas de réussite, la commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant `AppConsistent`. Si l’exécution de la commande a échoué, consultez la sortie de commande pour en connaître les raisons.

------

### Exécutez le document de CreateVssSnapshot commande AWSEC2 -
<a name="create-with-AWSEC2-CreateVssSnapshot"></a>

Pour exécuter le document `AWSEC2-CreateVssSnapshot`, suivez les étapes correspondant à votre environnement préféré.

------
#### [ Console ]

**Créer des instantanés EBS basés sur VSS à partir de la console**

1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le volet de navigation, sélectionnez **Exécuter une commande**. Cela permet d’afficher une liste des commandes en cours d’exécution dans votre compte, le cas échéant.

1. Sélectionnez **Run Command (Exécuter la commande)**. Cela permet d’ouvrir la liste des documents de commande auxquels vous avez accès.

1. Sélectionnez `AWSEC2-CreateVssSnapshot` dans la liste des documents de commande. Pour rationaliser les résultats, vous pouvez saisir tout ou partie du nom du document. Vous pouvez également filtrer par propriétaire, par type de plateforme ou par balise.

   Lorsque vous sélectionnez un document de commande, les détails apparaissent sous la liste.

1. Sélectionnez `Default version at runtime` dans la liste **Version du document**.

1. Configurez les **Paramètres de la commande** pour définir la manière dont `AWSEC2-CreateVssSnapshot` effectuera la sauvegarde avec des instantanés VSS ou une AMI. Pour plus de détails sur les paramètres, veuillez consulter la rubrique [Paramètres des documents d’instantanés VSS Systems Manager](#create-vss-snapshots-ssm-params).

1. Pour **Sélection de la cible**, spécifiez des balises ou sélectionnez des instances manuellement afin d’identifier les instances sur lesquelles vous souhaitez exécuter cette opération.
**Note**  
Si vous sélectionnez les instances manuellement et qu’une instance que vous vous attendez à voir ne figure pas dans la liste, consultez [Où sont mes instances ?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) pour obtenir des conseils de résolution d’incident.

1. Pour des paramètres supplémentaires permettant de définir le comportement de Exécuter la commande Systems Manager, tels que **Contrôle du débit**, entrez des valeurs comme décrit dans [Exécution des commande à partir de la console](https://docs.aws.amazon.com/systems-manager/latest/userguide/running-commands-console.html).

1. Cliquez sur **Run (Exécuter)**.

   En cas de réussite, la commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant `AppConsistent`. Si l’exécution de la commande a échoué, consultez la sortie de commande Systems Manager pour en connaître les raisons. Si la commande a réussi mais que la sauvegarde d’un volume spécifique a échoué, vous pouvez résoudre l’échec dans la liste des volumes EBS.

------
#### [ AWS CLI ]

Vous pouvez exécuter la commande suivante dans le AWS CLI pour créer des instantanés EBS basés sur VSS.

**Créez des instantanés EBS basés sur VSS**  
Exécutez la commande suivante pour créer des instantanés EBS basés sur VSS. Pour créer les instantanés, vous devez identifier les instances à l’aide du paramètre `--instance-ids`. Pour plus d’informations sur les autres paramètres que vous pouvez utiliser, veuillez consulter la rubrique [Paramètres des documents d’instantanés VSS Systems Manager](#create-vss-snapshots-ssm-params).

```
aws ssm send-command \
	--document-name "AWSEC2-CreateVssSnapshot" \
	--instance-ids "i-01234567890abcdef" \
	--parameters '{"ExcludeBootVolume":["False"],"description":["Description"],"tags":["Key=key_name,Value=tag_value"]}'
```

En cas de réussite, le document de commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant `AppConsistent`. Si l’exécution de la commande a échoué, consultez la sortie de commande pour en connaître les raisons.

------
#### [ PowerShell ]

Exécutez la commande suivante avec AWS Tools for Windows PowerShell pour créer des instantanés EBS basés sur VSS.

**Créez des instantanés EBS basés sur VSS avec Tools for Windows PowerShell**  
Exécutez la commande suivante pour créer des instantanés EBS basés sur VSS. Pour créer les instantanés, vous devez identifier les instances à l’aide du paramètre `InstanceId`. Vous pouvez spécifier plusieurs instances pour lesquelles créer des instantanés. Pour plus d’informations sur les autres paramètres que vous pouvez utiliser, veuillez consulter la rubrique [Paramètres des documents d’instantanés VSS Systems Manager](#create-vss-snapshots-ssm-params).

```
Send-SSMCommand -DocumentName AWSEC2-CreateVssSnapshot -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
	;'tags'='Key=key_name,Value=tag_value'}
```

En cas de réussite, la commande complète automatiquement la liste des instantanés EBS avec les nouveaux instantanés. Vous pouvez localiser ces instantanés dans la liste des instantanés EBS en recherchant les balises que vous avez précisées ou en recherchant `AppConsistent`. Si l’exécution de la commande a échoué, consultez la sortie de commande pour en connaître les raisons. Si la commande a réussi mais que la sauvegarde d’un volume spécifique a échoué, vous pouvez résoudre l’échec dans la liste des instantanés EBS.

------

### Exécution de documents de commande pour un cluster de basculement Windows avec stockage EBS partagé
<a name="create-vss-win-failover-cluster"></a>

Vous pouvez utiliser l’une des procédures de ligne de commande décrites dans la section précédente pour créer un instantané basé sur VSS. Le document de commande (`AWSEC2-VssInstallAndSnapshot` ou `AWSEC2-CreateVssSnapshot`) doit être exécuté sur le nœud primaire de votre cluster. Le document échoue sur les nœuds secondaires, car ils n’ont pas accès aux disques partagés. Si vos paramètres principal et secondaire changent de manière dynamique, vous pouvez exécuter le document AWS Systems Manager Exécuter la commande sur plusieurs nœuds en espérant que la commande réussira sur le nœud principal et échouera sur les nœuds secondaires.

**Note**  
Pour automatiser les sauvegardes, vous pouvez créer une tâche de fenêtre de AWS Systems Manager maintenance qui utilise le `AWSEC2-VssInstallAndSnapshot` document. Pour plus d’informations, consultez [Utilisation des fenêtres de maintenance (console)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-working.html) dans le *Guide de l’utilisateur AWS Systems Manager *.

# Résoudre les problèmes liés aux instantanés EBS basés sur Windows VSS
<a name="application-consistent-snapshots-troubleshooting"></a>

Avant d’essayer d’autres étapes de résolution des problèmes, nous vous recommandons de vérifier les informations suivantes.
+ Assurez-vous d’avoir respecté toutes les [Conditions préalables à la création d’instantanés EBS basés sur Windows VSS](application-consistent-snapshots-prereqs.md).
+ Vérifiez que vous utilisez la dernière version de [Prise en charge de la version du système d’exploitation Windows](vss-comps-history.md#windows-version-support) du package `AwsVssComponents` correspondant à votre système d’exploitation. Le problème que vous avez observé a peut-être été résolu dans les versions plus récentes.

**Topics**
+ [Vérifier les fichiers journaux](#general-log-files)
+ [Collecter des journaux de diagnostic supplémentaires](#vss-ts-collect-diagnostic-logs)
+ [Utiliser VSS sur les instances avec un proxy configuré](#general-using-vss-with-proxy)
+ [Erreur : « thaw pipe connection timed out », « error on thaw », « timeout waiting for VSS Freeze » ou autres erreurs de délai d’attente](#error-thaw)
+ [Erreur : impossible d’invoquer la méthode. L’invocation de méthodes n’est prise en charge que sur les types principaux dans ce mode de langue.](#error-invoke)

## Vérifier les fichiers journaux
<a name="general-log-files"></a>

Si vous rencontrez des problèmes ou recevez des messages d’erreur lorsque vous créez des instantanés EBS basés sur VSS, vous pouvez afficher la sortie de la commande dans la console du gestionnaire de systèmes.

Pour les documents du gestionnaire de systèmes qui créent des instantanés VSS, vous pouvez définir le paramètre `CollectDiagnosticLogs` sur « `True` » au moment de l’exécution. Lorsque le paramètre `CollectDiagnosticLogs` est défini sur « `True` », VSS collecte des journaux supplémentaires pour faciliter le débogage. Pour de plus amples informations, veuillez consulter [Collecter des journaux de diagnostic supplémentaires](#vss-ts-collect-diagnostic-logs).

Si vous collectez des journaux de diagnostic, le document du gestionnaire de systèmes les stocke sur votre instance à l’emplacement suivant : `C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip`. La valeur par défaut du paramètre `CollectDiagnosticLogs` est « `False` ».

**Note**  
Pour obtenir de l'aide supplémentaire pour le débogage, vous pouvez envoyer le `.zip` fichier à Support.

Les journaux supplémentaires suivants sont disponibles, que vous collectiez ou non des journaux de diagnostic :
+ `%ProgramData%\Amazon\SSM\InstanceData\InstanceID\document\orchestration\SSMCommandID\awsrunPowerShellScript\runPowerShellScript\stdout`
+ `%ProgramData%\Amazon\SSM\InstanceData\InstanceID\document\orchestration\SSMCommandID\awsrunPowerShellScript\runPowerShellScript\stderr`

Vous pouvez également ouvrir l’application Observateur d’événements de Windows et sélectionner **Journaux Windows**, **Application** pour afficher les journaux supplémentaires. Pour afficher les événements spécifiquement du fournisseur VSS Windows EC2 et du Service de cliché instantané des volumes, filtrez par **source** avec les termes **Ec2VssSoftwareProvider** et **VSS**.

**Si vous utilisez Systems Manager avec des points de terminaison VPC et que l'action de l'API d'[envoi de commande de Systems Manager (**Exécuter la commande**](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html) dans la console) a échoué, vérifiez que vous avez correctement configuré le point de terminaison suivant : com.amazonaws. *region*.ec2.** 

Si le point de terminaison Amazon EC2 n’est pas défini, l’appel à l’énumération des volumes EBS associés échoue, ce qui entraîne l’échec de la commande du gestionnaire de systèmes. Pour plus d’informations sur la configuration de points de terminaison d’un VPC avec Systems Manager, consultez [Create a Virtual Private Cloud Endpoint](https://docs.aws.amazon.com/systems-manager/latest/userguide/setup-create-vpc.html) (Créer un point de terminaison VPC) dans le *Guide de l’utilisateur AWS Systems Manager *.

## Collecter des journaux de diagnostic supplémentaires
<a name="vss-ts-collect-diagnostic-logs"></a>

Pour collecter des journaux de diagnostic supplémentaires lorsque vous utilisez la commande d’envoi du gestionnaire de systèmes afin d’exécuter le document d’instantané VSS, définissez le paramètre d’entrée `CollectDiagnosticLogs` sur « `True` » au moment de l’exécution. Nous vous recommandons de régler ce paramètre sur « `True` » lors de la résolution des problèmes.

Pour obtenir un exemple de ligne de commande, sélectionnez l’un des onglets suivants.

------
#### [ AWS CLI ]

L’exemple suivant exécute le document du gestionnaire de systèmes `AWSEC2-CreateVssSnapshot` dans l’ AWS CLI :

```
aws ssm send-command \ 
    --document-name "AWSEC2-CreateVssSnapshot" \
    --instance-ids "i-1234567890abcdef0" \
    --parameters '{"description":["Example - create diagnostic logs at runtime."],"tags":["Key=tag_name,Value=tag_value"],"CollectDiagnosticLogs":["True"]}'
```

------
#### [ PowerShell ]

L'exemple suivant exécute le document `AWSEC2-CreateVssSnapshot` Systems Manager dans PowerShell :

```
Send-SSMCommand `
    -DocumentName "AWSEC2-CreateVssSnapshot" `
    -InstanceId "i-1234567890abcdef0" `
    -Parameter @{'description'='Example - create diagnostic logs at runtime.';'tags'='Key=tag_name,Value=tag_value';'CollectDiagnosticLogs'='True'}
```

------

## Utiliser VSS sur les instances avec un proxy configuré
<a name="general-using-vss-with-proxy"></a>

Si vous rencontrez des problèmes lors de la création d’instantanés EBS basés sur VSS concernant des instances qui utilisent un proxy afin d’atteindre les points de terminaison EC2, vérifiez les paramètres suivants sur votre instance :
+ Vérifiez que le proxy est configuré de telle sorte que les points de terminaison du service EC2 de la région et de l'IMDS de l'instance soient accessibles en AWS Tools for Windows PowerShell exécutant le code SYSTEM.
+ Pour pouvoir utiliser le proxy WinHTTP configuré par le système, assurez-vous que vous avez installé la dernière version de `AwsVssComponents` sur votre instance. Pour plus d’informations sur la configuration du proxy WinHTTP, consultez la section [Commandes Netsh pour Windows Hypertext Transfer Protocol (WINHTTP)](https://learn.microsoft.com/en-us/previous-versions/windows/it-pro/windows-server-2008-r2-and-2008/cc731131(v=ws.10)) (français non garanti) sur le site web de Microsoft.

## Erreur : « thaw pipe connection timed out », « error on thaw », « timeout waiting for VSS Freeze » ou autres erreurs de délai d’attente
<a name="error-thaw"></a>

Le fournisseur EC2 Windows VSS peut perdre du temps en raison d’une activité ou de services sur l’instance qui empêchent les instantanés basés sur VSS de se dérouler en temps voulu. Le framework VSS Windows fournit une fenêtre de 10 secondes non configurable pendant laquelle la communication avec le système de fichiers est suspendue. Pendant ce temps, `AWSEC2-CreateVssSnapshot` crée des instantanés de vos volumes.

Les problèmes suivants peuvent amener le fournisseur VSS Windows EC2 à rencontrer des limites de temps au cours d’un instantané :
+ Excessif par I/O rapport à un volume
+ Réactivité lente de l’API EC2 sur l’instance
+ Volumes fragmentés
+ Incompatibilité avec certains logiciels antivirus
+ Problèmes avec un enregistreur d’application VSS
+ Lorsque la journalisation des modules est activée pour un grand nombre de PowerShell modules, cela peut entraîner un ralentissement de l'exécution PowerShell des scripts

La plupart des délais d’expiration qui se produisent lorsque vous exécutez le document de commande `AWSEC2-CreateVssSnapshot` sont liés au fait que la charge de travail sur l’instance est trop élevée au moment de la sauvegarde. Pour vous aider à créer un instantané avec succès, vous pouvez procéder comme suit :
+ Réessayez la commande `AWSEC2-CreateVssSnapshot` pour voir si la tentative d’instantané réussit. Si une nouvelle tentative réussit dans certains cas, la réduction de la charge de l’instance peut favoriser la réussite des instantanés.
+ Patientez le temps que la charge globale sur l’instance diminue, puis réessayez la commande `AWSEC2-CreateVssSnapshot`. Vous pouvez également essayer des instantanés lorsque vous savez que l’instance est soumise à une faible contrainte.
+ Essayez des instantanés VSS lorsque le logiciel antivirus sur le système est désactivé. Si cela résout le problème, reportez-vous aux instructions du logiciel antivirus et configurez celui-ci afin qu’il autorise les instantanés VSS.
+ S’il y a un volume élevé d’appels d’API Amazon EC2 dans votre compte au sein de la même région où vous exécutez un instantané, la limitation de l’API peut retarder les opérations de l’instantané. Pour réduire l’impact de la limitation, utilisez le package `AwsVssComponents` le plus récent. Ce package utilise l’action `CreateSnapshots` de l’API EC2 pour réduire le nombre d’actions de mutation telles que la création et le balisage d’instantanés par volume.
+ Si plusieurs scripts de commande `AWSEC2-CreateVssSnapshot` s’exécutent en même temps, vous pouvez suivre les étapes suivantes pour réduire les problèmes de simultanéité.
  + Envisagez de planifier des instantanés pendant les périodes de faible activité des API.
  + Si vous exécutez le script de commande **Run Command** dans la console Systems Manager (ou **SendCommand** dans l’API), vous pouvez utiliser les contrôles de débit de Systems Manager pour réduire la simultanéité.

    Vous pouvez également utiliser les contrôles de débit de Systems Manager pour réduire la simultanéité des services tels AWS Backup que ceux qui utilisent Systems Manager pour exécuter le script de commande.
+ Exécutez la commande `vssadmin list writers` dans un shell et voyez si celle-ci signale des erreurs dans le champ **Last error** pour tous les enregistreurs sur le système. Si des enregistreurs signalent une erreur **time out**, vous pouvez éventuellement réessayer de créer des instantanés lorsque l’instance sera moins chargée.
+ Lorsque vous utilisez des types d'instances plus petits tels que *t2 \$1 t3 \$1 t3a* .nano ou *t2 \$1 t3 \$1 t3a* .micro, des délais d'attente peuvent survenir en raison de contraintes liées à la mémoire et au processeur. Les actions suivantes peuvent contribuer à réduire les problèmes de délai d’expiration.
  + Essayez de fermer les applications utilisant la mémoire ou le processeur de manière intensive avant de prendre des instantanés.
  + Essayez de prendre des instantanés pendant les périodes de faible activité de l’instance.

## Erreur : impossible d’invoquer la méthode. L’invocation de méthodes n’est prise en charge que sur les types principaux dans ce mode de langue.
<a name="error-invoke"></a>

Vous rencontrerez cette erreur lorsque le mode de PowerShell langue n'est pas défini sur`FullLanguage`. Le document `AWSEC2-CreateVssSnapshot` SSM doit PowerShell être configuré en `FullLanguage` mode.

Pour vérifier le mode de langue, exécutez la commande suivante sur l'instance dans une PowerShell console :

```
$ExecutionContext.SessionState.LanguageMode
```

Pour plus d’informations sur les modes de langue, veuillez consulter la rubrique [about\$1Language\$1Modes](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_language_modes) dans la documentation Microsoft.

# Utilisez la solution AWS VSS pour restaurer les données de votre instance
<a name="application-consistent-snapshots-restore"></a>

Vous pouvez restaurer des volumes EBS pour une instance Windows à partir de snapshots basés sur VSS créés par la AWS solution VSS. Si les instantanés de votre solution AWS VSS contiennent des sauvegardes d'une base de données Microsoft SQL Server, vous pouvez restaurer la base de données à l'aide du runbook `AWSEC2-RestoreSqlServerDatabaseWithVss` AWS Systems Manager Automation.

Le dossier d’exploitation de restauration de base de données automatise l’ensemble du processus de restauration, y compris la création de volumes à partir des instantanés et leur attachement à l’instance. L’automatisation utilise la technologie VSS pour restaurer la base de données, ce qui vous permet de la restaurer sans arrêter votre application SQL Server ni déconnecter les connexions actives.

Pour obtenir des instructions détaillées sur l’utilisation du dossier d’exploitation de base de données Microsoft SQL Server, consultez la section [Restaurer à partir de snapshots basés sur VSS](https://docs.aws.amazon.com/sql-server-ec2/latest/userguide/ms-ssdb-ec2-restore-vss.html) dans le *Guide de l’utilisateur Microsoft SQL Server sur Amazon EC2*.

## Personnalisez un script pour restaurer des volumes EBS à partir de snapshots de AWS solution VSS
<a name="vss-restore-script"></a>

Vous pouvez utiliser le `RestoreVssSnapshotSampleScript.ps1` script comme modèle pour créer votre propre script personnalisé qui restaure les volumes EBS à partir des instantanés de solution AWS VSS. Le script exemple effectue les tâches suivantes :
+ Arrête une instance
+ Supprime tous les disques existants de l’instance (à l’exception du volume de démarrage, s’il a été exclu)
+ Crée de nouveaux volumes à partir des instantanés
+ Attache les volumes à l’instance en utilisant la balise d’ID de périphérique sur l’instantané
+ Redémarre l’instance

**Important**  
Le script suivant détache tous les volumes attachés à une instance, puis crée de nouveaux volumes à partir d’un instantané. Vérifiez que vous avez correctement sauvegardé l’instance. Les anciens volumes ne sont pas supprimés. Si vous le souhaitez, vous pouvez modifier le script afin de supprimer les anciens volumes.

**Pour restaurer des volumes à partir d’instantanés EBS basés sur VSS**

1. Téléchargez le fichier [RestoreVssSnapshotSampleScript.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/RestoreVssSnapshotSampleScript.zip) et extrayez le contenu du fichier.

1. Ouvrez `RestoreVssSnapshotSampleScript.ps1` dans un éditeur de texte et modifiez l'exemple d'appel au bas du script avec un ID d'instance EC2 et un ID de snapshot EBS valides, puis exécutez le script depuis. PowerShell

# AWS Historique des versions de la solution VSS
<a name="vss-comps-history"></a>

Cette page inclut les notes de mise à jour par version pour le package de composants AWS VSS, ainsi que les exigences relatives aux composants et aux versions de script pour chaque version prise en charge de Windows Server.

**Topics**
+ [AwsVssComponents versions du package](#AwsVssComponents-history)
+ [Prise en charge de la version du système d’exploitation Windows](#windows-version-support)

## AwsVssComponents versions du package
<a name="AwsVssComponents-history"></a>

Le tableau suivant décrit les versions publiées du package de composants AWS VSS.


| Version | Détails | Date de publication | Téléchargeable | 
| --- | --- | --- | --- | 
| 2.5.1 |  Correction d’un problème pouvant entraîner l’échec de la restauration d’une base de données SQL lorsque le paramètre de la base de données cible est spécifié.  | 13 mars 2025 | Oui | 
| 2.5.0 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/vss-comps-history.html)  | 17 janvier 2025 | Oui | 
| 2.4.0 |  Ajout de la possibilité d’enregistrer les fichiers de métadonnées VSS lors de la création d’un instantané. Pour activer cette fonctionnalité, reportez-vous SaveVssMetadata à[Paramètres des documents d’instantanés VSS Systems Manager](create-vss-snapshots-ssm.md#create-vss-snapshots-ssm-params).  | 7 octobre 2024 | Oui | 
| 2.3.3 |  Mise à jour de l’agent VSS pour s’assurer que le `Ec2VssProvider` est utilisé lors de la création d’un instantané.  | 25 juin 2024 | Oui | 
| 2.3.2 |  Correction d’un cas où l’enregistrement du fournisseur VSS n’est pas supprimé lors de la désinstallation.  | 9 mai 2024 | Oui | 
| 2.3.1 |  Ajout d'une nouvelle balise par défaut `AwsVssConfig` pour identifier les instantanés et AMIs créée par AWS VSS.  | 07 mars 2024 | Oui | 
| 2.2.1 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/vss-comps-history.html)  | 18 janvier 2024 | Oui | 
| 2.1.0 |  Ajout d’une aide pour l’utilisation de l’API `CreateSnapshots`.  | 6 novembre 2023 | Oui | 
| 2.0.1 |  Ajout de la prise en charge de l’utilisation des paramètres du proxy WinHTTP.  | 26 octobre 2023 | Non | 
| 2.0.0 |  Ajout d'une fonctionnalité au composant AWS VSS pour créer des instantanés AMIs, ce qui permet la compatibilité avec les fonctionnalités de journalisation des PowerShell modules, de journalisation par blocs de scripts et de transcription.  | 28 avril 2023 | Non | 
| 1.3.2.0 |  Correction d’un cas où l’échec de l’installation n’était pas signalé correctement.  | 10 mai 2022 | Non | 
| 1.3.1.0 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/vss-comps-history.html)  | 6 février 2020 | Oui | 
| 1.3.00 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/vss-comps-history.html)  | 19 mars 2019 | Non | 
| 1.2.00 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/vss-comps-history.html)  | 15 novembre 2018 | Non | 
| 1.1 | Correction de composants AWS VSS qui n'étaient pas utilisés correctement en tant que fournisseur de sauvegarde et de restauration Windows par défaut. | 12 décembre 2017 | Non | 
| 1.0 | Première version.  | le 20 novembre 2017 | Non | 

## Prise en charge de la version du système d’exploitation Windows
<a name="windows-version-support"></a>

Le tableau suivant indique les versions de solution AWS VSS que vous devez exécuter sur chaque version de Windows Server sur Amazon EC2.


| Version Windows Server | AwsVssComponents version | AWSEC2- nom de VssInstallAndSnapshot version | AWSEC2- nom de CreateVssSnapshot version | 
| --- | --- | --- | --- | 
| Windows Server 2025 | default | default | default | 
| Windows Server 2022 | default | default | default | 
| Windows Server 2019 | default | default | default | 
| Windows Server 2016 | default | default | default | 
| Windows Server 2012 R2 | 2.1.0 | non pris en charge | 2012R2 | 
| Windows Server 2012 | 2.1.0 | non pris en charge | 2012R2 | 
| Windows Server 2008 R2 | 1.3.1.0 | non pris en charge | 2008R2 | 