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.

Syntax

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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Operation

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

Type:TagPatchOperation
Accepted values:Merge, Replace, Delete
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Ensemble de balises à utiliser pour la mise à jour.

Type:Hashtable
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

TagPatchOperation

Hashtable

Sorties

PSTagResource