Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).

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.

# Utilizar `ChangePassword` con una CLI
<a name="iam_example_iam_ChangePassword_section"></a>

Los siguientes ejemplos de código muestran cómo utilizar `ChangePassword`.

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

**AWS CLI**  
**Cómo cambiar la contraseña de un usuario de IAM **  
Para cambiar la contraseña de su usuario de IAM, recomendamos utilizar el parámetro `--cli-input-json` para pasar un archivo JSON que contenga sus contraseñas antiguas y nuevas. Con este método, puede utilizar contraseñas seguras con caracteres no alfanuméricos. Puede resultar difícil utilizar contraseñas con caracteres no alfanuméricos al pasarlas como parámetros de la línea de comandos. Para usar el parámetro `--cli-input-json`, comience por usar el comando `change-password` con el parámetro `--generate-cli-skeleton`, como en el siguiente ejemplo.  

```
aws iam change-password \
    --generate-cli-skeleton > change-password.json
```
El comando anterior crea un archivo JSON llamado change-password.json que puede usar para rellenar las contraseñas antiguas y nuevas. Por ejemplo, el rol podría tener el siguiente aspecto.  

```
{
    "OldPassword": "3s0K_;xh4~8XXI",
    "NewPassword": "]35d/{pB9Fo9wJ"
}
```
A continuación, para cambiar la contraseña, vuelva a utilizar el comando `change-password`, esta vez pasando el parámetro `--cli-input-json` para especificar el archivo JSON. El siguiente comando `change-password` usa el parámetro `--cli-input-json` con un archivo JSON llamado change-password.json.  

```
aws iam change-password \
    --cli-input-json file://change-password.json
```
Este comando no genera ninguna salida.  
Solo los usuarios de IAM pueden llamar a este comando. Si se llama a este comando con las credenciales de la AWS cuenta (root), el comando devuelve un `InvalidUserType` error.  
Para obtener más información, consulte [Cómo el usuario de IAM cambia su propia contraseña](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_user-change-own.html) en la *Guía del usuario de AWS IAM*.  
+  Para obtener más información sobre la API, consulte [ChangePassword](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/change-password.html)la *Referencia de AWS CLI comandos*. 

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

**Herramientas para la PowerShell versión 4**  
**Ejemplo 1: este comando cambia la contraseña del usuario que ejecuta el comando. Solo los usuarios de IAM pueden llamar a este comando. Si se ejecuta este comando cuando ha iniciado sesión con las credenciales de la AWS cuenta (root), el comando devolverá un error. `InvalidUserType`**  

```
Edit-IAMPassword -OldPassword "MyOldP@ssw0rd" -NewPassword "MyNewP@ssw0rd"
```
+  Para obtener más información sobre la API, consulte [ChangePassword](https://docs.aws.amazon.com/powershell/v4/reference)la referencia de *Herramientas de AWS para PowerShell cmdlets (*V4). 

**Herramientas para la versión 5 PowerShell **  
**Ejemplo 1: este comando cambia la contraseña del usuario que ejecuta el comando. Solo los usuarios de IAM pueden llamar a este comando. Si se ejecuta este comando al iniciar sesión con las credenciales de la AWS cuenta (root), el comando devolverá un error. `InvalidUserType`**  

```
Edit-IAMPassword -OldPassword "MyOldP@ssw0rd" -NewPassword "MyNewP@ssw0rd"
```
+  Para obtener más información sobre la API, consulte *Herramientas de AWS para PowerShell Cmdlet [ChangePassword](https://docs.aws.amazon.com/powershell/v5/reference)Reference (*V5). 

------