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.

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

-DefaultProfile

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

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

-Operation

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

Type:TagPatchOperation
Accepted values:Merge, Replace, Delete
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

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

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

-Tag

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

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

-WhatIf

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

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

Eingaben

String

TagPatchOperation

Hashtable

Ausgaben

PSTagResource