Share via

New-AzTag

  • Referens
Modul:
Az.Resources

Skapar en fördefinierad Azure-tagg eller lägger till värden i en befintlig tagg | Skapar eller uppdaterar hela uppsättningen taggar för en resurs eller prenumeration.

Syntax

New-AzTag
   [-Name] <String>
   [[-Value] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzTag
   [-ResourceId] <String>
   [-Tag] <Hashtable>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

CreatePredefinedTagSet: Cmdleten New-AzTag 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-taggar som New-AzTag 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-AzTag. Om du vill söka efter resursgrupper med ett angivet taggnamn eller namn och värde använder du parametern Tag i cmdleten Get-AzResourceGroup. 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.

CreateByResourceIdParameterSet: Cmdleten New-AzTag med ett ResourceId skapar eller uppdaterar hela uppsättningen taggar på en resurs eller prenumeration. Med den här åtgärden kan du lägga till eller ersätta hela uppsättningen taggar på den angivna resursen eller prenumerationen. Den angivna entiteten kan ha högst 50 taggar.

Exempel

Exempel 1: Skapa en fördefinierad tagg

New-AzTag -Name "FY2015"

Name   ValuesTable Count Values 
----   ----------- ----- ------
FY2015             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-AzTag 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

New-AzTag -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

New-AzTag -Name "Department" -Value "Finance"

Name:   Department
Count:  0
Values: 
        Name        Count
        =========   =====
        Finance     0 
New-AzTag -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-AzTag till värdet i den befintliga taggen i stället för att skapa ett nytt.

Exempel 4: Använd en fördefinierad tagg

New-AzTag -Name "CostCenter" -Value "0001"

Name:   CostCenter
Count:  0
Values: 
        Name        Count
        =========   =====
        0001        0 

Set-AzResourceGroup -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 

Get-AzTag -Name "CostCenter"

Name:   CostCenter
Count:  1
Values: 
        Name        Count
        =========   =====
        0001        1 

Get-AzResourceGroup -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.

Exempel 5: Skapar eller uppdaterar hela uppsättningen taggar i en prenumeration

$Tags = @{"tagKey1"="tagValue1"; "tagKey2"="tagValue2"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $Tags

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             tagKey1  tagValue1
             tagKey2  tagValue2

Det här kommandot skapar eller uppdaterar hela uppsättningen taggar i prenumerationen med {subId}.

Exempel 6: Skapar eller uppdaterar hela uppsättningen taggar på en resurs

$Tags = @{"Dept"="Finance"; "Status"="Normal"}
New-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/testrg/providers/Microsoft.Sql/servers/Server1 -Tag $Tags

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             Dept     Finance
             Status   Normal

Det här kommandot skapar eller uppdaterar hela uppsättningen taggar på resursen med {resourceId}.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

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

-Name

Anger det fördefinierade 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-AzTag 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

-ResourceId

Resursidentifieraren för entiteten som taggas. En resurs, en resursgrupp eller en prenumeration kan vara taggade.

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

-Tag

Taggarna som ska sättas på resursen.

Type:Hashtable
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Value

Anger ett fördefinierat 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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

Hashtable

Utdata

Microsoft.Azure.Commands.ResourceManager.Common.Tags.PSTag | Microsoft.Azure.Commands.Tags.Model.PSTagResource