Partager via

Get-AzTag

  • Référence
Module:
Az.Resources

Obtient des balises Azure prédéfinies | Obtient l’ensemble des balises d’une ressource ou d’un abonnement.

Syntaxe

Get-AzTag
   [[-Name] <String>]
   [-Detailed]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzTag
   -ResourceId <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

GetPredefinedTagSet : l’applet de commande Get-AzTag obtient des balises Azure prédéfinies dans votre abonnement. Cette applet de commande retourne des informations de base sur les balises ou des informations détaillées sur les balises et leurs valeurs. Tous les objets de sortie incluent une propriété Count qui représente le nombre de ressources et de groupes de ressources auxquels les balises et les valeurs ont été appliquées. Le module Balises Azure dont Get-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 créer une balise prédéfinie, utilisez l’applet de commande New-AzTag. Pour appliquer une balise prédéfinie à un groupe de ressources, utilisez le paramètre Tag de l’applet de commande New-AzTag. Pour rechercher un nom ou une valeur de balise spécifique dans les groupes de ressources, utilisez le paramètre Tag de l’applet de commande Get-AzResourceGroup.

GetByResourceIdParameterSet : l’applet de commande Get-AzTag avec un ResourceId obtient l’ensemble entier des balises sur une ressource ou un abonnement.

Exemples

Exemple 1 : Obtenir toutes les balises prédéfinies

Get-AzTag

Name      Count
========  =====

Department    5
FY2015        2
CostCenter   20

Cette commande obtient toutes les balises prédéfinies dans l’abonnement. La propriété Count indique le nombre de fois où la balise a été appliquée aux ressources et aux groupes de ressources de l’abonnement.

Exemple 2 : Obtenir une balise par nom

Get-AzTag -Name "Department"

Name:   Department
Count:  5
Values: 

        Name        Count
        ==========  =====

        Finance       2
        IT            3

Cette commande obtient des informations détaillées sur la balise Department et ses valeurs. La propriété Count indique le nombre de fois où l’étiquette et chacune de ses valeurs ont été appliquées aux ressources et aux groupes de ressources de l’abonnement.

Exemple 3 : Obtenir des valeurs de toutes les balises

Get-AzTag -Detailed

Name:   Department
Count:  5
Values: 

        Name        Count
        ==========  =====

        Finance       2
        IT            3


Name:   FY2015
Count:  2


Name:   CostCenter
Count:  20
Values: 

        Name        Count
        ==========  =====

        0001          5
        0002         10
        0003          5

Cette commande utilise le paramètre Détaillé pour obtenir des informations détaillées sur toutes les balises prédéfinies de l’abonnement. L’utilisation du paramètre Détaillé est l’équivalent de l’utilisation du paramètre Name pour chaque balise.

Exemple 4 : Obtenir l’ensemble des balises sur un abonnement

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             tagKey1  tagValue1
             tagKey2  tagValue2

Cette commande obtient l’ensemble complet des balises sur l’abonnement avec {subId}.

Exemple 5 : Obtenir l’ensemble des balises sur une ressource

Get-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Cette commande obtient l’ensemble entier des balises sur la ressource avec {resourceId}.

Paramètres

-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

-Detailed

Indique que cette opération ajoute des informations sur les valeurs de balise à la sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Nom de la balise prédéfinie. Par défaut, Get-AzTag obtient des informations de base sur toutes les balises prédéfinies de l’abonnement. Lorsque vous spécifiez le paramètre Name , le paramètre Détaillé n’a aucun effet.

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

Entrées

String

SwitchParameter

Sorties

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