az tag

Tagverwaltung für eine Ressource.

Befehle

Name	Beschreibung	Typ	Status
az tag add-value	Erstellen Sie einen Tagwert.	Core	GA
az tag create	Erstellen Sie Tags für eine bestimmte Ressource.	Core	GA
az tag delete	Löschen von Tags für eine bestimmte Ressource.	Core	GA
az tag list	Listet den gesamten Satz von Tags für eine bestimmte Ressource auf.	Core	GA
az tag remove-value	Löscht einen vordefinierten Tagwert für einen vordefinierten Tagnamen.	Core	GA
az tag update	Aktualisieren Sie den Satz von Tags für eine bestimmte Ressource selektiv.	Core	GA

az tag add-value

Erstellen Sie einen Tagwert.

az tag add-value --name
                 --value

Beispiele

Erstellen Sie einen Tagwert.

az tag add-value --name MyTag --value MyValue

Erforderliche Parameter

--name -n

Der Tagname.

--value

Der Tagwert.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az tag create

Erstellen Sie Tags für eine bestimmte Ressource.

Der Az-Tag-Create-Befehl mit einer ID erstellt oder aktualisiert den gesamten Satz von Tags für eine Ressource, Eine Ressourcengruppe oder ein Abonnement. Dieser Vorgang ermöglicht das Hinzufügen oder Ersetzen des gesamten Tags für die angegebene Ressource, Ressourcengruppe oder das Abonnement. Die angegebene Entität kann maximal 50 Tags aufweisen. Bitte beachten Sie: "Tag erstellen" fungiert wie ein "Tag init", daher sind mit diesem Befehl erstellte Tags die einzigen, die nach der Ausführung vorhanden sind.

az tag create [--name]
              [--resource-id]
              [--tags]

Beispiele

Erstellen Sie ein Tag im Abonnement.

az tag create --name MyTag

Erstellen oder aktualisieren Sie den gesamten Satz von Tags in einem Abonnement.

az tag create --resource-id /subscriptions/{subId} --tags Dept=Finance Status=Normal

Erstellen oder aktualisieren Sie den gesamten Satz von Tags in einer Ressourcengruppe.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --tags Dept=Finance Status=Normal

Erstellen oder aktualisieren Sie den gesamten Satz von Tags für eine Ressource.

az tag create --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --tags Dept=Finance Status=Normal

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--name -n

Der Name des zu erstellenden Tags.

--resource-id

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

--tags

Die Tags, die auf die Ressource angewendet werden sollen.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mit „az account set -s “ konfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az tag delete

Löschen von Tags für eine bestimmte Ressource.

Der Befehl "az tag delete" mit einer ID löscht den gesamten Satz von Tags für eine Ressource, eine Ressourcengruppe oder ein Abonnement.

az tag delete [--name]
              [--resource-id]
              [--yes]

Beispiele

Löschen Sie ein vordefiniertes Tag aus dem Abonnement, das keiner Ressource zugeordnet ist oder keine Tagwerte enthält.

az tag delete --name MyTag

Löschen Sie den gesamten Satz von Tags in einem Abonnement.

az tag delete --resource-id /subscriptions/{sub-id}

Löschen Sie den gesamten Satz von Tags in einer Ressourcengruppe.

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Löschen Sie den gesamten Satz von Tags in einer Ressource. (Selbst bei Verwendung von --name zusammen mit --resource-id, um ein einzelnes Tag anzugeben)

az tag delete --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--name -n

Der Name des zu löschenden Tags.

--resource-id

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

--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az tag list

Listet den gesamten Satz von Tags für eine bestimmte Ressource auf.

Der Befehl az tag list with an id lists the entire set of tags on a resource, resource group or subscription.

az tag list [--resource-id]

Beispiele

Listet den gesamten Satz von Tags in einem Abonnement auf.

az tag list --resource-id /subscriptions/{sub-id}

Listet den gesamten Satz von Tags in einer Ressourcengruppe auf.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}

Listet den gesamten Satz von Tags für eine Ressource auf.

az tag list --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName}

Optionale Parameter

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-id

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

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az tag remove-value

Löscht einen vordefinierten Tagwert für einen vordefinierten Tagnamen.

Dieser Vorgang ermöglicht das Löschen eines Werts aus der Liste vordefinierter Werte für einen vorhandenen vordefinierten Tagnamen. Der gelöschte Wert darf nicht als Tagwert für den angegebenen Tagnamen für eine Ressource verwendet werden.

az tag remove-value --name
                    --value

Erforderliche Parameter

--name -n

Der Tagname.

--value

Der Tagwert.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az tag update

Aktualisieren Sie den Satz von Tags für eine bestimmte Ressource selektiv.

Der Az-Tag-Aktualisierungsbefehl mit einer ID aktualisiert selektiv den Satz von Tags für eine Ressource, eine Ressourcengruppe oder ein Abonnement. Mit diesem Vorgang können Tags für die angegebene Ressource, Ressourcengruppe oder das 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.

az tag update --operation {Delete, Merge, Replace}
              --resource-id
              --tags

Beispiele

Aktualisieren Sie den Satz von Tags in einem Abonnement selektiv mit dem Vorgang "Zusammenführen".

az tag update --resource-id /subscriptions/{sub-id} --operation merge --tags key1=value1 key3=value3

Aktualisieren Sie den Satz von Tags in einer Ressourcengruppe selektiv mit "replace"-Vorgang.

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg} --operation replace --tags key1=value1 key3=value3

Aktualisieren Sie den Satz von Tags für eine Ressource selektiv mit "delete"-Vorgang.

az tag update --resource-id /subscriptions/{sub-id}/resourcegroups/{rg}/providers/Microsoft.Compute/virtualMachines/{vmName} --operation delete --tags key1=value1

Erforderliche Parameter

--operation

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

Eigenschaft	Wert
Zulässige Werte:	Delete, Merge, Replace

--resource-id

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

--tags

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

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Output format.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False