Amazon Tools for PowerShell V4 的支持已到期。
我们建议您迁移到 Amazon Tools for PowerShell V5 。有关如何迁移的更多详细信息和信息，请参阅我们的终止支持公告
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
使用适用于 PowerShell V4 的工具的 Resource Groups 示例
以下代码示例向您展示了如何使用带有 Resource Groups 的 Amazon Tools for PowerShell V4 来执行操作和实现常见场景。
操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
主题
操作
以下代码示例演示了如何使用 Add-RGResourceTag。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例向指定的资源组 arn 添加标签键“Instances”，其值为“workboxes”
Add-RGResourceTag -Tag @{Instances="workboxes"} -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes输出：
Arn Tags --- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes {[Instances, workboxes]}-
有关 API 详细信息，请参阅《Amazon Tools for PowerShell Cmdlet Reference (V4)》中的 Tag。
-
以下代码示例演示了如何使用 Find-RGResource。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例使用标签筛选器 ResourceQuery 创建 for Instance 资源类型并查找资源。
$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输出：
ResourceArn ResourceType ----------- ------------ arn:aws:ec2:eu-west-1:123456789012:instance/i-0123445b6cb7bd67b AWS::EC2::Instance-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) SearchResources中的。
-
以下代码示例演示了如何使用 Get-RGGroup。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例按组名称检索资源组
Get-RGGroup -GroupName auto-no输出：
Description GroupArn Name ----------- -------- ---- arn:aws:resource-groups:eu-west-1:123456789012:group/auto-no auto-no-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetGroup中的。
-
以下代码示例演示了如何使用 Get-RGGroupList。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例列出已创建的资源组。
Get-RGGroupList输出：
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-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListGroups中的。
-
以下代码示例演示了如何使用 Get-RGGroupQuery。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例获取给定资源组的资源查询
Get-RGGroupQuery -GroupName auto-no | Select-Object -ExpandProperty ResourceQuery输出：
Query Type ----- ---- {"ResourceTypeFilters":["AWS::EC2::Instance"],"TagFilters":[{"Key":"auto","Values":["no"]}]} TAG_FILTERS_1_0-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetGroupQuery中的。
-
以下代码示例演示了如何使用 Get-RGGroupResourceList。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例在按资源类型进行筛选的基础之上列出组资源
Get-RGGroupResourceList -Filter @{Name="resource-type";Values="AWS::EC2::Instance"} -GroupName auto-yes | Select-Object -ExpandProperty ResourceIdentifiers输出：
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-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListGroupResources中的。
-
以下代码示例演示了如何使用 Get-RGResourceTag。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例列出给定资源组 arn 的标签
Get-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes输出：
Key Value --- ----- Instances workboxes-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetTags中的。
-
以下代码示例演示了如何使用 New-RGGroup。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例创建了一个名 TestPowerShellGroup为的基于标签的新资源组 Resource Groups Amazon 资源组。该组包括当前区域中使用标签键 “名称” 和标签值 “test2” 标记的 Amazon EC2 实例。该命令返回组的查询和类型以及操作结果。
$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."输出：
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-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateGroup中的。
-
以下代码示例演示了如何使用 Remove-RGGroup。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例移除指定的资源组
Remove-RGGroup -GroupName non-tag-cfn-elbv2输出：
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-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteGroup中的。
-
以下代码示例演示了如何使用 Remove-RGResourceTag。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例从资源组中移除提到的标签
Remove-RGResourceTag -Arn arn:aws:resource-groups:eu-west-1:123456789012:group/workboxes -Key Instances输出：
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}-
有关 API 详细信息，请参阅《Amazon Tools for PowerShell Cmdlet Reference (V4)》中的 Untag。
-
以下代码示例演示了如何使用 Update-RGGroup。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例更新组的描述
Update-RGGroup -GroupName auto-yes -Description "Instances auto-remove"输出：
Description GroupArn Name ----------- -------- ---- Instances to be cleaned arn:aws:resource-groups:eu-west-1:123456789012:group/auto-yes auto-yes-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateGroup中的。
-
以下代码示例演示了如何使用 Update-RGGroupQuery。
- 适用于 PowerShell V4 的工具
-
示例 1：此示例创建一个查询对象并更新组的查询。
$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输出：
GroupName ResourceQuery --------- ------------- build600 Amazon.ResourceGroups.Model.ResourceQuery-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateGroupQuery中的。
-