Partager via

Remove-AzTag

  • Référence
Module:
Az.Resources

Supprime des balises ou des valeurs Azure prédéfinies | Supprime l’ensemble des balises d’une ressource ou d’un abonnement.

Syntaxe

Remove-AzTag
      [-Name] <String>
      [[-Value] <String[]>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzTag
      [-PassThru]
      -ResourceId <String>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

RemovePredefinedTagSet: l’applet de commande Remove-AzTag supprime les balises et valeurs Azure prédéfinies de votre abonnement. Pour supprimer des valeurs particulières d’une balise prédéfinie, utilisez le paramètre valeur. Par défaut, Remove-AzTag supprime la balise spécifiée et toutes ses valeurs. Vous ne pouvez pas supprimer une balise ou une valeur actuellement appliquée à une ressource ou un groupe de ressources. Avant d’utiliser Remove-AzTag, utilisez le paramètre balise de l’applet de commande Set-AzResourceGroup pour supprimer la balise ou les valeurs du groupe de ressources ou de ressources. Le module Balises Azure qui Remove-AzTag fait partie de ce module peut vous aider à gérer vos balises Azure prédéfinies. Une balise Azure est une paire nom-valeur que vous pouvez utiliser pour catégoriser vos ressources et groupes de ressources Azure, tels que par service ou centre de coûts, ou pour suivre des notes ou des commentaires sur les ressources et les groupes. Vous pouvez définir et appliquer des balises en une seule étape, mais les balises prédéfinies vous permettent d’établir des noms et des valeurs standard, cohérents, prévisibles pour les balises de votre abonnement.

RemoveByResourceIdParameterSet: l’applet de commande Remove-AzTag Remove-AzTag avec ResourceId supprime l’ensemble des balises d’une ressource ou d’un abonnement.

Exemples

Exemple 1 : Supprimer une balise prédéfinie

Remove-AzTag -Name "Department"

Cette commande supprime la balise prédéfinie nommée Department et toutes ses valeurs. Si la balise a été appliquée à des ressources ou à des groupes de ressources, la commande échoue.

Exemple 2 : Supprimer une valeur d’une balise prédéfinie

Remove-AzTag -Name "Department" -Value "HumanResources" -PassThru

Name:   Department
Count:  14
Values: 

        Name        Count
        =========   =====

        Finance        2
        IT            12

Cette commande supprime la valeur HumanResources de la balise Department prédéfinie. Elle ne supprime pas la balise. Si la valeur a été appliquée à des ressources ou à des groupes de ressources, la commande échoue.

Exemple 3 : Supprime l’ensemble des étiquettes d’un abonnement

Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Cette commande supprime l’ensemble des balises de l’abonnement avec {subId}. Il ne retourne pas l’objet supprimé s’il ne passe passThru à « -PassThru ».

Exemple 4 : Supprime l’ensemble des balises d’une ressource

Remove-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -PassThru

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Cette commande supprime l’ensemble entier des balises sur la ressource avec {resourceId}. Elle retourne l’ojection supprimée lors de la transmission de « -PassThru ».

Paramètres

-Confirm

Vous invite à confirmer 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

-Name

Spécifie le nom de la balise prédéfinie à supprimer. Par défaut, Remove-AzTag supprime la balise spécifiée et toutes ses valeurs. Pour supprimer les valeurs sélectionnées, mais pas supprimer la balise, utilisez le paramètre Valeur.

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

-PassThru

Retourne un objet qui représente la balise supprimée ou la balise résultante avec une valeur supprimée.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
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:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Value

Supprime les valeurs spécifiées de la balise prédéfinie, mais ne supprime pas la balise.

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. 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[]

Sorties

Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource