Partager via

Update-AzTag

  • Référence
Module:
Az.Resources

Met à jour de manière sélective l’ensemble d’étiquettes sur une ressource ou un abonnement.

Syntaxe

Update-AzTag
      [-ResourceId] <String>
      [-Tag] <Hashtable>
      [-Operation] <TagPatchOperation>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<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

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Operation

Opération de mise à jour. Les options sont Fusion, Remplacement et Suppression.

Type:TagPatchOperation
Valeurs acceptées:Merge, Replace, Delete
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceId

Identificateur de ressource de l’entité étiquetée. Une ressource, un groupe de ressources ou un abonnement peut être marqué.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Tag

Ensemble de balises à utiliser pour la mise à jour.

Type:Hashtable
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

TagPatchOperation

Hashtable

Sorties

PSTagResource