Remove-AzTag
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 |
valeur par défaut: | False |
Obligatoire: | 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 |
valeur par défaut: | None |
Obligatoire: | 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 |
valeur par défaut: | None |
Obligatoire: | 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 |
valeur par défaut: | None |
Obligatoire: | 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 |
valeur par défaut: | None |
Obligatoire: | 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 |
valeur par défaut: | None |
Obligatoire: | 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 |
valeur par défaut: | False |
Obligatoire: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
String[]
Sorties
Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour