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.

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

-Tag

Balises à placer sur la ressource.

Type:	Hashtable
Position:	1
Default value:	None
Required:	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
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

Hashtable

Sorties

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

New-AzTag

Syntax

Description

Exemples

Exemple 1 : Créer une balise prédéfinie

Exemple 2 : Créer une balise prédéfinie avec une valeur

Exemple 3 : Ajouter une valeur à une balise prédéfinie

Exemple 4 : Utiliser une balise prédéfinie

Exemple 5 : Crée ou met à jour l’ensemble des étiquettes d’un abonnement

Exemple 6 : Crée ou met à jour l’ensemble complet des balises sur une ressource

Paramètres

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Entrées

Sorties

Commentaires

Ressources supplémentaires

New-AzTag

Syntax

Description

Exemples

Exemple 1 : Créer une balise prédéfinie

Exemple 2 : Créer une balise prédéfinie avec une valeur

Exemple 3 : Ajouter une valeur à une balise prédéfinie

Exemple 4 : Utiliser une balise prédéfinie

Exemple 5 : Crée ou met à jour l’ensemble des étiquettes d’un abonnement

Exemple 6 : Crée ou met à jour l’ensemble complet des balises sur une ressource

Paramètres

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Entrées

Sorties

Liens associés

Commentaires

Ressources supplémentaires