Update-AzTag

Actualiza de forma selectiva el conjunto de etiquetas en un recurso o suscripción.

Syntax

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

Description

El cmdlet Update-AzTag con un ResourceId actualiza selectivamente el conjunto de etiquetas en un recurso o suscripción. Esta operación permite reemplazar, combinar o eliminar de forma selectiva etiquetas en el recurso o la suscripción especificados. La entidad especificada puede tener un máximo de 50 etiquetas al final de la operación. La opción 'replace' reemplaza todo el conjunto de etiquetas existentes por un nuevo conjunto. La opción "merge" permite agregar etiquetas con nuevos nombres y actualizar los valores de las etiquetas con nombres existentes. La opción "eliminar" permite eliminar etiquetas de forma selectiva en función de nombres o pares de nombre/valor especificados.

Ejemplos

Ejemplo 1: actualiza selectivamente el conjunto de etiquetas en una suscripción con la operación "Combinar".

$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

Este comando Combina el conjunto de etiquetas de la suscripción con "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Ejemplo 2: Actualiza selectivamente el conjunto de etiquetas de una suscripción con la operación "Reemplazar".

$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

Este comando reemplaza el conjunto de etiquetas de la suscripción por "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Ejemplo 3: Actualiza selectivamente el conjunto de etiquetas de una suscripción con la operación "Eliminar".

$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

Este comando elimina el conjunto de etiquetas de la suscripción con "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx".

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Operation

Operación de actualización. Las opciones son Combinar, Reemplazar y Eliminar.

Type:TagPatchOperation
Accepted values:Merge, Replace, Delete
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Identificador de recurso de la entidad etiquetada. Se puede etiquetar un recurso, un grupo de recursos o una suscripción.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Conjunto de etiquetas que se van a usar para la actualización.

Type:Hashtable
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

TagPatchOperation

Hashtable

Salidas

PSTagResource