New-AzureRmTag
Vytvoří předdefinovanou značku Azure nebo přidá hodnoty do existující značky.
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
New-AzureRmTag
[-Name] <String>
[[-Value] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Rutina New-AzureRmTag vytvoří předdefinovanou značku Azure s volitelnou předdefinovanou hodnotou. Můžete ho také použít k přidání dalších hodnot do existujících předdefinovaných značek. Pokud chcete vytvořit předdefinovanou značku, zadejte jedinečný název značky. Pokud chcete přidat hodnotu k existující předdefinované značce, zadejte název existující značky a novou hodnotu. Tato rutina vrátí objekt, který představuje novou nebo upravenou značku se svými hodnotami a počtem prostředků, na které byla použita. Modul Značky Azure, který je součástí New-AzureRmTag, 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. Pokud chcete použít předdefinovanou značku pro prostředek nebo skupinu prostředků, použijte parametr Tag rutiny New-AzureRmTag. Pokud chcete vyhledat skupiny prostředků se zadaným názvem značky nebo názvem a hodnotou, použijte parametr Tag rutiny Get-AzureRMResourceGroup. Každá značka má název. Hodnoty jsou volitelné. Předdefinovaná značka Azure může mít více hodnot, ale když značku použijete u prostředku nebo skupiny prostředků, použijete název značky a jenom jednu z jejích hodnot. Můžete například vytvořit předdefinovanou značku oddělení s hodnotou pro každé oddělení, například Finance, Lidské zdroje a IT. Když u prostředku použijete značku Oddělení, použijete pouze jednu předdefinovanou hodnotu, například Finance.
Příklady
Příklad 1: Vytvoření předdefinované značky
PS C:\>New-AzureRmTag -Name "FY2015"
Name: FY2015
Count: 0
Values:
Name Count
========= =====
Finance 0
Tento příkaz vytvoří předdefinovanou značku s názvem FY2015. Tato značka nemá žádné hodnoty. Značku bez hodnot můžete použít u prostředku nebo skupiny prostředků nebo pomocí New-AzureRmTag přidat do značky hodnoty. Hodnotu můžete zadat také při použití značky na prostředek nebo skupinu prostředků.
Příklad 2: Vytvoření předdefinované značky s hodnotou
PS C:\>New-AzureRmTag -Name "Department" -Value "Finance"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
Tento příkaz vytvoří předdefinovanou značku s názvem Oddělení s hodnotou Finance.
Příklad 3: Přidání hodnoty k předdefinované značce
PS C:\>New-AzureRmTag -Name "Department" -Value "Finance"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
PS C:\>New-AzureRmTag -Name "Department" -Value "IT"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
IT 0
Tyto příkazy vytvoří předdefinovanou značku s názvem Oddělení se dvěma hodnotami. Pokud název značky existuje, New-AzureRmTag přidá hodnotu k existující značce místo vytvoření nové značky.
Příklad 4: Použití předdefinované značky
PS C:\>New-AzureRmTag -Name "CostCenter" -Value "0001"
Name: CostCenter
Count: 0
Values:
Name Count
========= =====
0001 0
PS C:\>Set-AzureRmResourceGroup -Name "EngineerBlog" -Tag @{Name="CostCenter";Value="0001"}
Name: EngineerBlog
Location: East US
Resources:
Name Type Location
=============== ======================= ========
EngineerBlog Microsoft.Web/sites West US
EngSvr01 Microsoft.Sql/servers West US
EngDB02 Microsoft.Sql/databases West US
Tags:
Name Value
========== =====
CostCenter 0001
PS C:\>Get-AzureRmTag -Name "CostCenter"
Name: CostCenter
Count: 1
Values:
Name Count
========= =====
0001 1
PS C:\>Get-AzureRmResourceGroup -Tag @{Name="CostCenter"}
Name: EngineerBlog
Location: East US
Resources:
Name Type Location
=============== ======================= ========
EngineerBlog Microsoft.Web/sites West US
EngSvr01 Microsoft.Sql/servers West US
EngDB02 Microsoft.Sql/databases West US
Tags:
Name Value
========== =====
CostCenter 0001
Příkazy v tomto příkladu vytvoří a použijí předdefinovanou 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 |
-Name
Určuje název značky. Pokud chcete vytvořit novou předdefinovanou značku, zadejte jedinečný název. Pokud chcete přidat hodnotu k existující značce, zadejte název existující značky. Pokud má existující předdefinovaná značka zadaný název, New-AzureRmTag přidá zadanou hodnotu ( pokud existuje) ke značce s tímto názvem místo vytvoření nové značky.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Value
Určuje hodnotu značky. Předdefinované značky můžou mít více hodnot, ale v každém příkazu můžete zadat jenom jednu hodnotu. Tento parametr je nepovinný, protože značky můžou mít názvy bez hodnot.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |