Especificar regiones de AWS - Herramientas de AWS para PowerShell (versión 4)
Especificación de un punto de enlace personalizado o que no sea estándarInformación adicional

Se ha publicado la versión 5 (V5) de Herramientas de AWS para PowerShell.

Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.

Especificar regiones de AWS

Hay dos formas de especificar la región de AWS que se va a utilizar al ejecutar comandos de Herramientas de AWS para PowerShell:

  • 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 cmdlets de AWS fallan si las Tools for Windows PowerShell no pueden descubrir qué región utilizar. Entre las excepciones se incluyen los cmdlets de Amazon S3, Amazon SES y AWS Identity and Access Management, que automáticamente utilizan un punto de enlace global de forma predeterminada.

Para especificar la región para un único comando de AWS

Agregue el parámetro -Region al comando, como el siguiente.

PS > Get-EC2Image -Region us-west-2

Para definir una región predeterminada para todos los comandos de la CLI de AWS en la sesión actual

En el símbolo del sistema de PowerShell, escriba el comando siguiente.

PS > Set-DefaultAWSRegion -Region us-west-2
nota

Este valor persiste únicamente durante la sesión actual. Para aplicar el valor a todas las sesiones de PowerShell, añada este comando a su perfil de PowerShell del mismo modo que para el comando Import-Module.

Para ver la región predeterminada actual de todos los comandos de la CLI de AWS

En el símbolo del sistema de PowerShell, escriba el comando siguiente.

PS > Get-DefaultAWSRegion

Region    Name             IsShellDefault
------    ----             --------------
us-west-2 US West (Oregon) True

Para borrar la región predeterminada actual de todos los comandos de la CLI de AWS

En el símbolo del sistema de PowerShell, escriba el comando siguiente.

PS > Clear-DefaultAWSRegion

Para ver una lista de todas las regiones de AWS disponibles

En el símbolo del sistema de PowerShell, escriba el comando siguiente. 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

Para especificar un punto de enlace personalizado como una URL, agregue el parámetro común -EndpointUrl a su comando de Tools for Windows PowerShell con 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 más información sobre las regiones de AWS, consulte Región de AWS en la Guía de referencia de las herramientas y los SDK de AWS.