你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzResourceGroup
修改资源组。
语法
Set-AzResourceGroup
-Name <String>
[-Tag] <Hashtable>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzResourceGroup
[-Tag] <Hashtable>
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 说明
Set-AzResourceGroup cmdlet 修改资源组的属性。 可以使用此 cmdlet 添加、更改或删除应用于资源组的 Azure 标记。 指定 Name 参数以标识资源组和 标记 参数以修改标记。 不能使用此 cmdlet 更改资源组的名称。
示例
示例 1：将标记应用于资源组
Set-AzResourceGroup -Name "ContosoRG" -Tag @{Department="IT"}此命令将具有 IT 值的 Department 标记应用于没有现有标记的资源组。
示例 2：向资源组添加标记
$Tags = (Get-AzResourceGroup -Name "ContosoRG").Tags
$Tags
$Tags += @{"Status"="Approved"; "FY2016"=$null}
Set-AzResourceGroup -Name "ContosoRG" -Tag $Tags
(Get-AzResourceGroup -Name "ContosoRG").Tags本示例向具有现有标记的资源组添加值为“已批准”和“FY2016”标记的状态标记。 由于指定的标记替换了现有标记，因此必须在新的标记集合中包含现有标记，否则将丢失这些标记。 第一个命令获取 ContosoRG 资源组，并使用 dot 方法获取其 Tags 属性的值。 该命令将标记存储在$Tags变量中。 第二个命令获取$Tags变量中的标记。 第三个命令使用 += 赋值运算符将 Status 和 FY2016 标记添加到$Tags变量中的标记数组。 第四个命令使用 Set-AzResourceGroup 的 Tag 参数将$Tags变量中的标记应用于 ContosoRG 资源组。 第五个命令获取应用于 ContosoRG 资源组的所有标记。 输出显示资源组具有 Department 标记和两个新标记“状态”和“FY2015”。
示例 3：删除资源组的所有标记
Set-AzResourceGroup -Name "ContosoRG" -Tag @{}此命令指定 具有空哈希表值的 Tag 参数，以从 ContosoRG 资源组中删除所有标记。
参数
-ApiVersion
指定资源提供程序支持的 API 版本。 可以指定与默认版本不同的版本。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefaultProfile
用于与 azure 通信的凭据、帐户、租户和订阅
| 类型: | IAzureContextContainer |
| 别名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Id
指定要修改的资源组的 ID。
| 类型: | String |
| 别名: | ResourceGroupId, ResourceId |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定要修改的资源组的名称。
| 类型: | String |
| 别名: | ResourceGroupName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Pre
指示此 cmdlet 在自动确定要使用的版本时会考虑预发布 API 版本。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Tag
以哈希表的形式进行键值对。 例如：@{key0=“value0”;key1=$null;key2=“value2”} 标记是一个名称/值对，可以创建并应用于资源和资源组。 将标记分配给资源和组后，可以使用 Get-AzResource 和 Get-AzResourceGroup 的 Tag 参数按标记名称或名称和值搜索资源和组。 可以使用标记按部门或成本中心对资源进行分类，或者跟踪有关资源的笔记或注释。
若要添加或更改标记，必须替换资源组的标记集合。 若要删除标记，请在 Get-AzResourceGroup 中输入当前应用于资源组的所有标记的哈希表，但要删除的标记除外。 若要从资源组中删除所有标记，请指定空哈希表： @{}
| 类型: | Hashtable |
| 别名: | Tags |
| Position: | 1 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |