New-AzTag

Tworzy wstępnie zdefiniowany tag platformy Azure lub dodaje wartości do istniejącego tagu | Tworzy lub aktualizuje cały zestaw tagów w zasobie lub subskrypcji.

Składnia

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

Opis

CreatePredefinedTagSet: polecenie cmdlet New-AzTag tworzy wstępnie zdefiniowany tag platformy Azure z opcjonalną wstępnie zdefiniowaną wartością. Można go również użyć do dodawania dodatkowych wartości do istniejących wstępnie zdefiniowanych tagów. Aby utworzyć wstępnie zdefiniowany tag, wprowadź unikatową nazwę tagu. Aby dodać wartość do istniejącego wstępnie zdefiniowanego tagu, określ nazwę istniejącego tagu i nową wartość. To polecenie cmdlet zwraca obiekt reprezentujący nowy lub zmodyfikowany tag z jego wartościami i liczbą zasobów, do których została zastosowana. Moduł Tagi platformy Azure, który jest częścią polecenia New-AzTag , może pomóc w zarządzaniu wstępnie zdefiniowanymi tagami platformy Azure. Tag platformy Azure to para nazwa-wartość, której można użyć do kategoryzowania zasobów i grup zasobów platformy Azure, takich jak dział lub centrum kosztów, albo śledzenie notatek lub komentarzy dotyczących zasobów i grup. Tagi można definiować i stosować w jednym kroku, ale wstępnie zdefiniowane tagi umożliwiają ustanowienie standardowych, spójnych, przewidywalnych nazw i wartości tagów w subskrypcji. Aby zastosować wstępnie zdefiniowany tag do zasobu lub grupy zasobów, użyj parametru Tag polecenia cmdlet New-AzTag. Aby wyszukać grupy zasobów o określonej nazwie tagu lub nazwie i wartości, użyj parametru Tag polecenia cmdlet Get-AzResourceGroup. Każdy tag ma nazwę. Wartości są opcjonalne. Wstępnie zdefiniowany tag platformy Azure może mieć wiele wartości, ale po zastosowaniu tagu do zasobu lub grupy zasobów zastosujesz nazwę tagu i tylko jedną z jego wartości. Można na przykład utworzyć wstępnie zdefiniowany tag Dział z wartością dla każdego działu, takiego jak finanse, zasoby ludzkie i dział IT. Po zastosowaniu tagu Dział do zasobu zastosujesz tylko jedną wstępnie zdefiniowaną wartość, taką jak Finanse.

CreateByResourceIdParameterSet: polecenie cmdlet New-AzTag z identyfikatorem ResourceId tworzy lub aktualizuje cały zestaw tagów w zasobie lub subskrypcji. Ta operacja umożliwia dodawanie lub zastępowanie całego zestawu tagów w określonym zasobie lub subskrypcji. Określona jednostka może mieć maksymalnie 50 tagów.

Przykłady

Przykład 1. Tworzenie wstępnie zdefiniowanego tagu

New-AzTag -Name "FY2015"

Name   ValuesTable Count Values 
----   ----------- ----- ------
FY2015             0     {}

To polecenie tworzy wstępnie zdefiniowany tag o nazwie FY2015. Ten tag nie ma wartości. Możesz zastosować tag bez wartości do zasobu lub grupy zasobów lub użyć polecenia New-AzTag , aby dodać wartości do tagu. Można również określić wartość podczas stosowania tagu do zasobu lub grupy zasobów.

Przykład 2. Tworzenie wstępnie zdefiniowanego tagu z wartością

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

Name:   Department
Count:  0
Values: 

        Name        Count
        =========   =====
        Finance     0

To polecenie tworzy wstępnie zdefiniowany tag o nazwie Dział z wartością Finanse.

Przykład 3. Dodawanie wartości do wstępnie zdefiniowanego tagu

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

Te polecenia tworzą wstępnie zdefiniowany tag o nazwie Dział z dwiema wartościami. Jeśli nazwa tagu istnieje, new-AzTag dodaje wartość do istniejącego tagu zamiast tworzenia nowego.

Przykład 4. Używanie wstępnie zdefiniowanego tagu

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

Polecenia w tym przykładzie tworzą i używają wstępnie zdefiniowanego tagu.

Przykład 5. Tworzy lub aktualizuje cały zestaw tagów w subskrypcji

$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

To polecenie tworzy lub aktualizuje cały zestaw tagów w subskrypcji przy użyciu {subId}.

Przykład 6. Tworzy lub aktualizuje cały zestaw tagów w zasobie

$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

To polecenie tworzy lub aktualizuje cały zestaw tagów w zasobie za pomocą elementu {resourceId}.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-Name

Określa wstępnie zdefiniowaną nazwę tagu. Aby utworzyć nowy wstępnie zdefiniowany tag, wprowadź unikatową nazwę. Aby dodać wartość do istniejącego tagu, wprowadź nazwę istniejącego tagu. Jeśli istniejący wstępnie zdefiniowany tag ma określoną nazwę, new-AzTag dodaje określoną wartość, jeśli istnieje, do tagu o tej nazwie zamiast tworzenia nowego tagu.

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

-ResourceId

Identyfikator zasobu dla jednostki, która jest oznaczona. Zasób, grupa zasobów lub subskrypcja może zostać otagowany.

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

-Tag

Tagi do umieszczenia w zasobie.

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

-Value

Określa wstępnie zdefiniowaną wartość tagu. Wstępnie zdefiniowane tagi mogą mieć wiele wartości, ale w każdym poleceniu można wprowadzić tylko jedną wartość. Ten parametr jest opcjonalny, ponieważ tagi mogą mieć nazwy bez wartości.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

Hashtable

Dane wyjściowe

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