通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzTag

  • 参考
模块:
Az.Resources

选择性地更新资源或订阅上的标记集。

语法

Update-AzTag
      [-ResourceId] <String>
      [-Tag] <Hashtable>
      [-Operation] <TagPatchOperation>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

说明

具有 ResourceId 的 Update-AzTag cmdlet 有选择地更新资源或订阅上的标记集。 此操作允许替换、合并或选择性地删除指定资源或订阅上的标记。 指定的实体在操作结束时最多可以有 50 个标记。 “replace”选项将整个现有标记集替换为一个新集。 “merge”选项允许使用新名称添加标记，并使用现有名称更新标记的值。 “delete”选项允许根据给定的名称或名称/值对选择性地删除标记。

示例

示例 1：选择性地使用“合并”操作更新订阅上的标记集

$mergedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $mergedTags -Operation Merge

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key2     value2
             key3     value3

此命令将订阅上的标记集与“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx”合并。

示例 2：选择性地使用“替换”操作更新订阅上的标记集

$replacedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $replacedTags -Operation Replace

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key3     value3

此命令将订阅上的标记集替换为“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx”。

示例 3：选择性地使用“删除”操作更新订阅上的标记集

$deletedTags = @{"key1"="value1"}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $deletedTags -Operation Delete

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key3     value3

此命令使用“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxx”删除订阅上的标记集。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Operation

更新操作。 选项包括合并、替换和删除。

类型:TagPatchOperation
接受的值:Merge, Replace, Delete
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ResourceId

标记实体的资源标识符。 可以标记资源、资源组或订阅。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Tag

要用于更新的标记集。

类型:Hashtable
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

String

TagPatchOperation

Hashtable

输出

PSTagResource