Get-AzureRmTag
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.
Typ: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
standardvärde: | None |
Obligatorisk: | 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.
Typ: | SwitchParameter |
Position: | Named |
standardvärde: | None |
Obligatorisk: | 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.
Typ: | String |
Position: | 0 |
standardvärde: | None |
Obligatorisk: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |