Ferramentas da AWS para PowerShell O V4 entrou no modo de manutenção.
Recomendamos que você migre para a [Ferramentas da AWS para PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/). Para obter detalhes e informações adicionais sobre como migrar, consulte nosso [anúncio do modo de manutenção](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Especificar AWS regiões
Há duas maneiras de especificar a AWS região a ser usada ao executar Ferramentas da AWS para PowerShell comandos:
+ Use o parâmetro `-Region` comum em comandos individuais.
+ Use o comando `Set-DefaultAWSRegion` para definir uma região padrão para todos os comandos.
Muitos AWS cmdlets falham se o Tools for Windows não PowerShell conseguir descobrir qual região usar. As exceções incluem cmdlets para Amazon S3[, Amazon](pstools-s3.md) SES AWS Identity and Access Management e, que automaticamente assumem como padrão um endpoint global.
**Para especificar a região para um único AWS comando**
Adicione o parâmetro `-Region` ao seu comando, como o seguinte.
```
PS > Get-EC2Image -Region us-west-2
```
**Para definir uma região padrão para todos os comandos da AWS CLI na sessão atual**
No prompt de PowerShell comando, digite o comando a seguir.
```
PS > Set-DefaultAWSRegion -Region us-west-2
```
**nota**
Essa configuração é persistida apenas durante a sessão atual. Para aplicar a configuração a todas as suas PowerShell sessões, adicione esse comando ao seu PowerShell perfil da mesma forma que você fez com o `Import-Module` comando.
**Para visualizar a região padrão atual para todos os comandos da AWS CLI**
No prompt de PowerShell comando, digite o comando a seguir.
```
PS > Get-DefaultAWSRegion
Region Name IsShellDefault
------ ---- --------------
us-west-2 US West (Oregon) True
```
**Para limpar a região padrão atual para todos os comandos da AWS CLI**
No prompt de PowerShell comando, digite o comando a seguir.
```
PS > Clear-DefaultAWSRegion
```
**Para ver uma lista de todas as AWS regiões disponíveis**
No prompt de PowerShell comando, digite o comando a seguir. A terceira coluna na saída de exemplo identifica qual região é a padrão para a sessão atual.
```
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**
Algumas regiões podem ser compatíveis, mas não estão incluídas na saída do cmdlet `Get-AWSRegion`. Por exemplo, isso às vezes acontece em regiões que ainda não são globais. Se você não puder especificar uma região adicionando o parâmetro `-Region` a um comando, tente especificar a região em um endpoint personalizado, conforme mostrado na próxima seção.
## Especificar um endpoint não padrão ou personalizado
Especifique um endpoint personalizado como URL adicionando o parâmetro `-EndpointUrl` comum ao PowerShell comando do Tools for Windows, no formato de exemplo a seguir.
```
PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters
```
Veja a seguir um comando de exemplo que usa o cmdlet `Get-EC2Instance`. Neste exemplo, o endpoint personalizado está na região `us-west-2` ou Oeste dos EUA (Oregon), mas você poderá usar qualquer outra região da AWS compatível, incluindo regiões que não são enumeradas pelo `Get-AWSRegion`.
```
PS > Get-EC2Instance -EndpointUrl "https://service-custom-url.us-west-2.amazonaws.com" -InstanceID "i-0555a30a2000000e1"
```
## Mais informações
Para obter informações adicionais sobre AWS regiões, consulte [AWS Região](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) no *Guia de referência de ferramentas AWS SDKs e ferramentas*.