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. # Utilisez des documents de commande de Systems Manager pour créer des instantanés basés pour VSS 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 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 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é) 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 - 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é 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 *.