Update-AzTag

  • Referenz
Modul:
Az.Resources

Aktualisiert selektiv den Satz von Tags für eine Ressource oder ein Abonnement.

Syntax

Update-AzTag
      [-ResourceId] <String>
      [-Tag] <Hashtable>
      [-Operation] <TagPatchOperation>
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Update-AzTag mit einer ResourceId aktualisiert selektiv den Satz von Tags für eine Ressource oder ein Abonnement. Mit diesem Vorgang können Tags für die angegebene Ressource oder das angegebene Abonnement ersetzt, zusammengeführt oder selektiv gelöscht werden. Die angegebene Entität kann maximal 50 Tags am Ende des Vorgangs aufweisen. Die Option "Ersetzen" ersetzt den gesamten Satz vorhandener Tags durch einen neuen Satz. Die Option "Zusammenführen" ermöglicht das Hinzufügen von Tags mit neuen Namen und das Aktualisieren der Werte von Tags mit vorhandenen Namen. Die Option "Löschen" ermöglicht das selektive Löschen von Tags basierend auf bestimmten Namen oder Namen/Wert-Paaren.

Beispiele

Beispiel 1: Aktualisiert selektiv den Satz von Tags in einem Abonnement mit "Zusammenführen"-Vorgang.

$mergedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $mergedTags -Operation Merge

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key2     value2
             key3     value3

Mit diesem Befehl wird der Satz von Tags für das Abonnement mit "xx-xxxx-xxxx-xxxx-xxxx-xx" zusammengeführt.

Beispiel 2: Aktualisiert selektiv den Satz von Tags in einem Abonnement mit "Replace"-Vorgang.

$replacedTags = @{"key1"="value1"; "key3"="value3";}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $replacedTags -Operation Replace

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key1     value1
             key3     value3

Mit diesem Befehl wird der Satz von Tags für das Abonnement durch "xx-xxxx-xxxx-xxxx-xxxx-xxxxxx" ersetzt.

Beispiel 3: Aktualisiert selektiv den Satz von Tags in einem Abonnement mit dem Vorgang "Löschen".

$deletedTags = @{"key1"="value1"}
Update-AzTag -ResourceId /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -Tag $deletedTags -Operation Delete

Id         : {Id}
Name       : {Name}
Type       : {Type}
Properties :
             Name     Value
             =======  =========
             key3     value3

Mit diesem Befehl wird der Satz von Tags für das Abonnement mit "xx-xxxx-xxxx-xxxx-xxxx-xxxx" gelöscht.

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

-Operation

Der Aktualisierungsvorgang. Optionen sind "Zusammenführen", "Ersetzen" und "Löschen".

Typ:TagPatchOperation
Zulässige Werte:Merge, Replace, Delete
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceId

Der Ressourcenbezeichner für die markierte Entität. 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

Der Satz von Tags, die für die Aktualisierung verwendet werden sollen.

Typ:Hashtable
Position:1
Standardwert:None
Erforderlich:True
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

TagPatchOperation

Hashtable

Ausgaben

PSTagResource