Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

 **Descripción** 

El ** AWSSupport-RunEC2RescueForWindowsTool ** manual ejecuta la herramienta de solución de problemas de Amazon EC2 Rescue for Windows Server en la instancia gestionada por Windows de Amazon Elastic Compute Cloud (Amazon EC2) de destino para ayudar a solucionar problemas comunes. Este manual admite tres acciones principales:
+ **ResetAccess**: restablece la contraseña del administrador local. La contraseña se genera de forma aleatoria y se almacena de forma segura en el almacén de AWS Systems Manager parámetros como`/EC2Rescue/Password/<instance_id>`. Si no proporciona ningún parámetro, la contraseña se cifra con la clave predeterminada AWS Key Management Service (AWS KMS)`alias/aws/ssm`. Si lo desea, puede especificar un identificador de AWS KMS clave para cifrar la contraseña con su propia clave.
+ **CollectLogs**: recopila registros y archivos de configuración del sistema operativo y los carga en un depósito de Amazon Simple Storage Service (Amazon S3) de su cuenta ejecutando Amazon EC2 Rescue con la opción. `/collect:all`
+ **FixAll**: intenta detectar y solucionar problemas en un volumen raíz de Windows sin conexión adjunto a la instancia actual mediante la ejecución de Amazon EC2 Rescue con la opción. `/rescue:all`

**importante**  
Este manual requiere que la instancia de destino sea una instancia administrada por Windows con las AWS herramientas para Windows PowerShell instaladas. El manual instala la herramienta Amazon EC2 Rescue para Windows Server mediante el paquete Systems Manager Distributor. `AWSSupport-EC2Rescue`

 **¿Cómo funciona?** 

El libro de instrucciones lleva a cabo los siguientes pasos:
+ Instala la herramienta de solución de problemas de Amazon EC2 Rescue para Windows Server mediante el paquete Systems Manager Distributor.
+ Ejecuta la acción especificada (`ResetAccess``CollectLogs`, o`FixAll`) con los parámetros proporcionados.
+ Para`ResetAccess`: genera una contraseña segura y la almacena en el almacén de parámetros.
+ Para`CollectLogs`: recopila los registros del sistema y los carga en el bucket de Amazon S3 especificado.
+ Para`FixAll`: intenta solucionar problemas en el volumen offline especificado.

 [Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RunEC2RescueForWindowsTool) 

**Tipo de documento**

Automatización

**Propietario**

Amazon

**Plataformas**

Windows

**Parámetros**

**Permisos de IAM necesarios**

El parámetro `AutomationAssumeRole` requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.
+ `ssm:SendCommand`
+ `ssm:ListCommandInvocations`
+ `ssm:DescribeInstanceInformation`
+ `ssm:GetCommandInvocation`
+ `ssm:PutParameter`(para la ResetAccess acción)
+ `kms:Encrypt`(para ResetAccess actuar con una AWS KMS clave personalizada)
+ `s3:PutObject`(para la CollectLogs acción)
+ `s3:GetBucketAcl`(para la CollectLogs acción)
+ `s3:GetBucketPolicy`(para la CollectLogs acción)
+ `s3:GetBucketPolicyStatus`(para la CollectLogs acción)

Ejemplo de política: 

```
{
    "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": "*"
        }
    ]
}
```

 **Instrucciones** 

Siga estos pasos para configurar la automatización:

1. Navegue hasta [`AWSSupport-RunEC2RescueForWindowsTool`](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RunEC2RescueForWindowsTool/description) el Administrador de Sistemas, en la sección Documentos.

1. Elija **Execute automation** (Ejecutar automatización).

1. Para los parámetros de entrada, introduzca lo siguiente:
   + **Comando (obligatorio): **
     + Descripción: (Obligatorio) La acción que se va a realizar.
     + Tipo: `String`
     + Valores permitidos: `[ResetAccess, CollectLogs, FixAll]`
     + Valor predeterminado: `ResetAccess`
   + **Parámetros (obligatorio): **
     + Descripción: Parámetros (obligatorios) del comando:
       + Para`ResetAccess`: el identificador de la AWS AWS KMS clave o el alias (predeterminado:`alias/aws/ssm`)
       + Para`CollectLogs`: el nombre del bucket de Amazon S3 al que subir los registros
       + Para`FixAll`: el nombre del dispositivo para la corrección fuera de línea (por ejemplo,`xvdf`)
     + Tipo: `String`
     + Patrón permitido: `^[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. Seleccione **Ejecutar**.

1. Se inicia la automatización.

1. Este documento realiza los siguientes pasos:
   + **Instale EC2 Rescue**:

     Instala la herramienta de solución de problemas de Amazon EC2 Rescue para Windows Server mediante el paquete Systems Manager Distributor. `AWSSupport-EC2Rescue`
   + **ejecuta: EC2RescueForWindows **

     Ejecuta el PowerShell script con la acción especificada en el parámetro Command para realizar la operación solicitada.

1. Una vez finalizada, revise la ** sección ** Salidas para ver los resultados detallados de la ejecución.

**Referencias**

Automatización de Systems Manager
+ [Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RunEC2RescueForWindowsTool/description)
+ [Ejecución de una automatización](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing.html)
+ [Configuración de Automatización](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-setup.html)
+ [Soporta flujos de trabajo de automatización ](https://aws.amazon.com/premiumsupport/technology/saw/)
+ [Utilice Amazon EC2 Rescue para Windows Server con el comando de ejecución de Systems Manager ](https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2rw-ssm.html)