Поделиться через


Update-AzTag

Выборочно обновляет набор тегов в ресурсе или подписке.

Синтаксис

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

Описание

Командлет Update-AzTag с resourceId выборочно обновляет набор тегов в ресурсе или подписке. Эта операция позволяет заменить, объединить или выборочно удалить теги в указанном ресурсе или подписке. Указанная сущность может иметь не более 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

Эта команда объединяет набор тегов в подписке с xxxx-xxxx.

Пример 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

Эта команда заменяет набор тегов в подписке на xxxx-xxxx.

Пример 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

Эта команда удаляет набор тегов в подписке с параметром xxxx-xxxx-xxxx.

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Operation

Операция обновления. Параметры слияния, замены и удаления.

Тип:TagPatchOperation
Допустимые значения:Merge, Replace, Delete
Position:2
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceId

Идентификатор ресурса для помеченной сущности. Ресурс, группа ресурсов или подписка могут быть помечены.

Тип:String
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Tag

Набор тегов, используемых для обновления.

Тип:Hashtable
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

String

TagPatchOperation

Hashtable

Выходные данные

PSTagResource