Get-AzureRmTag
Získá předdefinované značky Azure.
Upozorňující
Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.
I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.
Syntax
Get-AzureRmTag
[[-Name] <String>]
[-Detailed]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Rutina Get-AzureRmTag získá předdefinované značky Azure ve vašem předplatném. Tato rutina vrátí základní informace o značkách nebo podrobných informacích o značkách a jejich hodnotách. Všechny výstupní objekty zahrnují vlastnost Count, která představuje počet prostředků a skupin prostředků, na které byly použity značky a hodnoty. Modul Azure Tags, který Get-AzureRMTag představuje součást, vám může pomoct se správou předdefinovaných značek Azure. Značka Azure je pár název-hodnota, který můžete použít ke kategorizaci prostředků a skupin prostředků Azure, jako jsou oddělení nebo nákladové středisko, nebo ke sledování poznámek nebo komentářů k prostředkům a skupinám. Značky můžete definovat a používat v jednom kroku, ale předdefinované značky umožňují vytvořit standardní, konzistentní, předvídatelné názvy a hodnoty pro značky ve vašem předplatném. K vytvoření předdefinované značky použijte rutinu New-AzureRmTag. Pokud chcete použít předdefinovanou značku na skupinu prostředků, použijte parametr Tag rutiny New-AzureRmTag. Pokud chcete prohledat skupiny prostředků konkrétní název značky nebo název a hodnotu, použijte parametr Tag rutiny Get-AzureRMResourceGroup.
Příklady
Příklad 1: Získání všech předdefinovaných značek
PS C:\>Get-AzureRmTag
Name Count
======== =====
Department 5
FY2015 2
CostCenter 20
Tento příkaz získá všechny předdefinované značky v předplatném. Vlastnost Count ukazuje, kolikrát byla značka použita pro prostředky a skupiny prostředků v předplatném.
Příklad 2: Získání značky podle názvu
PS C:\>Get-AzureRmTag -Name "Department"
Name: Department
Count: 5
Values:
Name Count
========== =====
Finance 2
IT 3
Tento příkaz získá podrobné informace o značce Oddělení a jejích hodnotách. Vlastnost Count zobrazuje, kolikrát byla značka a každá z jejích hodnot použita pro prostředky a skupiny prostředků v předplatném.
Příklad 3: Získání hodnot všech značek
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
Tento příkaz používá podrobný parametr k získání podrobných informací o všech předdefinovaných značkách v předplatném. Použití podrobného parametru je ekvivalentem použití parametru Name pro každou značku.
Parametry
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Type: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Detailed
Označuje, že tato operace přidá do výstupu informace o hodnotách značek.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Určuje název značky, která se má získat. Get-AzureRmTag ve výchozím nastavení získá základní informace o všech předdefinovaných značkách v předplatném. Když zadáte parametr Name , podrobný parametr nemá žádný vliv.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |