Freigeben über

Get-AzTag

  • Referenz
Modul:
Az.Resources

Ruft vordefinierte Azure-Tags | Ruft den gesamten Satz von Tags für eine Ressource oder ein Abonnement ab.

Syntax

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

Beschreibung

GetPredefinedTagSet: Das Cmdlet "Get-AzTag " 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-AzTag teil ist, kann Ihnen beim Verwalten vordefinierter Azure-Tags helfen. 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-AzTag, um ein vordefiniertes Tag zu erstellen. Um ein vordefiniertes Tag auf eine Ressourcengruppe anzuwenden, verwenden Sie den Tag-Parameter des Cmdlets New-AzTag. Verwenden Sie den Tag-Parameter des Cmdlets "Get-AzResourceGroup", um Ressourcengruppen nach einem bestimmten Tagnamen oder Namen und Wert zu durchsuchen.

GetByResourceIdParameterSet: Das Get-AzTag-Cmdlet mit einer ResourceId ruft den gesamten Satz von Tags für eine Ressource oder ein Abonnement ab.

Beispiele

Beispiel 1: Abrufen aller vordefinierten Tags

Get-AzTag

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

Get-AzTag -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

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

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.

Beispiel 4: Abrufen des gesamten Tagssatzes für ein Abonnement

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

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

Dieser Befehl ruft den gesamten Satz von Tags für das Abonnement mit {subId} ab.

Beispiel 5: Abrufen des gesamten Tagssatzes für eine 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

Dieser Befehl ruft den gesamten Satz von Tags für die Ressource mit {resourceId} ab.

Parameter

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Detailed

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceId

Der Ressourcenbezeichner für die markierte Entität. Eine Ressource, eine Ressourcengruppe oder ein Abonnement kann markiert werden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

SwitchParameter

Ausgaben

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