Dela via

Get-AzureRmTag

  • Referens
Modul:
AzureRM.Tags

Hämtar fördefinierade Azure-taggar.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Description

Cmdleten Get-AzureRmTag hämtar fördefinierade Azure-taggar i din prenumeration. Den här cmdleten returnerar grundläggande information om taggarna eller detaljerad information om taggar och deras värden. Alla utdataobjekt innehåller egenskapen Count som representerar antalet resurser och resursgrupper som taggarna och värdena har tillämpats på. Azure Tags-modulen som Get-AzureRMTag ingår i kan hjälpa dig att hantera fördefinierade Azure-taggar. En Azure-tagg är ett namn/värde-par som du kan använda för att kategorisera dina Azure-resurser och resursgrupper, till exempel efter avdelning eller kostnadsställe, eller för att spåra anteckningar eller kommentarer om resurser och grupper. Du kan definiera och tillämpa taggar i ett enda steg, men med fördefinierade taggar kan du upprätta standard, konsekventa, förutsägbara namn och värden för taggarna i din prenumeration. Om du vill skapa en fördefinierad tagg använder du cmdleten New-AzureRmTag. Om du vill tillämpa en fördefinierad tagg på en resursgrupp använder du parametern Tagg för cmdleten New-AzureRmTag. Om du vill söka efter ett specifikt taggnamn eller namn och värde i resursgrupper använder du parametern Tag i cmdleten Get-AzureRMResourceGroup.

Exempel

Exempel 1: Hämta alla fördefinierade taggar

PS C:\>Get-AzureRmTag

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

Department    5
FY2015        2
CostCenter   20

Det här kommandot hämtar alla fördefinierade taggar i prenumerationen. Egenskapen Count visar hur många gånger taggen har tillämpats på resurser och resursgrupper i prenumerationen.

Exempel 2: Hämta en tagg efter namn

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

Name:   Department
Count:  5
Values: 

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

        Finance       2
        IT            3

Det här kommandot hämtar detaljerad information om taggen Avdelning och dess värden. Egenskapen Count visar hur många gånger taggen och var och en av dess värden har tillämpats på resurser och resursgrupper i prenumerationen.

Exempel 3: Hämta värden för alla taggar

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

Det här kommandot använder parametern Detaljerad för att få detaljerad information om alla fördefinierade taggar i prenumerationen. Att använda parametern Detaljerad motsvarar att använda parametern Namn för varje tagg.

Parametrar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-Detailed

Anger att den här åtgärden lägger till information om taggvärden i utdata.

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

-Name

Anger namnet på taggen som ska hämtas. Som standard hämtar Get-AzureRmTag grundläggande information om alla fördefinierade taggar i prenumerationen. När du anger parametern Namn har parametern Detaljerad ingen effekt.

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

Indata

String

SwitchParameter

Utdata

PSTag