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
Salidas
Vínculos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de