Partager via

Get-AzureRmTag

  • Référence
Module:
AzureRM.Tags

Obtient des balises Azure prédéfinies.

Avertissement

Le module AzureRM PowerShell a été officiellement déconseillé depuis le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Bien que le module AzureRM puisse toujours fonctionner, il n’est plus conservé ou pris en charge, plaçant toute utilisation continue à la discrétion et au risque de l’utilisateur. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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

Description

L’applet de commande Get-AzureRmTag 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-AzureRMTag 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-AzureRmTag. Pour appliquer une balise prédéfinie à un groupe de ressources, utilisez le paramètre Tag de l’applet de commande New-AzureRmTag. 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-AzureRMResourceGroup.

Exemples

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

PS C:\>Get-AzureRmTag

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

PS C:\>Get-AzureRmTag -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

PS C:\>Get-AzureRmTag -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.

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias: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

Spécifie le nom de la balise à obtenir. Par défaut, Get-AzureRmTag 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

Entrées

String

SwitchParameter

Sorties

PSTag