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á. # Exemplos de Resource Groups usando o Tools for PowerShell V5 Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V5 com Resource Groups. *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 ### `Add-RGResourceTag` O código de exemplo a seguir mostra como usar `Add-RGResourceTag`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo adiciona a chave de tag “Instances” com o valor “workboxes” ao ARN do grupo de recursos fornecido** ``` Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes ``` **Saída**: ``` Arn Tags --- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]} ``` + Consulte detalhes da API em [Tag](https://docs.aws.amazon.com/powershell/v5/reference) na *Referência de cmdlet do Ferramentas da AWS para PowerShell (V5)*. ### `Find-RGResource` O código de exemplo a seguir mostra como usar `Find-RGResource`. **Ferramentas para PowerShell V5** **Exemplo 1: Este exemplo cria um tipo de recurso ResourceQuery for Instance com filtros de tag e encontra 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 ``` **Saída**: ``` ResourceArn ResourceType ----------- ------------ arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance ``` + Para obter detalhes da API, consulte [SearchResources](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Get-RGGroup` O código de exemplo a seguir mostra como usar `Get-RGGroup`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo recupera o grupo de recursos de acordo com o nome do grupo** ``` Get-RGGroup -GroupName auto-no ``` **Saída**: ``` Description GroupArn Name ----------- -------- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no ``` + Para obter detalhes da API, consulte [GetGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Get-RGGroupList` O código de exemplo a seguir mostra como usar `Get-RGGroupList`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo lista o grupo de recursos já criado.** ``` Get-RGGroupList ``` **Saída**: ``` 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 obter detalhes da API, consulte [ListGroups](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Get-RGGroupQuery` O código de exemplo a seguir mostra como usar `Get-RGGroupQuery`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo busca a consulta de recursos para determinado grupo de recursos** ``` Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery ``` **Saída**: ``` Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0 ``` + Para obter detalhes da API, consulte [GetGroupQuery](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Get-RGGroupResourceList` O código de exemplo a seguir mostra como usar `Get-RGGroupResourceList`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo lista os recursos do grupo com base no filtro por tipo de recurso** ``` Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers ``` **Saída**: ``` 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 obter detalhes da API, consulte [ListGroupResources](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Get-RGResourceTag` O código de exemplo a seguir mostra como usar `Get-RGResourceTag`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo lista tags para o ARN do grupo de recursos fornecido** ``` Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes ``` **Saída**: ``` Key Value --- ----- Instances workboxes ``` + Para obter detalhes da API, consulte [GetTags](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `New-RGGroup` O código de exemplo a seguir mostra como usar `New-RGGroup`. **Ferramentas para PowerShell V5** **Exemplo 1: Este exemplo cria um novo grupo de AWS recursos de Resource Groups baseado em tags chamado TestPowerShellGroup. O grupo inclui EC2 instâncias da Amazon na região atual que são marcadas com a chave de tag “Nome” e o valor da tag “test2". O comando retorna a consulta, o tipo de grupo e os resultados da operação.** ``` $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." ``` **Saída**: ``` 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 obter detalhes da API, consulte [CreateGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Remove-RGGroup` O código de exemplo a seguir mostra como usar `Remove-RGGroup`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo remove o grupo de recursos nomeado** ``` Remove-RGGroup -GroupName non-tag-cfn-elbv2 ``` **Saída**: ``` 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 obter detalhes da API, consulte [DeleteGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Remove-RGResourceTag` O código de exemplo a seguir mostra como usar `Remove-RGResourceTag`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo remove a tag mencionada do grupo de recursos** ``` Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances ``` **Saída**: ``` 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} ``` + Consulte detalhes da API em [Untag](https://docs.aws.amazon.com/powershell/v5/reference) na *Referência de cmdlet do Ferramentas da AWS para PowerShell (V5)*. ### `Update-RGGroup` O código de exemplo a seguir mostra como usar `Update-RGGroup`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo atualiza a descrição do grupo** ``` Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove" ``` **Saída**: ``` Description GroupArn Name ----------- -------- ---- Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes ``` + Para obter detalhes da API, consulte [UpdateGroup](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ### `Update-RGGroupQuery` O código de exemplo a seguir mostra como usar `Update-RGGroupQuery`. **Ferramentas para PowerShell V5** **Exemplo 1: esse exemplo cria um objeto de consulta e atualiza a consulta para o 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 ``` **Saída**: ``` GroupName ResourceQuery --------- ------------- build600 Amazon.ResourceGroups.Model.ResourceQuery ``` + Para obter detalhes da API, consulte [UpdateGroupQuery](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*.