Freigeben über


az tag

Tagverwaltung für eine Ressource.

Befehle

Name Beschreibung Typ Status
az tag add-value

Erstellen Sie einen Tagwert.

Kernspeicher Allgemein verfügbar
az tag create

Erstellen Sie Tags für eine bestimmte Ressource.

Kernspeicher Allgemein verfügbar
az tag delete

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

Kernspeicher Allgemein verfügbar
az tag list

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

Kernspeicher Allgemein verfügbar
az tag remove-value

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

Kernspeicher Allgemein verfügbar
az tag update

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

Kernspeicher Allgemein verfügbar

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

--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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

--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

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

--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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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".

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.