New-AzureRmTag
Skapar en fördefinierad Azure-tagg eller lägger till värden i en befintlig tagg.
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
New-AzureRmTag
[-Name] <String>
[[-Value] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Cmdleten New-AzureRmTag skapar en fördefinierad Azure-tagg med ett valfritt fördefinierat värde. Du kan också använda den för att lägga till ytterligare värden i befintliga fördefinierade taggar. Om du vill skapa en fördefinierad tagg anger du ett unikt taggnamn. Om du vill lägga till ett värde i en befintlig fördefinierad tagg anger du namnet på den befintliga taggen och det nya värdet. Den här cmdleten returnerar ett objekt som representerar den nya eller ändrade taggen med dess värden och antalet resurser som den har tillämpats på. Modulen Azure Tags som New-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 tillämpa en fördefinierad tagg på en resurs eller resursgrupp använder du parametern Tagg för cmdleten New-AzureRmTag. Om du vill söka efter resursgrupper med ett angivet taggnamn eller namn och värde använder du parametern Tag i cmdleten Get-AzureRMResourceGroup. Varje tagg har ett namn. Värdena är valfria. En fördefinierad Azure-tagg kan ha flera värden, men när du använder taggen på en resurs eller resursgrupp använder du taggnamnet och bara ett av dess värden. Du kan till exempel skapa en fördefinierad avdelningstagg med ett värde för varje avdelning, till exempel Ekonomi, Personal och IT. När du använder taggen Avdelning på en resurs använder du bara ett fördefinierat värde, till exempel Ekonomi.
Exempel
Exempel 1: Skapa en fördefinierad tagg
PS C:\>New-AzureRmTag -Name "FY2015"
Name: FY2015
Count: 0
Values:
Name Count
========= =====
Finance 0
Det här kommandot skapar en fördefinierad tagg med namnet FY2015. Den här taggen har inga värden. Du kan använda en tagg utan värden för en resurs eller resursgrupp eller använda New-AzureRmTag för att lägga till värden i taggen. Du kan också ange ett värde när du tillämpar taggen på resursen eller resursgruppen.
Exempel 2: Skapa en fördefinierad tagg med ett värde
PS C:\>New-AzureRmTag -Name "Department" -Value "Finance"
Name: Department
Count: 0
Values:
Name Count
========= =====
Finance 0
Det här kommandot skapar en fördefinierad tagg med namnet Avdelning med värdet Ekonomi.
Exempel 3: Lägg till ett värde i en fördefinierad tagg
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
Dessa kommandon skapar en fördefinierad tagg med namnet Avdelning med två värden. Om taggnamnet finns lägger New-AzureRmTag till värdet i den befintliga taggen i stället för att skapa ett nytt.
Exempel 4: Använd en fördefinierad tagg
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
Kommandona i det här exemplet skapar och använder en fördefinierad 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 |
-Name
Anger taggnamnet. Om du vill skapa en ny fördefinierad tagg anger du ett unikt namn. Om du vill lägga till ett värde i en befintlig tagg anger du namnet på den befintliga taggen. Om en befintlig fördefinierad tagg har det angivna namnet lägger New-AzureRmTag till det angivna värdet i taggen med det namnet i stället för att skapa en ny tagg.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Value
Anger ett taggvärde. Fördefinierade taggar kan ha flera värden, men du kan bara ange ett värde i varje kommando. Den här parametern är valfri eftersom taggar kan ha namn utan värden.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |