

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à.

# `AWSSupport-RunEC2RescueForWindowsTool`
<a name="automation-awssupport-runec2rescueforwindowstool"></a>

 **Descrizione** 

Il RescueForWindowsTool runbook **AWSSupport-RunEC2** esegue lo strumento di risoluzione dei problemi di Amazon EC2 Rescue for Windows Server sull'istanza gestita Windows di destinazione di Amazon Elastic Compute Cloud (Amazon EC2) per aiutare a risolvere i problemi più comuni. Questo runbook supporta tre azioni principali:
+ **ResetAccess**: Reimposta la password dell'amministratore locale. La password viene generata in modo casuale e archiviata in modo sicuro in Parameter Store as. AWS Systems Manager `/EC2Rescue/Password/<instance_id>` Se non fornite alcun parametro, la password viene crittografata con la chiave default AWS Key Management Service ()AWS KMS. `alias/aws/ssm` Facoltativamente, è possibile specificare un ID AWS KMS chiave per crittografare la password con la propria chiave.
+ **CollectLogs**: raccoglie log e file di configurazione dal sistema operativo e li carica in un bucket Amazon Simple Storage Service (Amazon S3) nel tuo account eseguendo Amazon EC2 Rescue con l'opzione. `/collect:all`
+ **FixAll**: tenta di rilevare e risolvere problemi su un volume root Windows offline collegato all'istanza corrente eseguendo Amazon EC2 Rescue con l'`/rescue:all`opzione.

**Importante**  
Questo runbook richiede che l'istanza di destinazione sia un'istanza gestita da Windows con gli AWS strumenti per Windows PowerShell installati. Il runbook installa lo strumento Amazon EC2 Rescue for Windows Server utilizzando il pacchetto Systems Manager Distributor. `AWSSupport-EC2Rescue`

 **Come funziona?** 

Il runbook esegue i seguenti passaggi:
+ Installa lo strumento di risoluzione dei problemi di Amazon EC2 Rescue for Windows Server utilizzando il pacchetto Systems Manager Distributor.
+ Esegue l'azione specificata (`ResetAccess``CollectLogs`, o`FixAll`) con i parametri forniti.
+ Per`ResetAccess`: genera una password sicura e la archivia in Parameter Store.
+ Per`CollectLogs`: raccoglie i log di sistema e li carica nel bucket Amazon S3 specificato.
+ Per`FixAll`: tenta di risolvere i problemi sul volume offline specificato.

 [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RunEC2RescueForWindowsTool) 

**Tipo di documento**

Automazione

**Proprietario**

Amazon

**Piattaforme**

Windows

**Parametri**

**Autorizzazioni IAM richieste**

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+ `ssm:SendCommand`
+ `ssm:ListCommandInvocations`
+ `ssm:DescribeInstanceInformation`
+ `ssm:GetCommandInvocation`
+ `ssm:PutParameter`(per l' ResetAccess azione)
+ `kms:Encrypt`(per ResetAccess azioni con AWS KMS chiave personalizzata)
+ `s3:PutObject`(per CollectLogs l'azione)
+ `s3:GetBucketAcl`(per CollectLogs l'azione)
+ `s3:GetBucketPolicy`(per CollectLogs l'azione)
+ `s3:GetBucketPolicyStatus`(per CollectLogs l'azione)

Politica di esempio: 

```
{
    "Version": "2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:SendCommand",
                "ssm:ListCommandInvocations",
                "ssm:DescribeInstanceInformation",
                "ssm:GetCommandInvocation",
                "ssm:PutParameter",
                "kms:Encrypt",
                "s3:PutObject",
                "s3:GetBucketAcl",
                "s3:GetBucketPolicy",
                "s3:GetBucketPolicyStatus"
            ],
            "Resource": "*"
        }
    ]
}
```

 **Istruzioni** 

Segui questi passaggi per configurare l'automazione:

1. Accedere [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RunEC2RescueForWindowsTool/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RunEC2RescueForWindowsTool/description)a Systems Manager nella sezione Documenti.

1. Seleziona **Execute automation** (Esegui automazione).

1. Per i parametri di input, immettete quanto segue:
   + **Comando (richiesto):**
     + Descrizione: (Obbligatorio) L'azione da eseguire.
     + Tipo: `String`
     + Valori consentiti: `[ResetAccess, CollectLogs, FixAll]`
     + Impostazione predefinita: `ResetAccess`
   + **Parametri (obbligatori):**
     + Descrizione: (Obbligatorio) Parametri per il comando:
       + Per`ResetAccess`: l'ID o l'alias della AWS AWS KMS chiave (impostazione predefinita:`alias/aws/ssm`)
       + Per`CollectLogs`: il nome del bucket Amazon S3 su cui caricare i log
       + Per`FixAll`: il nome del dispositivo per la riparazione offline (ad esempio,) `xvdf`
     + Tipo: `String`
     + Pattern consentito: `^[0-9a-z][a-z0-9-.]{3,63}$|^(dev\/[a-z0-9]{2,10}|xv[a-z0-9]{1,10})$|^(alias\\aws\\ssm|[a-zA-Z0-9-/_]{1,32})$`

1. Seleziona **Esegui**.

1. L'automazione si avvia.

1. Il documento esegue le seguenti operazioni:
   + **installa EC2 Rescue**:

     Installa lo strumento di risoluzione dei problemi di Amazon EC2 Rescue for Windows Server utilizzando il pacchetto Systems Manager Distributor. `AWSSupport-EC2Rescue`
   + **eseguire: EC2 RescueForWindows**

     Esegue lo PowerShell script con l'azione specificata nel parametro Command per eseguire l'operazione richiesta.

1. Al termine, consultate la sezione **Output** per i risultati dettagliati dell'esecuzione.

**Riferimenti**

Systems Manager Automation
+ [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RunEC2RescueForWindowsTool/description)
+ [Esegui un'automazione](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html)
+ [Configurazione di un'automazione](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html)
+ [Flussi di lavoro di Support Automation](https://aws.amazon.com/premiumsupport/technology/saw/)
+ [Usa Amazon EC2 Rescue per Windows Server con il comando Systems Manager Run](https://docs.aws.amazon.com//AWSEC2/latest/WindowsGuide/ec2rw-ssm.html)