Partager via

New-AzTag

  • Référence
Module:
Az.Resources

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.

Syntaxe

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 qui New-AzTag fait partie de ce module 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 Balise de l’applet de commande New-AzTag. Pour rechercher des groupes de ressources avec un nom de balise ou un nom et une valeur spécifiés, utilisez le paramètre Balise 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 new-AzTag avec un ResourceId crée ou met à jour l’ensemble 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 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 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
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:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Tag

Balises à placer sur la ressource.

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

Hashtable

Sorties

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