New-AzTag
Crée une balise Azure prédéfinie ou ajoute des valeurs à une balise existante | Crée ou met à jour l’ensemble des balises sur une ressource ou un abonnement.
Syntax
New-AzTag
[-Name] <String>
[[-Value] <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzTag
[-ResourceId] <String>
[-Tag] <Hashtable>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
CreatePredefinedTagSet : l’applet de commande New-AzTag crée une balise Azure prédéfinie avec une valeur prédéfinie facultative. Vous pouvez également l’utiliser pour ajouter des valeurs supplémentaires à des balises prédéfinies existantes. Pour créer une balise prédéfinie, entrez un nom de balise unique. Pour ajouter une valeur à une balise prédéfinie existante, spécifiez le nom de la balise existante et la nouvelle valeur. Cette applet de commande retourne un objet qui représente la balise nouvelle ou modifiée avec ses valeurs et le nombre de ressources auxquelles elle a été appliquée. Le module Balises Azure dont New-AzTag fait partie peut vous aider à gérer les 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. Pour appliquer une balise prédéfinie à une ressource ou un groupe de ressources, utilisez le paramètre Tag de l’applet de commande New-AzTag. Pour rechercher des groupes de ressources avec un nom d’étiquette ou un nom et une valeur spécifiés, utilisez le paramètre Tag de l’applet de commande Get-AzResourceGroup. Chaque balise a un nom. Les valeurs sont facultatives. Une balise Azure prédéfinie peut avoir plusieurs valeurs, mais lorsque vous appliquez la balise à une ressource ou un groupe de ressources, vous appliquez le nom de la balise et une seule de ses valeurs. Par exemple, vous pouvez créer une balise Department prédéfinie avec une valeur pour chaque service, par exemple finance, ressources humaines et informatique. Lorsque vous appliquez la balise Department à une ressource, vous appliquez une seule valeur prédéfinie, telle que Finance.
CreateByResourceIdParameterSet : l’applet de commande New-AzTag avec un ResourceId crée ou met à jour l’ensemble entier des balises sur une ressource ou un abonnement. Cette opération permet d’ajouter ou de remplacer l’ensemble des balises sur la ressource ou l’abonnement spécifié. L’entité spécifiée peut avoir un maximum de 50 balises.
Exemples
Exemple 1 : Créer une balise prédéfinie
New-AzTag -Name "FY2015"
Name ValuesTable Count Values
---- ----------- ----- ------
FY2015 0 {}
Cette commande crée une balise prédéfinie nommée FY2015. Cette balise n’a aucune valeur. Vous pouvez appliquer une balise sans valeurs à une ressource ou un groupe de ressources, ou utiliser New-AzTag pour ajouter des valeurs à la balise. Vous pouvez également spécifier une valeur lorsque vous appliquez la balise à la ressource ou au groupe de ressources.
Exemple 2 : Créer une balise prédéfinie avec une valeur
New-AzTag -Name "Department" -Value "Finance"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
Cette commande crée une balise prédéfinie nommée Department avec la valeur Finance.
Exemple 3 : Ajouter une valeur à une balise prédéfinie
New-AzTag -Name "Department" -Value "Finance"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
New-AzTag -Name "Department" -Value "IT"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
IT 0
Ces commandes créent une balise prédéfinie nommée Department avec deux valeurs. Si le nom de la balise existe, New-AzTag ajoute la valeur à la balise existante au lieu de en créer un.
Exemple 4 : Utiliser une balise prédéfinie
New-AzTag -Name "CostCenter" -Value "0001"
Name: CostCenter
Count: 0
Values:
Name Count
========= =====
0001 0
Set-AzResourceGroup -Name "EngineerBlog" -Tag @{Name="CostCenter";Value="0001"}
Name: EngineerBlog
Location: East US
Resources:
Name Type Location
=============== ======================= ========
EngineerBlog Microsoft.Web/sites West US
EngSvr01 Microsoft.Sql/servers West US
EngDB02 Microsoft.Sql/databases West US
Tags:
Name Value
========== =====
CostCenter 0001
Get-AzTag -Name "CostCenter"
Name: CostCenter
Count: 1
Values:
Name Count
========= =====
0001 1
Get-AzResourceGroup -Tag @{Name="CostCenter"}
Name: EngineerBlog
Location: East US
Resources:
Name Type Location
=============== ======================= ========
EngineerBlog Microsoft.Web/sites West US
EngSvr01 Microsoft.Sql/servers West US
EngDB02 Microsoft.Sql/databases West US
Tags:
Name Value
========== =====
CostCenter 0001
Les commandes de cet exemple créent et utilisent une balise prédéfinie.
Exemple 5 : Crée ou met à jour l’ensemble des étiquettes d’un abonnement
$Tags = @{"tagKey1"="tagValue1"; "tagKey2"="tagValue2"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $Tags
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
tagKey1 tagValue1
tagKey2 tagValue2
Cette commande crée ou met à jour l’ensemble des balises de l’abonnement avec {subId}.
Exemple 6 : Crée ou met à jour l’ensemble complet des balises sur une ressource
$Tags = @{"Dept"="Finance"; "Status"="Normal"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -Tag $Tags
Id : {Id}
Name : {Name}
Type : {Type}
Properties :
Name Value
======= =========
Dept Finance
Status Normal
Cette commande crée ou met à jour l’ensemble complet des balises sur la ressource avec {resourceId}.
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 balise prédéfini. Pour créer une balise prédéfinie, entrez un nom unique. Pour ajouter une valeur à une balise existante, entrez le nom de la balise existante. Si une balise prédéfinie existante porte le nom spécifié, New-AzTag ajoute la valeur spécifiée, le cas échéant, à la balise portant ce nom au lieu de créer une balise.
Type: | String |
Position: | 0 |
valeur par défaut: | None |
Obligatoire: | 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 |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Balises à placer sur la ressource.
Type: | Hashtable |
Position: | 1 |
valeur par défaut: | None |
Obligatoire: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Value
Spécifie une valeur d’étiquette prédéfinie. Les balises prédéfinies peuvent avoir plusieurs valeurs, mais vous ne pouvez entrer qu’une seule valeur dans chaque commande. Ce paramètre est facultatif, car les balises peuvent avoir des noms sans valeurs.
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
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