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.

Syntax

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 Value . 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 Tag de l’applet de commande Set-AzResourceGroup pour supprimer la balise ou les valeurs de la ressource ou du groupe de ressources. Le module Balises Azure dont Remove-AzTag fait partie 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 avec un ResourceId supprime l’ensemble entier 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 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

-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 Value .

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
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:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Value

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

Type:String[]
Position:1
Default value:None
Required:False
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

String[]

SwitchParameter

Sorties

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