¡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 Resource Groups con Tools for PowerShell V5 Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la Herramientas de AWS para PowerShell V5 with Resource Groups. 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 ### `Add-RGResourceTag` En el siguiente ejemplo de código, se muestra cómo utilizar `Add-RGResourceTag`. **Herramientas para la PowerShell V5** **Ejemplo 1: En este ejemplo se añade la clave de etiqueta “Instances” con el valor “workboxes” al ARN del grupo de recursos especificado.** ``` Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes ``` **Salida:** ``` Arn Tags --- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]} ``` + Para obtener información sobre la API, consulte [Tag](https://docs.aws.amazon.com/powershell/v5/reference) en la *Referencia de cmdlets de Herramientas de AWS para PowerShell (V5)*. ### `Find-RGResource` En el siguiente ejemplo de código, se muestra cómo utilizar `Find-RGResource`. **Herramientas para V5 PowerShell ** **Ejemplo 1: Este ejemplo crea un tipo de recurso de ResourceQuery for Instance con filtros de etiquetas y busca recursos.** ``` $query = [Amazon.ResourceGroups.Model.ResourceQuery]::new() $query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0 $query.Query = ConvertTo-Json -Compress -Depth 4 -InputObject @{ ResourceTypeFilters = @('AWS::EC2::Instance') TagFilters = @(@{ Key = 'auto' Values = @('no') }) } Find-RGResource -ResourceQuery $query | Select-Object -ExpandProperty ResourceIdentifiers ``` **Salida:** ``` ResourceArn ResourceType ----------- ------------ arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance ``` + Para obtener más información sobre la API, consulte [SearchResources Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (V5)*. ### `Get-RGGroup` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-RGGroup`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se recupera el grupo de recursos por el nombre del grupo.** ``` Get-RGGroup -GroupName auto-no ``` **Salida:** ``` Description GroupArn Name ----------- -------- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no ``` + Para obtener más información sobre la API, consulte [GetGroup](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `Get-RGGroupList` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-RGGroupList`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se muestran los grupos de recursos ya creados.** ``` Get-RGGroupList ``` **Salida:** ``` GroupArn GroupName -------- --------- arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes arn:aws:resource-groups:eu-west-1:123456789012:group/build600 build600 ``` + Para obtener más información sobre la API, consulte [ListGroups](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `Get-RGGroupQuery` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-RGGroupQuery`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se recupera la consulta de recursos del grupo de recursos especificado.** ``` Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery ``` **Salida:** ``` Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0 ``` + Para obtener más información sobre la API, consulte [GetGroupQuery](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `Get-RGGroupResourceList` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-RGGroupResourceList`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se muestran los recursos del grupo en función de los filtrados por tipo de recurso.** ``` Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers ``` **Salida:** ``` ResourceArn ResourceType ----------- ------------ arn:aws:ec2:eu-west-1:123456789012:instance/i-0123bc45b567890e1 AWS::EC2::Instance arn:aws:ec2:eu-west-1:123456789012:instance/i-0a1caf2345f67d8dc AWS::EC2::Instance arn:aws:ec2:eu-west-1:123456789012:instance/i-012e3cb4df567e8aa AWS::EC2::Instance arn:aws:ec2:eu-west-1:123456789012:instance/i-0fd12dd3456789012 AWS::EC2::Instance ``` + Para obtener más información sobre la API, consulte [ListGroupResources](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `Get-RGResourceTag` En el siguiente ejemplo de código, se muestra cómo utilizar `Get-RGResourceTag`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se muestran las etiquetas del ARN de grupo de recursos especificado.** ``` Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes ``` **Salida:** ``` Key Value --- ----- Instances workboxes ``` + Para obtener más información sobre la API, consulte [GetTags](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `New-RGGroup` En el siguiente ejemplo de código, se muestra cómo utilizar `New-RGGroup`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se crea un nuevo grupo de AWS recursos Resource Groups basado en etiquetas denominado TestPowerShellGroup. El grupo incluye las EC2 instancias de Amazon de la región actual que están etiquetadas con la clave de etiqueta «Nombre» y el valor de etiqueta «test2". El comando devuelve la consulta y el tipo de grupo, así como los resultados de la operación.** ``` $ResourceQuery = New-Object -TypeName Amazon.ResourceGroups.Model.ResourceQuery $ResourceQuery.Type = "TAG_FILTERS_1_0" $ResourceQuery.Query = '{"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]}' $ResourceQuery New-RGGroup -Name TestPowerShellGroup -ResourceQuery $ResourceQuery -Description "Test resource group." ``` **Salida:** ``` Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"Name","Values":["test2"]}]} TAG_FILTERS_1_0 LoggedAt : 11/20/2018 2:40:59 PM Group : Amazon.ResourceGroups.Model.Group ResourceQuery : Amazon.ResourceGroups.Model.ResourceQuery Tags : {} ResponseMetadata : Amazon.Runtime.ResponseMetadata ContentLength : 338 HttpStatusCode : OK ``` + Para obtener más información sobre la API, consulte [CreateGroup Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v5/reference)*Cmdlet Reference (*V5). ### `Remove-RGGroup` En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-RGGroup`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se elimina el grupo de recursos designado.** ``` Remove-RGGroup -GroupName non-tag-cfn-elbv2 ``` **Salida:** ``` Confirm Are you sure you want to perform this action? Performing the operation "Remove-RGGroup (DeleteGroup)" on target "non-tag-cfn-elbv2". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y Description GroupArn Name ----------- -------- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/non-tag-cfn-elbv2 non-tag-cfn-elbv2 ``` + Para obtener más información sobre la API, consulte [DeleteGroup](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `Remove-RGResourceTag` En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-RGResourceTag`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se elimina la etiqueta mencionada del grupo de recursos.** ``` Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances ``` **Salida:** ``` Confirm Are you sure you want to perform this action? Performing the operation "Remove-RGResourceTag (Untag)" on target "arn:aws:resource-groups:eu-west-1:933303704102:group/workboxes". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Y Arn Keys --- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {Instances} ``` + Para obtener información sobre la API, consulte [Untag](https://docs.aws.amazon.com/powershell/v5/reference) en la *Referencia de cmdlets de Herramientas de AWS para PowerShell (V5)*. ### `Update-RGGroup` En el siguiente ejemplo de código, se muestra cómo utilizar `Update-RGGroup`. **Herramientas para V5 PowerShell ** **Ejemplo 1: En este ejemplo se actualiza la descripción del grupo.** ``` Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove" ``` **Salida:** ``` Description GroupArn Name ----------- -------- ---- Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes ``` + Para obtener más información sobre la API, consulte [UpdateGroup](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ### `Update-RGGroupQuery` En el siguiente ejemplo de código, se muestra cómo utilizar `Update-RGGroupQuery`. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: En este ejemplo se crea un objeto de consulta y se actualiza la consulta del grupo.** ``` $query = [Amazon.ResourceGroups.Model.ResourceQuery]::new() $query.Type = [Amazon.ResourceGroups.QueryType]::TAG_FILTERS_1_0 $query.Query = @{ ResourceTypeFilters = @('AWS::EC2::Instance') TagFilters = @(@{ Key='Environment' Values='Build600.11' }) } | ConvertTo-Json -Compress -Depth 4 Update-RGGroupQuery -GroupName build600 -ResourceQuery $query ``` **Salida:** ``` GroupName ResourceQuery --------- ------------- build600 Amazon.ResourceGroups.Model.ResourceQuery ``` + Para obtener más información sobre la API, consulte [UpdateGroupQuery](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5).