Freigeben über


New-AzTag

Erstellt ein vordefiniertes Azure-Tag oder fügt einem vorhandenen Tag Werte hinzu | Erstellt oder aktualisiert den gesamten Satz von Tags für eine Ressource oder ein Abonnement.

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

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den vordefinierten Tagnamen an. Um ein neues vordefiniertes Tag zu erstellen, geben Sie einen eindeutigen Namen ein. Um einem vorhandenen Tag einen Wert hinzuzufügen, geben Sie den Namen des vorhandenen Tags ein. Wenn ein vorhandenes vordefiniertes Tag den angegebenen Namen hat, fügt New-AzTag den angegebenen Wert (falls vorhanden) dem Tag mit diesem Namen hinzu, anstatt ein neues Tag zu erstellen.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceId

Der Ressourcenbezeichner für die Entität, die markiert wird. Eine Ressource, eine Ressourcengruppe oder ein Abonnement kann markiert werden.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Tag

Die Tags, die für die Ressource platziert werden sollen.

Typ:Hashtable
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Value

Gibt einen vordefinierten Tagwert an. Vordefinierte Tags können mehrere Werte enthalten, sie können jedoch nur einen Wert in jeden Befehl eingeben. Dieser Parameter ist optional, da Tags Namen ohne Werte enthalten können.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Hashtable

Ausgaben

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