

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada\$1

Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o [tópico de migração](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)

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á.

# Resolução de perfil e credenciais
<a name="creds-assign"></a>

## Ordem de pesquisa de credenciais
<a name="cred-provider-chain-main"></a>

Quando você executa um comando, Ferramentas da AWS para PowerShell pesquisa as credenciais na seguinte ordem. Ele para ao encontrar credenciais utilizáveis.

1. As credenciais literais incorporadas como parâmetros na linha de comando.

   É altamente recomendável usar perfis em vez de colocar as credenciais literais em suas linhas de comando.

1. Credenciais especificadas pelo parâmetro `-Credential`.

1. Um nome de perfil ou localização de perfil que foi especificado usando o AWSCredential cmdlet [Set-](https://docs.aws.amazon.com/powershell/v5/reference/items/Set-AWSCredential.html).
   + Se você especificar somente um nome de perfil, o comando procurará o perfil especificado no repositório do AWS SDK e, se ele não existir, o perfil especificado no arquivo de credenciais AWS compartilhadas no local padrão.
   + Se você especificar apenas um local de perfil, o comando procurará o perfil `default` desse arquivo de credenciais.
   + Se você especificar um nome e um local, o comando procurará o perfil especificado nesse arquivo de credenciais.

   Se o perfil ou o local especificado não for encontrado, o comando lançará uma exceção. A pesquisa passará para as seguintes etapas somente se você não tiver especificado um perfil ou local.

1. Credenciais criadas a partir das variáveis de `AWS_SESSION_TOKEN` ambiente `AWS_ACCESS_KEY_ID``AWS_SECRET_ACCESS_KEY`, e, se todas as três variáveis tiverem um valor.

1. O perfil de credenciais com o nome especificado pela variável de `AWS_PROFILE` ambiente.

1. Use um perfil padrão, na seguinte ordem:

   1. O `default` perfil na loja do AWS SDK.

   1. O `default` perfil no AWS `credentials` arquivo compartilhado.

   1. O `AWS PS Default` perfil na loja do AWS SDK.

1. Se o comando estiver sendo executado em uma EC2 instância da Amazon configurada para usar uma função do IAM, as credenciais temporárias da EC2 instância serão acessadas a partir do perfil da instância.

   Para obter mais informações sobre o uso de funções do IAM para EC2 instâncias da Amazon, consulte [Conceder acesso com uma função](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-hosm.html) no [Guia do AWS SDK para .NET desenvolvedor](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/).

Se essa pesquisa não conseguir localizar as credenciais especificadas, o comando lançará uma exceção.

Para obter informações adicionais sobre variáveis de ambiente e perfis de credenciais, consulte os seguintes tópicos no [Guia de Referência de Ferramentas AWS SDKs e Ferramentas](https://docs.aws.amazon.com/sdkref/latest/guide/): [Variáveis de ambiente](https://docs.aws.amazon.com/sdkref/latest/guide/environment-variables.html), [Lista de variáveis de ambiente](https://docs.aws.amazon.com/sdkref/latest/guide/settings-reference.html#EVarSettings) e arquivos de [configuração e credenciais compartilhados](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html).