Compartir a través de

Update-AzTag

  • Referencia
Módulo:
Az.Resources

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

Sintaxis

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.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Operation

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

Tipo:TagPatchOperation
Valores aceptados:Merge, Replace, Delete
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceId

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

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Tag

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

Tipo:Hashtable
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

TagPatchOperation

Hashtable

Salidas

PSTagResource