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: met de cmdlet Get-AzTag worden vooraf gedefinieerde Azure-tags in uw abonnement opgehaald. 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 die Get-AzTag maakt deel uit van het beheer 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. Als u een vooraf gedefinieerde tag wilt maken, gebruikt u de cmdlet New-AzTag. Als u een vooraf gedefinieerde tag wilt toepassen op een resourcegroep, gebruikt u de parameter Tag van de New-AzTag-cmdlet. Als u resourcegroepen wilt zoeken naar een specifieke tagnaam of naam en waarde, gebruikt u de parameter Tag van de Get-AzResourceGroup-cmdlet.

GetByResourceIdParameterSet: De cmdlet Get-AzTag met een ResourceId haalt de hele 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

Deze opdracht maakt gebruik van de parameter Gedetailleerde voor gedetailleerde informatie over alle vooraf gedefinieerde tags in het abonnement. Het gebruik van de parameter Gedetailleerde 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. Standaard krijgt Get-AzTag- basisinformatie over alle vooraf gedefinieerde tags in het abonnement. Wanneer u de parameter Name opgeeft, heeft de parameter Gedetailleerde 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