Freigeben über

Get-AzureRmTag

  • Referenz
Modul:
AzureRM.Tags

Ruft vordefinierte Azure-Tags ab.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Cmdlet "Get-AzureRmTag " ruft vordefinierte Azure-Tags in Ihrem Abonnement ab. Dieses Cmdlet gibt grundlegende Informationen zu den Tags oder detaillierten Informationen zu Tags und deren Werten zurück. Alle Ausgabeobjekte enthalten eine Count-Eigenschaft, die die Anzahl der Ressourcen und Ressourcengruppen darstellt, auf die die Tags und Werte angewendet wurden. Das Azure Tags-Modul, von dem Get-AzureRMTag gehört, kann Ihnen helfen, vordefinierte Azure-Tags zu verwalten. Ein Azure-Tag ist ein Name-Wert-Paar, mit dem Sie Ihre Azure-Ressourcen und -Ressourcengruppen kategorisieren können, z. B. nach Abteilung oder Kostenstelle, oder um Notizen oder Kommentare zu den Ressourcen und Gruppen nachzuverfolgen. Sie können Tags in einem einzigen Schritt definieren und anwenden, aber mit vordefinierten Tags können Sie Standard-, konsistente, vorhersagbare Namen und Werte für die Tags in Ihrem Abonnement einrichten. Verwenden Sie das Cmdlet "New-AzureRmTag", um ein vordefiniertes Tag zu erstellen. Um ein vordefiniertes Tag auf eine Ressourcengruppe anzuwenden, verwenden Sie den Tag-Parameter des Cmdlets New-AzureRmTag. Verwenden Sie den Tag-Parameter des Cmdlets "Get-AzureRMResourceGroup", um Ressourcengruppen nach einem bestimmten Tagnamen oder Namen und Wert zu durchsuchen.

Beispiele

Beispiel 1: Abrufen aller vordefinierten Tags

PS C:\>Get-AzureRmTag

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

Department    5
FY2015        2
CostCenter   20

Dieser Befehl ruft alle vordefinierten Tags im Abonnement ab. Die Count-Eigenschaft zeigt, wie oft das Tag auf Ressourcen und Ressourcengruppen im Abonnement angewendet wurde.

Beispiel 2: Abrufen eines Tags nach Name

PS C:\>Get-AzureRmTag -Name "Department"

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3

Dieser Befehl ruft detaillierte Informationen zum Department-Tag und seinen Werten ab. Die Count-Eigenschaft zeigt, wie oft das Tag und jeder seiner Werte auf Ressourcen und Ressourcengruppen im Abonnement angewendet wurde.

Beispiel 3: Abrufen von Werten aller Tags

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

Dieser Befehl verwendet den Parameter "Detailed ", um detaillierte Informationen zu allen vordefinierten Tags im Abonnement zu erhalten. Die Verwendung des Parameters "Detailed " entspricht der Verwendung des Namensparameters für jedes Tag.

Parameter

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

Gibt an, dass dieser Vorgang Informationen zu Tagwerten zur Ausgabe hinzufügt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt den Namen des abzurufenden Tags an. Standardmäßig ruft Get-AzureRmTag grundlegende Informationen zu allen vordefinierten Tags im Abonnement ab. Wenn Sie den Parameter Name angeben, hat der Parameter "Detailed " keine Auswirkung.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

String

SwitchParameter

Ausgaben

PSTag