¡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.
# Ejemplos de Amazon Cognito Identity con herramientas para la versión 5 PowerShell
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar situaciones comunes mediante el uso de la Herramientas de AWS para PowerShell V5 con Amazon Cognito Identity.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `Get-CGIIdentityPool`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CGIIdentityPool`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Recuperación de información sobre un grupo de identidades específico mediante el identificador.**
```
Get-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
**Salida:**
```
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 obtener más información sobre la API, consulte [DescribeIdentityPool](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-CGIIdentityPoolList`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CGIIdentityPoolList`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Recuperación de una lista de grupos de identidades existentes.**
```
Get-CGIIdentityPoolList
```
**Salida:**
```
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 obtener más información sobre la API, consulte [ListIdentityPools](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Get-CGIIdentityPoolRole`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CGIIdentityPoolRole`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Obtención de información sobre los roles de un grupo de identidades específico.**
```
Get-CGIIdentityPoolRole -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
**Salida:**
```
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 obtener más información sobre la API, consulte [GetIdentityPoolRoles](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `New-CGIIdentityPool`
En el siguiente ejemplo de código, se muestra cómo utilizar `New-CGIIdentityPool`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Creación de un nuevo grupo de identidades que permite identidades no autenticadas.**
```
New-CGIIdentityPool -AllowUnauthenticatedIdentities $true -IdentityPoolName CommonTests13
```
**Salida:**
```
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 obtener más información sobre la API, consulte [CreateIdentityPool](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Remove-CGIIdentityPool`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-CGIIdentityPool`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Eliminación de un grupo de identidades específico.**
```
Remove-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1
```
+ Para obtener más información sobre la API, consulte [DeleteIdentityPool](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Set-CGIIdentityPoolRole`
En el siguiente ejemplo de código, se muestra cómo utilizar `Set-CGIIdentityPoolRole`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Configuración del grupo de identidades específico para que tenga un rol de IAM no autenticado.**
```
Set-CGIIdentityPoolRole -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 -Role @{ "unauthenticated" = "arn:aws:iam::123456789012:role/CommonTests1Role" }
```
+ Para obtener más información sobre la API, consulte [SetIdentityPoolRoles](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).
### `Update-CGIIdentityPool`
En el siguiente ejemplo de código, se muestra cómo utilizar `Update-CGIIdentityPool`.
**Herramientas para la versión 5 PowerShell **
**Ejemplo 1: Actualización de algunas de las propiedades del grupo de identidades, en este caso el nombre del grupo de identidades.**
```
Update-CGIIdentityPool -IdentityPoolId us-east-1:0de2af35-2988-4d0b-b22d-EXAMPLEGUID1 -IdentityPoolName NewPoolName
```
**Salida:**
```
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 obtener más información sobre la API, consulte [UpdateIdentityPool](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).