Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Crea snapshot EBS basati su VSS per l'istanza EC2 Windows
Dopo aver soddisfatto tutti i [Prerequisiti per creare snapshot EBS basati su Windows VSS](application-consistent-snapshots-prereqs.md), puoi utilizzare uno dei seguenti metodi per creare snapshot basati su VSS dall'istanza EC2.
**AWS Systems Manager documenti di comando**
[Utilizzare i documenti di comando di Systems Manager](create-vss-snapshots-ssm.md) per creare snapshot basati su VSS.
Per automatizzare i backup, è possibile creare un'attività della finestra AWS Systems Manager di manutenzione che utilizzi il documento di `AWSEC2-VssInstallAndSnapshot` comando. Per ulteriori informazioni, consulta [Utilizzo delle finestre di manutenzione (console)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-working.html) nella *Guida per l'utente di AWS Systems Manager *.
**AWS Backup**
È possibile creare un backup VSS quando si utilizza AWS Backup abilitando VSS nella console o nella CLI. Per ulteriori informazioni, consulta la pagina [Creating Windows VSS backups](https://docs.aws.amazon.com/aws-backup/latest/devguide/windows-backups.html) della *Guida per gli sviluppatori di AWS Backup *.
AWS Backup non installa automaticamente il `AwsVssComponents` pacchetto sulla tua istanza. È necessario eseguire un'installazione manuale sull'istanza. Per ulteriori informazioni, consulta [Installazione manuale dei componenti VSS su un'istanza di Windows EC2](application-consistent-snapshots-getting-started.md#install-vss-comps).
**Amazon Data Lifecycle Manager**
Puoi creare snapshot VSS utilizzando Amazon Data Lifecycle Manager abilitando gli script pre e post nelle policy del ciclo di vita degli snapshot. Per ulteriori informazioni, consulta [Automazione degli snapshot coerenti a livello di applicazione](https://docs.aws.amazon.com/ebs/latest/userguide/automate-app-consistent-backups.html) nella *Guida per l'utente Amazon EBS*.
Il Sistema di gestione del ciclo di vita dei dati Amazon non installa automaticamente il pacchetto `AwsVssComponents` sull'istanza. È necessario eseguire un'installazione manuale sull'istanza. Per ulteriori informazioni, consulta [Installazione manuale dei componenti VSS su un'istanza di Windows EC2](application-consistent-snapshots-getting-started.md#install-vss-comps).
# Usa i documenti di comando di Systems Manager per creare snapshot basati su VSS
È possibile utilizzare i documenti di AWS Systems Manager comando per creare istantanee basate su VSS. Il seguente contenuto introduce i documenti di comando disponibili e i parametri di runtime utilizzati dai documenti per creare gli snapshot.
Prima di utilizzare uno dei documenti di comando di Systems Manager, assicurati di aver soddisfatto tutti i [Prerequisiti per creare snapshot EBS basati su Windows VSS](application-consistent-snapshots-prereqs.md).
**Topics**
+ [Parametri per i documenti Systems Manager per snapshot VSS](#create-vss-snapshots-ssm-params)
+ [Esecuzione dei documenti di comando Systems Manager per snapshot VSS](#create-vss-snapshots-ssm-methods)
## Parametri per i documenti Systems Manager per snapshot VSS
I documenti Systems Manager che creano snapshot VSS utilizzano tutti i seguenti parametri, eccetto dove segnalato:
**AmiName**(stringa, opzionale)
Se l'**CreateAmi**opzione è impostata su`True`, specifica il nome dell'AMI creato dal backup.
**description** (stringa, facoltativo)
Specifica una descrizione per gli snapshot o l'immagine creata da questo processo.
**CollectDiagnosticLogs**(stringa, opzionale)
Per raccogliere ulteriori informazioni durante le fasi di creazione di snapshot e AMI, imposta questo parametro su "`True`". Il valore predefinito per questo parametro è "`False`". I log di diagnostica consolidati vengono salvati come formato archivio `.zip` nella seguente posizione sull'istanza:
`C:\ProgramData\Amazon\AwsVss\Logs\timestamp.zip`
**CopyOnly**(stringa, opzionale)
Se si utilizza il backup nativo di SQL Server oltre a AWS VSS, l'esecuzione di un backup di sola copia impedisce a AWS VSS di interrompere la catena di backup differenziale nativa. Per eseguire un'operazione di backup di sola copia, imposta questo parametro su `True`.
Il valore predefinito per questo parametro è`False`, che fa sì che AWS VSS esegua un'operazione di backup completa.
**CreateAmi**(stringa, opzionale)
Per creare un'Amazon Machine Image (AMI) basata su VSS per il backup dell'istanza, imposta questo parametro su `True`. Il valore predefinito per questo parametro è `False`, che esegue invece il backup dell'istanza con uno snapshot EBS.
Per ulteriori informazioni sulla creazione di un'AMI da un'istanza, consulta la pagina [Creare un'AMI supportata da Amazon EBS](creating-an-ami-ebs.md).
**executionTimeout** (stringa, facoltativo)
Specifica il tempo massimo in secondi per eseguire il processo di creazione degli snapshot sull'istanza o per creare un'AMI dall'istanza. L'aumento di questo timeout consente al comando di attendere più a lungo l'avvio del blocco da parte di VSS e di completare il tagging delle risorse create. Questo timeout si applica solo alle fasi di creazione degli snapshot o dell'AMI. Il passaggio iniziale per installare o aggiornare il pacchetto `AwsVssComponents` non è incluso nel timeout.
**ExcludeBootVolume**(stringa, opzionale)
Questa impostazione esclude i volumi di avvio dal processo di backup se si creano snapshot. Per escludere i volumi di avvio dalle istantanee, imposta **ExcludeBootVolume**su `True` e **CreateAmi**su`False`.
Se si crea un'AMI per il backup, questo parametro deve essere impostato su `False`. Il valore predefinito per questo parametro è `False`.
**NoWriters**(stringa, opzionale)
Per escludere i writer VSS dell'applicazione dal processo di snapshot, imposta questo parametro su`True`. L'esclusione dei writer VSS dell'applicazione può aiutarti a risolvere i conflitti con componenti di backup VSS di terze parti. Il valore predefinito per questo parametro è `False`.
Se `SaveVssMetadata` è `True`, questo parametro deve essere impostato su `False`.
**SaveVssMetadata**(stringa, opzionale)
Per salvare i file di metadati VSS durante ogni snapshot, imposta questo parametro su `True`. Il valore predefinito è `False`. Questi file aiutano a fornire informazioni dettagliate su quali componenti o scrittori sono stati inclusi in un'operazione di backup e sui file e i volumi associati per ogni istantanea. I file di metadati vengono utilizzati per il ripristino di un database SQL utilizzando la soluzione di ripristino VSS. Per ulteriori informazioni su come ripristinare un database SQL dalle istantanee VSS, consulta [Utilizzare un runbook di automazione per ripristinare il](https://docs.aws.amazon.com/sql-server-ec2/latest/userguide/ms-ssdb-ec2-restore-vss.html) database dagli snapshot della soluzione VSS. AWS
I file di metadati hanno l'ID del set di snapshot associato nei loro nomi. Puoi trovarli nella seguente posizione sull'istanza:
```
C:\ProgramData\Amazon\AwsVss\VssMetadata\
```
+ Il salvataggio dei file di metadati VSS richiede `AwsVssComponents` la versione del pacchetto 2.4.0 o successive. Se nell'istanza è installata una versione precedente, l'impostazione di `SaveVssMetadata` su `True`compromette la creazione dello snapshot.
+ I parametri `NoWriters` e `SaveVssMetadata` si escludono a vicenda. Se entrambi sono impostati su `True`, la creazione dello snapshot non va a buon fine.
**tags** (stringa, facoltativo)
Si consiglia di assegnare tag agli snapshot e alle immagini per facilitare l'individuazione e la gestione delle risorse, ad esempio per ripristinare i volumi da un elenco di snapshot. Il sistema aggiunge la chiave `Name`, con un valore vuoto in cui è possibile specificare il nome che si desidera applicare agli snapshot o alle immagini di output.
Ulteriori tag possono essere elencati separandoli con un punto e virgola. Ad esempio, `Key=Environment,Value=Test;Key=User,Value=TestUser1`.
Le chiavi e i valori dei tag devono contenere solo caratteri alfanumerici e i caratteri speciali: `() ./\-"'@_+:={}`.
Per impostazione predefinita, il sistema aggiunge i seguenti tag riservati per snapshot e immagini basate su VSS.
+ **Dispositivo**: per snapshot basati su VSS, questo è il nome del dispositivo del volume EBS acquisito dallo snapshot.
+ **AppConsistent**— Questo tag indica la corretta creazione di un'istantanea o di un AMI basato su VSS.
+ **AwsVssConfig**— Identifica le istantanee create con AMIs VSS abilitato. Il tag include meta informazioni come la versione `AwsVssComponents` e l'ID del set di snapshot nei loro nomi.
Specificare uno di questi tag riservati nell'elenco dei parametri causerà un errore.
**VssVersion**(stringa, opzionale)
Solo per il documento `AWSEC2-VssInstallAndSnapshot`, puoi specificare il parametro `VssVersion` per installare una versione specifica del pacchetto `AwsVssComponents` sull'istanza. Lascia vuoto questo parametro per installare la versione predefinita consigliata.
Se la versione specificata del pacchetto `AwsVssComponents` è già installata, lo script salta la fase di installazione e passa alla fase di backup. Per un elenco delle versioni del pacchetto `AwsVssComponents` e del supporto operativo, consulta [AWS Cronologia delle versioni della soluzione VSS](vss-comps-history.md).
## Esecuzione dei documenti di comando Systems Manager per snapshot VSS
È possibile creare istantanee EBS basate su VSS con documenti di AWS Systems Manager comando come segue.
### Esegui il documento di VssInstallAndSnapshot comando AWSEC2 - (consigliato)
Quando si utilizza AWS Systems Manager per eseguire il `AWSEC2-VssInstallAndSnapshot` documento, lo script esegue i seguenti passaggi.
1. Lo script installa o aggiorna innanzitutto il pacchetto `AwsVssComponents` sull'istanza, a seconda che sia già installato.
1. Lo script crea snapshot coerenti con l'applicazione dopo il completamento del primo passaggio.
Per eseguire il documento `AWSEC2-VssInstallAndSnapshot`, segui i passaggi relativi al tuo ambiente preferito.
------
#### [ Console ]
**Creazione di snapshot EBS basatu su VSS dalla console**
1. Aprire la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel riquadro di navigazione, seleziona **Esegui comando**. Questo mostra un elenco di comandi correntemente in esecuzione nel tuo account, se applicabile.
1. Seleziona **Esegui comando**. Si apre un elenco di documenti di comando a cui si ha accesso.
1. Seleziona `AWSEC2-VssInstallAndSnapshot` dall'elenco dei documenti di comando. Per semplificare i risultati, puoi inserire tutto o parte del nome del documento. Puoi anche filtrare per proprietario, per tipo di piattaforma o per tag.
Quando si seleziona un documento di comando, i dettagli vengono inseriti sotto l'elenco.
1. Seleziona `Default version at runtime` dall'elenco delle **versioni del documento**.
1. Configura i **parametri del comando** per definire come `AWSEC2-VssInstallAndSnapshot` installerà il pacchetto `AwsVssComponents` ed eseguire il backup con snapshot VSS o un'AMI. Per i dettagli dei parametri, consulta [Parametri per i documenti Systems Manager per snapshot VSS](#create-vss-snapshots-ssm-params).
1. In **Selezione della destinazione**, specifica i tag o seleziona manualmente le istanze per identificare le istanze su cui eseguire questa operazione.
**Nota**
Se selezioni manualmente le istanze e l'istanza prevista non è inclusa nell'elenco, consulta [Dove sono le mie istanze?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) per suggerimenti sulla risoluzione dei problemi.
1. Per i parametri aggiuntivi per la definizione del comportamento dei comandi di esecuzione di Systems Manager, ad esempio il **controllo della velocità**, immetti i valori come descritto in [Esecuzione di comandi dalla console](https://docs.aws.amazon.com/systems-manager/latest/userguide/running-commands-console.html).
1. Selezionare **Run (Esegui)**.
In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco delle snapshot EBS cercando i tag specificati o `AppConsistent`. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando di Systems Manager. Nel caso in cui l'esecuzione del comando risulti completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco dei volumi EBS.
------
#### [ AWS CLI ]
È possibile eseguire i seguenti comandi in AWS CLI per creare istantanee EBS basate su VSS e visualizzare lo stato della creazione delle istantanee.
**Creazione di snapshot basati su VSS**
Esegui il comando seguente per creare snapshot EBS basati su VSS. Per creare gli snapshot, devi identificare le istanze con il parametro `--instance-ids`. Per ulteriori informazioni sugli altri parametri che è possibile utilizzare, consulta [Parametri per i documenti Systems Manager per snapshot VSS](#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":[""]}'
```
In caso di esito positivo, il documento di comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco delle snapshot EBS cercando i tag specificati o `AppConsistent`. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando.
**Ottenere lo stato del comando**
Per ottenere lo stato corrente degli snapshot, esegui il comando riportato utilizzando l'ID del comando restituito da **send-command**.
```
aws ssm get-command-invocation
--instance-ids "i-01234567890abcdef" \
--command-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
--plugin-name "CreateVssSnapshot"
```
------
#### [ PowerShell ]
Esegui i seguenti comandi con AWS Tools for Windows PowerShell per creare istantanee EBS basate su VSS e ottenere lo stato di runtime corrente per la creazione dell'output. Specifica i parametri descritti nell'elenco precedente per modificare il comportamento del processo di snapshot.
**Crea istantanee EBS basate su VSS con Tools for Windows PowerShell**
Esegui il seguente comando per creare istantanee EBS basate su VSS o. AMIs
```
Send-SSMCommand -DocumentName "AWSEC2-VssInstallAndSnapshot" -InstanceId "i-01234567890abcdef" -Parameter @{'ExcludeBootVolume'='False';'description'='a_description'
;'tags'='Key=key_name,Value=tag_value';'VssVersion'=''}
```
**Ottenere lo stato del comando**
Per ottenere lo stato corrente degli snapshot, esegui il comando riportato utilizzando l'ID del comando restituito da **Send-SSMCommand**.
```
Get-SSMCommandInvocationDetail -InstanceId "i-01234567890abcdef" -CommandId "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" -PluginName "CreateVssSnapshot"
```
In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco delle snapshot EBS cercando i tag specificati o `AppConsistent`. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando.
------
### Esegui il documento di AWSEC2 comando - CreateVssSnapshot
Per eseguire il documento `AWSEC2-CreateVssSnapshot`, segui i passaggi relativi al tuo ambiente preferito.
------
#### [ Console ]
**Creazione di snapshot EBS basatu su VSS dalla console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel riquadro di navigazione, seleziona **Esegui comando**. Questo mostra un elenco di comandi correntemente in esecuzione nel tuo account, se applicabile.
1. Seleziona **Esegui comando**. Si apre un elenco di documenti di comando a cui si ha accesso.
1. Seleziona `AWSEC2-CreateVssSnapshot` dall'elenco dei documenti di comando. Per semplificare i risultati, puoi inserire tutto o parte del nome del documento. Puoi anche filtrare per proprietario, per tipo di piattaforma o per tag.
Quando si seleziona un documento di comando, i dettagli vengono inseriti sotto l'elenco.
1. Seleziona `Default version at runtime` dall'elenco delle **versioni del documento**.
1. Configura i **parametri del comando** per definire come `AWSEC2-CreateVssSnapshot` eseguirà il backup con snapshot VSS o un'AMI. Per i dettagli dei parametri, consulta [Parametri per i documenti Systems Manager per snapshot VSS](#create-vss-snapshots-ssm-params).
1. In **Selezione della destinazione**, specifica i tag o seleziona manualmente le istanze per identificare le istanze su cui eseguire questa operazione.
**Nota**
Se selezioni manualmente le istanze e l'istanza prevista non è inclusa nell'elenco, consulta [Dove sono le mie istanze?](https://docs.aws.amazon.com/systems-manager/latest/userguide/troubleshooting-remote-commands.html#where-are-instances) per suggerimenti sulla risoluzione dei problemi.
1. Per i parametri aggiuntivi per la definizione del comportamento dei comandi di esecuzione di Systems Manager, ad esempio il **controllo della velocità**, immetti i valori come descritto in [Esecuzione di comandi dalla console](https://docs.aws.amazon.com/systems-manager/latest/userguide/running-commands-console.html).
1. Selezionare **Run (Esegui)**.
In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco delle snapshot EBS cercando i tag specificati o `AppConsistent`. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando di Systems Manager. Nel caso in cui l'esecuzione del comando risulti completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco dei volumi EBS.
------
#### [ AWS CLI ]
È possibile eseguire il seguente comando in AWS CLI per creare istantanee EBS basate su VSS.
**Creazione di snapshot basati su VSS**
Esegui il comando seguente per creare snapshot EBS basati su VSS. Per creare gli snapshot, devi identificare le istanze con il parametro `--instance-ids`. Per ulteriori informazioni sugli altri parametri che è possibile utilizzare, consulta [Parametri per i documenti Systems Manager per snapshot VSS](#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"]}'
```
In caso di esito positivo, il documento di comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco delle snapshot EBS cercando i tag specificati o `AppConsistent`. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando.
------
#### [ PowerShell ]
Esegui il comando seguente con AWS Tools for Windows PowerShell per creare istantanee EBS basate su VSS.
**Crea istantanee EBS basate su VSS con Tools for Windows PowerShell**
Esegui il comando seguente per creare snapshot EBS basati su VSS. Per creare gli snapshot, devi identificare le istanze con il parametro `InstanceId`. È possibile specificare più di un'istanza per cui creare snapshot. Per ulteriori informazioni sugli altri parametri che è possibile utilizzare, consulta [Parametri per i documenti Systems Manager per snapshot VSS](#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'}
```
In caso di esito positivo, il comando compila l'elenco degli snapshot EBS con i nuovi snapshot. È possibile trovare questi snapshot nell'elenco delle snapshot EBS cercando i tag specificati o `AppConsistent`. I motivi dettagliati di un eventuale errore nell'esecuzione del comando sono disponibili nell'output del comando. Nel caso in cui l'esecuzione del comando risulti completata con successo, ma non sia riuscito il backup di un determinato volume, è possibile risolvere il problema dall'elenco degli snapshot EBS.
------
### Esecuzione dei documenti di comando per un cluster di failover Windows con archiviazione EBS condivisa
È possibile utilizzare una qualsiasi delle procedure della linea di comando descritte nella sezione precedente per creare uno snapshot basato su VSS. Il documento del comando (`AWSEC2-VssInstallAndSnapshot` o `AWSEC2-CreateVssSnapshot`) deve essere eseguito sul nodo primario del cluster. Il documento avrà esito negativo sui nodi secondari in quanto non hanno accesso ai dischi condivisi. Se il primario e il secondario cambiano dinamicamente, puoi AWS Systems Manager eseguire il documento Run Command su più nodi con l'aspettativa che il comando abbia esito positivo sul nodo primario e abbia esito negativo sui nodi secondari.
**Nota**
Per automatizzare i backup, è possibile creare un'operazione della finestra di AWS Systems Manager manutenzione che utilizzi il documento. `AWSEC2-VssInstallAndSnapshot` Per ulteriori informazioni, consulta [Utilizzo delle finestre di manutenzione (console)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-maintenance-working.html) nella *Guida per l'utente di AWS Systems Manager *.