Update-AzTag
Met à jour de manière sélective l’ensemble d’étiquettes sur une ressource ou un abonnement.
Syntaxe
Default (Par défaut)
Update-AzTag
[-ResourceId] <String>
[-Tag] <Hashtable>
[-Operation] <TagPatchOperation>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[-AcquirePolicyToken]
[-ChangeReference <String>]
[<CommonParameters>]
Description
L’applet de commande Update-AzTag avec ResourceId met à jour de manière sélective l’ensemble des balises sur une ressource ou un abonnement.
Cette opération permet de remplacer, fusionner ou supprimer sélectivement des balises sur la ressource ou l’abonnement spécifiés. L’entité spécifiée peut avoir au maximum 50 balises à la fin de l’opération. L’option « replace » remplace l’ensemble entier des balises existantes par un nouveau jeu. L’option « fusionner » permet d’ajouter des balises avec de nouveaux noms et de mettre à jour les valeurs des balises avec des noms existants. L’option « delete » permet de supprimer sélectivement des balises en fonction des noms ou des paires nom/valeur donnés.
Exemples
Exemple 1 : Met à jour sélectivement l’ensemble des balises sur un abonnement avec l’opération « Fusionner »
$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
Cette commande fusionne l’ensemble de balises sur l’abonnement avec « xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ».
Exemple 2 : Met à jour sélectivement l’ensemble de balises sur un abonnement avec l’opération « Remplacer »
$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
Cette commande remplace l’ensemble de balises sur l’abonnement par « xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ».
Exemple 3 : Met à jour sélectivement l’ensemble de balises sur un abonnement avec l’opération « Supprimer »
$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
Cette commande supprime l’ensemble des balises sur l’abonnement avec « xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ».
Paramètres
-AcquirePolicyToken
Acquérir automatiquement un jeton Azure Policy pour cette opération de ressource.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-ChangeReference
ID de ressource de référence de modification pour cette opération de ressource.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Confirm
Vous invite à confirmer avant d’exécuter l’applet de commande.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: False Prend en charge les caractères génériques: False DontShow: False Alias: cf
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Propriétés du paramètre
Type: IAzureContextContainer
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
-Operation
Opération de mise à jour. Les options sont Fusion, Remplacement et Suppression.
Propriétés du paramètre
Type: TagPatchOperation
Valeur par défaut: None Valeurs acceptées: Merge, Replace, Delete Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: 2 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-ResourceId
Identificateur de ressource de l’entité étiquetée. Une ressource, un groupe de ressources ou un abonnement peut être marqué.
Propriétés du paramètre
Type: String
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: 0 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-Tag
Ensemble de balises à utiliser pour la mise à jour.
Propriétés du paramètre
Type: Hashtable
Valeur par défaut: None Prend en charge les caractères génériques: False DontShow: False
Jeux de paramètres
(All)
Position: 1 Obligatoire: True Valeur du pipeline: False Valeur du pipeline par nom de propriété: True Valeur des arguments restants: False
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute.
L’applet de commande ne s’exécute pas.
Propriétés du paramètre
Type: SwitchParameter
Valeur par défaut: False Prend en charge les caractères génériques: False DontShow: False Alias: Wi
Jeux de paramètres
(All)
Position: Named Obligatoire: False Valeur du pipeline: False Valeur du pipeline par nom de propriété: False Valeur des arguments restants: False
CommonParameters
Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters .
Sorties
