Delen via

Get-AzTag

  • Referentie
Module:
Az.Resources

Hiermee worden vooraf gedefinieerde Azure-tags opgehaald | Hiermee haalt u de volledige set tags op voor een resource of abonnement.

Syntaxis

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

Description

GetPredefinedTagSet: De Get-AzTag-cmdlet haalt vooraf gedefinieerde Azure-tags in uw abonnement op. Deze cmdlet retourneert basisinformatie over de tags of gedetailleerde informatie over tags en de bijbehorende waarden. Alle uitvoerobjecten bevatten een eigenschap Count die het aantal resources en resourcegroepen vertegenwoordigt waarop de tags en waarden zijn toegepast. De Azure Tags-module waarvan Get-AzTag deel uitmaakt, kan u helpen bij het beheren van vooraf gedefinieerde Azure-tags. Een Azure-tag is een naam-waardepaar dat u kunt gebruiken om uw Azure-resources en resourcegroepen, zoals per afdeling of kostenplaats, te categoriseren of notities of opmerkingen over de resources en groepen bij te houden. U kunt tags in één stap definiëren en toepassen, maar met vooraf gedefinieerde tags kunt u standaard, consistente, voorspelbare namen en waarden instellen voor de tags in uw abonnement. Gebruik de cmdlet New-AzTag om een vooraf gedefinieerde tag te maken. Als u een vooraf gedefinieerde tag wilt toepassen op een resourcegroep, gebruikt u de tagparameter van de cmdlet New-AzTag. Als u resourcegroepen wilt zoeken naar een specifieke tagnaam of naam en waarde, gebruikt u de tagparameter van de cmdlet Get-AzResourceGroup.

GetByResourceIdParameterSet: De Get-AzTag-cmdlet met een ResourceId haalt de volledige set tags op voor een resource of abonnement.

Voorbeelden

Voorbeeld 1: Alle vooraf gedefinieerde tags ophalen

Get-AzTag

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

Department    5
FY2015        2
CostCenter   20

Met deze opdracht worden alle vooraf gedefinieerde tags in het abonnement opgehaald. De eigenschap Count laat zien hoe vaak de tag is toegepast op resources en resourcegroepen in het abonnement.

Voorbeeld 2: Een tag ophalen op naam

Get-AzTag -Name "Department"

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3

Met deze opdracht krijgt u gedetailleerde informatie over de afdelingstag en de bijbehorende waarden. De eigenschap Count laat zien hoe vaak de tag en elk van de bijbehorende waarden is toegepast op resources en resourcegroepen in het abonnement.

Voorbeeld 3: Waarden van alle tags ophalen

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

Met deze opdracht wordt de parameter Gedetailleerd gebruikt om gedetailleerde informatie op te halen over alle vooraf gedefinieerde tags in het abonnement. Het gebruik van de gedetailleerde parameter is het equivalent van het gebruik van de parameter Name voor elke tag.

Voorbeeld 4: De volledige set tags voor een abonnement ophalen

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

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

Met deze opdracht wordt de volledige set tags voor het abonnement opgehaald met {subId}.

Voorbeeld 5: De volledige set tags voor een resource ophalen

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

Met deze opdracht haalt u de volledige set tags op de resource op met {resourceId}.

Parameters

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Detailed

Geeft aan dat deze bewerking informatie over tagwaarden toevoegt aan de uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Naam van de vooraf gedefinieerde tag. Get-AzTag haalt standaard basisinformatie op over alle vooraf gedefinieerde tags in het abonnement. Wanneer u de parameter Naam opgeeft, heeft de parameter Gedetailleerd geen effect.

Type:String
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceId

De resource-id voor de getagde entiteit. Een resource, een resourcegroep of een abonnement kan worden getagd.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

SwitchParameter

Uitvoerwaarden

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