你当前正在访问 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-AzResourceGroupTag 参数将$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

输入

String

Hashtable

输出

PSResourceGroup