New-AzTag

Syntax

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

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

Beschreibung

CreatePredefinedTagSet: Das Cmdlet New-AzTag erstellt ein vordefiniertes Azure-Tag mit einem optionalen vordefinierten Wert. Sie können es auch verwenden, um zusätzliche Werte zu vorhandenen vordefinierten Tags hinzuzufügen. Um ein vordefiniertes Tag zu erstellen, geben Sie einen eindeutigen Tagnamen ein. Wenn Sie einem vorhandenen vordefinierten Tag einen Wert hinzufügen möchten, geben Sie den Namen des vorhandenen Tags und den neuen Wert an. Dieses Cmdlet gibt ein Objekt zurück, das das neue oder geänderte Tag mit seinen Werten und der Anzahl der Ressourcen darstellt, auf die es angewendet wurde. Das Azure Tags-Modul, zu dem New-AzTag gehört, kann Ihnen helfen, vordefinierte Azure-Tags zu verwalten. Ein Azure-Tag ist ein Name-Wert-Paar, mit dem Sie Ihre Azure-Ressourcen und -Ressourcengruppen kategorisieren können, z. B. nach Abteilung oder Kostenstelle, oder um Notizen oder Kommentare zu den Ressourcen und Gruppen nachzuverfolgen. Sie können Tags in einem einzigen Schritt definieren und anwenden, aber mit vordefinierten Tags können Sie Standard-, konsistente, vorhersagbare Namen und Werte für die Tags in Ihrem Abonnement einrichten. Um ein vordefiniertes Tag auf eine Ressource oder Ressourcengruppe anzuwenden, verwenden Sie den Tag-Parameter des New-AzTag-Cmdlets. Verwenden Sie den Tag-Parameter des Cmdlets "Get-AzResourceGroup", um nach Ressourcengruppen mit einem angegebenen Tagnamen oder -wert zu suchen. Jedes Tag hat einen Namen. Die Werte sind optional. Ein vordefiniertes Azure-Tag kann mehrere Werte aufweisen, aber wenn Sie das Tag auf eine Ressource oder Ressourcengruppe anwenden, wenden Sie den Tagnamen und nur einen der zugehörigen Werte an. Sie können beispielsweise ein vordefiniertes Abteilungstag mit einem Wert für jede Abteilung erstellen, z. B. Finanzen, Personalwesen und IT. Wenn Sie das Department-Tag auf eine Ressource anwenden, wenden Sie nur einen vordefinierten Wert an, z. B. "Finance".

CreateByResourceIdParameterSet: Das New-AzTag-Cmdlet mit einer ResourceId erstellt oder aktualisiert den gesamten Satz von Tags für eine Ressource oder ein Abonnement. Mit diesem Vorgang können Sie den gesamten Satz von Tags für die angegebene Ressource oder das angegebene Abonnement hinzufügen oder ersetzen. Die angegebene Entität kann maximal 50 Tags aufweisen.

Beispiele

Beispiel 1: Erstellen eines vordefinierten Tags

New-AzTag -Name "FY2015"

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

Mit diesem Befehl wird ein vordefiniertes Tag namens "FY2015" erstellt. Dieses Tag hat keine Werte. Sie können ein Tag ohne Werte auf eine Ressource oder Ressourcengruppe anwenden oder new-AzTag verwenden, um dem Tag Werte hinzuzufügen. Sie können auch einen Wert angeben, wenn Sie das Tag auf die Ressource oder Ressourcengruppe anwenden.

Beispiel 2: Erstellen eines vordefinierten Tags mit einem Wert

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

Name:   Department
Count:  0
Values: 

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

Mit diesem Befehl wird ein vordefiniertes Tag namens "Abteilung" mit dem Wert "Finance" erstellt.

Beispiel 3: Hinzufügen eines Werts zu einem vordefinierten Tag

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

Diese Befehle erstellen ein vordefiniertes Tag namens "Abteilung" mit zwei Werten. Wenn der Tagname vorhanden ist, fügt New-AzTag dem vorhandenen Tag den Wert hinzu, anstatt eine neue zu erstellen.

Beispiel 4: Verwenden eines vordefinierten Tags

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

Die Befehle in diesem Beispiel erstellen und verwenden ein vordefiniertes Tag.

Beispiel 5: Erstellt oder aktualisiert den gesamten Satz von Tags in einem Abonnement.

$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

Mit diesem Befehl wird der gesamte Satz von Tags für das Abonnement mit {subId} erstellt oder aktualisiert.

Beispiel 6: Erstellt oder aktualisiert den gesamten Satz von Tags für eine Ressource.

$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

Mit diesem Befehl wird der gesamte Satz von Tags für die Ressource mit {resourceId} erstellt oder aktualisiert.

Parameter

-Confirm

-DefaultProfile

-Name

-ResourceId

-Tag

-Value

-WhatIf

Eingaben

String

Hashtable

Ausgaben

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

Ähnliche Themen

• Get-AzTag
• Remove-AzTag
• Update-AzTag