Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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á.
# Exemplos de identidade do Amazon Cognito usando ferramentas para V4 PowerShell
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V4 com o Amazon Cognito Identity.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `Get-CGIIdentityPool`
O código de exemplo a seguir mostra como usar `Get-CGIIdentityPool`.
**Ferramentas para PowerShell V4**
**Exemplo 1: Recupera informações sobre um banco de identidades específico por meio de seu ID.**
```
Get-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
**Saída**:
```
LoggedAt : 8/12/2015 4:29:40 PM
AllowUnauthenticatedIdentities : True
DeveloperProviderName :
IdentityPoolId : us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
IdentityPoolName : CommonTests1
OpenIdConnectProviderARNs : {}
SupportedLoginProviders : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 142
HttpStatusCode : OK
```
+ Para obter detalhes da API, consulte [DescribeIdentityPool](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*.
### `Get-CGIIdentityPoolList`
O código de exemplo a seguir mostra como usar `Get-CGIIdentityPoolList`.
**Ferramentas para PowerShell V4**
**Exemplo 1: Recupera uma lista de bancos de identidades existentes.**
```
Get-CGIIdentityPoolList
```
**Saída**:
```
IdentityPoolId IdentityPoolName
-------------- ----------------
us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 CommonTests1
us-east-1:118d242d-204e-4b88-b803-EXAMPLEGUID2 Tests2
us-east-1:15d49393-ab16-431a-b26e-EXAMPLEGUID3 CommonTests13
```
+ Para obter detalhes da API, consulte [ListIdentityPools](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*.
### `Get-CGIIdentityPoolRole`
O código de exemplo a seguir mostra como usar `Get-CGIIdentityPoolRole`.
**Ferramentas para PowerShell V4**
**Exemplo 1: Obtém as informações sobre as funções de um banco de identidades específico.**
```
Get-CGIIdentityPoolRole -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
**Saída**:
```
LoggedAt : 8/12/2015 4:33:51 PM
IdentityPoolId : us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
Roles : {[unauthenticated, arn:aws:iam::123456789012:role/CommonTests1Role]}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 165
HttpStatusCode : OK
```
+ Para obter detalhes da API, consulte [GetIdentityPoolRoles](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*.
### `New-CGIIdentityPool`
O código de exemplo a seguir mostra como usar `New-CGIIdentityPool`.
**Ferramentas para PowerShell V4**
**Exemplo 1: Cria um novo banco de identidades que permite identidades não autenticadas.**
```
New-CGIIdentityPool -AllowUnauthenticatedIdentities $true -IdentityPoolName CommonTests13
```
**Saída**:
```
LoggedAt : 8/12/2015 4:56:07 PM
AllowUnauthenticatedIdentities : True
DeveloperProviderName :
IdentityPoolId : us-east-1:15d49393-ab16-431a-b26e-EXAMPLEGUID3
IdentityPoolName : CommonTests13
OpenIdConnectProviderARNs : {}
SupportedLoginProviders : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 136
HttpStatusCode : OK
```
+ Para obter detalhes da API, consulte [CreateIdentityPool](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*.
### `Remove-CGIIdentityPool`
O código de exemplo a seguir mostra como usar `Remove-CGIIdentityPool`.
**Ferramentas para PowerShell V4**
**Exemplo 1: Exclui um banco de identidades específico.**
```
Remove-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
+ Para obter detalhes da API, consulte [DeleteIdentityPool](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*.
### `Set-CGIIdentityPoolRole`
O código de exemplo a seguir mostra como usar `Set-CGIIdentityPoolRole`.
**Ferramentas para PowerShell V4**
**Exemplo 1: Configura o banco de identidades específico para ter um perfil do IAM não autenticado.**
```
Set-CGIIdentityPoolRole -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 -Role @{ "unauthenticated" = "arn:aws:iam::123456789012:role/CommonTests1Role" }
```
+ Para obter detalhes da API, consulte [SetIdentityPoolRoles](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*.
### `Update-CGIIdentityPool`
O código de exemplo a seguir mostra como usar `Update-CGIIdentityPool`.
**Ferramentas para PowerShell V4**
**Exemplo 1: Atualiza algumas das propriedades do banco de identidades, neste caso, o nome do banco de identidades.**
```
Update-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 -IdentityPoolName NewPoolName
```
**Saída**:
```
LoggedAt : 8/12/2015 4:53:33 PM
AllowUnauthenticatedIdentities : False
DeveloperProviderName :
IdentityPoolId : us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
IdentityPoolName : NewPoolName
OpenIdConnectProviderARNs : {}
SupportedLoginProviders : {}
ResponseMetadata : Amazon.Runtime.ResponseMetadata
ContentLength : 135
HttpStatusCode : OK
```
+ Para obter detalhes da API, consulte [UpdateIdentityPool](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*.