Delen via

Get-AzureRmTag

  • Referentie
Module:
AzureRM.Tags

Hiermee worden vooraf gedefinieerde Azure-tags opgehaald.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

Syntax

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

Description

Met de cmdlet Get-AzureRmTag 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 waarvan Get-AzureRMTag 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-AzureRmTag 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-AzureRmTag. Als u resourcegroepen wilt zoeken naar een specifieke tagnaam of naam en waarde, gebruikt u de tagparameter van de cmdlet Get-AzureRMResourceGroup.

Voorbeelden

Voorbeeld 1: Alle vooraf gedefinieerde tags ophalen

PS C:\>Get-AzureRmTag

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

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

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

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.

Parameters

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Detailed

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

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van de tag op die moet worden get. Get-AzureRmTag 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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

Invoerwaarden

String

SwitchParameter

Uitvoerwaarden

PSTag