¡Se Herramientas de AWS para PowerShell ha lanzado la versión 5 (V5) del\$1
Para obtener información sobre los cambios más importantes y la migración de sus aplicaciones, consulte el tema [sobre migración](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html).
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
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.
# Especifique la AWS región para el Herramientas de AWS para PowerShell
Hay dos formas de especificar la AWS región que se va a utilizar al ejecutar Herramientas de AWS para PowerShell comandos:
+ Utilice el parámetro común `-Region` en comandos individuales.
+ Utilice el comando `Set-DefaultAWSRegion` para establecer una región predeterminada para todos los comandos.
Muchos AWS cmdlets fallan si las Herramientas de Windows no PowerShell pueden determinar qué región usar. Las excepciones incluyen los cmdlets de [Amazon S3](pstools-s3.md), Amazon SES y AWS Identity and Access Management, que se establecen automáticamente en un punto de enlace global de forma predeterminada.
**Para especificar la región de un solo comando AWS **
Agregue el parámetro `-Region` al comando, como el siguiente.
```
PS > Get-EC2Image -Region us-west-2
```
**Para establecer una región predeterminada para todos los comandos AWS CLI de la sesión actual**
En la PowerShell línea de comandos, escriba el siguiente comando.
```
PS > Set-DefaultAWSRegion -Region us-west-2
```
**nota**
Este valor persiste únicamente durante la sesión actual. Para aplicar la configuración a todas las PowerShell sesiones, añada este comando a su PowerShell perfil tal como lo hizo con el `Import-Module` comando.
**Para ver la región predeterminada actual de todos los comandos AWS CLI**
En la PowerShell línea de comandos, escriba el siguiente comando.
```
PS > Get-DefaultAWSRegion
Region Name IsShellDefault
------ ---- --------------
us-west-2 US West (Oregon) True
```
**Para borrar la región predeterminada actual para todos los comandos AWS CLI**
En la PowerShell línea de comandos, escriba el siguiente comando.
```
PS > Clear-DefaultAWSRegion
```
**Para ver una lista de todas las AWS regiones disponibles**
En la PowerShell línea de comandos, escriba el siguiente comando. La tercera columna del resultado de ejemplo identifica qué región es la predeterminada para su sesión actual.
```
PS > Get-AWSRegion
Region Name IsShellDefault
------ ---- --------------
ap-east-1 Asia Pacific (Hong Kong) False
ap-northeast-1 Asia Pacific (Tokyo) False
...
us-east-2 US East (Ohio) False
us-west-1 US West (N. California) False
us-west-2 US West (Oregon) True
...
```
**nota**
Es posible que se admitan algunas regiones, pero que no aparezcan en los resultados del cmdlet `Get-AWSRegion`. Por ejemplo, esto a veces también es válido para las regiones que aún no son globales. Si no puede especificar una región cuando agrega el parámetro `-Region` a un comando, intente especificar la región en un punto de enlace personalizado, como se muestra en la siguiente sección.
## Especificación de un punto de enlace personalizado o que no sea estándar
Especifique un punto final personalizado como URL añadiendo el parámetro `-EndpointUrl` común al PowerShell comando Tools for Windows, en el siguiente formato de ejemplo.
```
PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters
```
A continuación, se muestra un ejemplo con el cmdlet `Get-EC2Instance`. En este ejemplo, el punto de enlace personalizado se encuentra en la región `us-west-2` o EE. UU. Oeste (Oregón), pero puede utilizar cualquier otra región de AWS admitida, incluidas las que no aparecen cuando se ejecuta `Get-AWSRegion`.
```
PS > Get-EC2Instance -EndpointUrl "https://service-custom-url.us-west-2.amazonaws.com" -InstanceID "i-0555a30a2000000e1"
```
## Información adicional
Para obtener información adicional sobre AWS las regiones, consulte [AWS la sección Región](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) en la *Guía de referencia de herramientas AWS SDKs y herramientas*.