Update-AzTag
Actualiza de forma selectiva el conjunto de etiquetas en un recurso o suscripción.
Sintaxis
Default (valor predeterminado)
Update-AzTag
[-ResourceId] <String>
[-Tag] <Hashtable>
[-Operation] <TagPatchOperation>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<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
-AcquirePolicyToken
Adquiera automáticamente un token de Azure Policy para esta operación de recursos.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-ChangeReference
Identificador de recurso de referencia de cambio para esta operación de recurso.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: False Admite caracteres comodín: False DontShow: False Alias: cf
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Propiedades de parámetro
Tipo: IAzureContextContainer
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Operation
Operación de actualización. Las opciones son Combinar, Reemplazar y Eliminar.
Propiedades de parámetro
Tipo: TagPatchOperation
Valor predeterminado: None Valores aceptados: Merge, Replace, Delete Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: 2 Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-ResourceId
Identificador de recurso de la entidad etiquetada. Se puede etiquetar un recurso, un grupo de recursos o una suscripción.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: 0 Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Tag
Conjunto de etiquetas que se van a usar para la actualización.
Propiedades de parámetro
Tipo: Hashtable
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: 1 Mandatory: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta.
El cmdlet no se ejecuta.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: False Admite caracteres comodín: False DontShow: False Alias: wi
Conjuntos de parámetros
(All)
Posición: Named Mandatory: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas
