az maps account

  • Referenz

Verwalten von Azure Karten-Konten.

Befehle

Name Beschreibung Typ Status
az maps account create

Erstellen Sie ein Karten-Konto. Ein Karten-Konto enthält die Schlüssel, die den Zugriff auf die Karten REST-APIs ermöglichen.

 Kernspeicher Allgemein verfügbar
az maps account delete

Löscht ein Maps-Konto.

 Kernspeicher Allgemein verfügbar
az maps account keys

Verwalten von Azure Karten-Kontoschlüsseln.

 Kernspeicher Allgemein verfügbar
az maps account keys list

Rufen Sie die Tasten ab, die mit den Karten-APIs verwendet werden sollen. Ein Schlüssel wird verwendet, um den Zugriff auf die Karten REST-APIs zu authentifizieren und zu autorisieren. Es ist jeweils nur ein Schlüssel erforderlich; zwei werden gegeben, um eine nahtlose Schlüsselregeneration zu ermöglichen.

 Kernspeicher Allgemein verfügbar
az maps account keys renew

Generieren Sie entweder den primären oder sekundären Schlüssel für die Verwendung mit den Karten-APIs. Die alte Taste funktioniert nicht mehr sofort.

 Kernspeicher Allgemein verfügbar
az maps account list

Alle Kartenkonten in einem Abonnement oder in einer Ressourcengruppe anzeigen.

 Kernspeicher Allgemein verfügbar
az maps account show

Zeigen Sie die Details eines Kartenkontos an.

 Kernspeicher Allgemein verfügbar
az maps account update

Aktualisiert ein Karten-Konto. Nach der Erstellung können nur eine Teilmenge der Parameter aktualisiert werden, z. B. Sku, Tags, Eigenschaften.

 Kernspeicher Allgemein verfügbar

az maps account create

Bearbeiten

Erstellen Sie ein Karten-Konto. Ein Karten-Konto enthält die Schlüssel, die den Zugriff auf die Karten REST-APIs ermöglichen.

az maps account create --account-name
                       --resource-group
                       --sku {G2, S0, S1}
                       [--accept-tos]
                       [--disable-local-auth {false, true}]
                       [--kind {Gen1, Gen2}]
                       [--linked-resources]
                       [--tags]
                       [--type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}]
                       [--user-identities]

Beispiele

Konto mit verwalteten Identitäten erstellen

az maps account create --type "SystemAssigned, UserAssigned" --user-identities "{\"/subscriptions/21a9967a-e8a9-4656-a70b-96ff1c4d05a0/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName\":{}}" --kind "Gen2" --disable-local-auth false --linked-resources id="/subscriptions/21a9967a-e8a9-4656-a70b-96ff1c4d05a0/resourceGroups/myResourceGroup/providers/Microsoft.Storage/accounts/mystorageacc" unique-name="myBatchStorageAccount" --linked-resources id="/subscriptions/21a9967a-e8a9-4656-a70b-96ff1c4d05a0/resourceGroups/myResourceGroup/providers/Microsoft.Storage/accounts/mystorageacc" unique-name="myBlobDataSource" --tags test="true" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Erstellen eines Gen1-Kontos

az maps account create --kind "Gen1" --disable-local-auth false --tags test="true" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Gen2-Konto erstellen

az maps account create --kind "Gen2" --disable-local-auth true --tags test="true" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Erforderliche Parameter

--account-name --name -n

Der Name des Kartenkontos.

--resource-group -g

Ressourcengruppenname

--sku -s

Der Name der SKU im Standardformat (z. B. S0).

Zulässige Werte: G2, S0, S1

Optionale Parameter

--accept-tos

Sie müssen den Lizenz- und Datenschutzbestimmungen zustimmen, um ein Konto zu erstellen.

--disable-local-auth

Ermöglicht das Umschalten von Funktionen in Azure-Richtlinie, um die Unterstützung für die lokale Authentifizierung von Azure Karten zu deaktivieren. Dadurch wird die Authentifizierung mit freigegebenen Schlüsseln bei jeder Verwendung deaktiviert.

Zulässige Werte: false, true
--kind

Dient zum Abrufen oder Festlegen der Kind-Eigenschaft.

Zulässige Werte: Gen1, Gen2
--linked-resources

Legt die Ressourcen fest, die für verwaltete Identitäten basierende Vorgänge für die Zuordnungskontoressource verwendet werden sollen.

Verwendung: --linked-resources unique-name=XX id=XX

eindeutiger Name: Erforderlich. Ein bereitgestellter Name, der die verknüpfte Ressource eindeutig identifiziert. id: Erforderlich. ARM-Ressourcen-ID im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}'.

Mehrere Aktionen können mithilfe von mehr als einem --linked-resources-Argument angegeben werden.

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--type

Der Identitätstyp.

Zulässige Werte: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned
--user-identities

Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Erwarteter Wert: json-string/@json-file.

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 maps account delete

Bearbeiten

Löscht ein Maps-Konto.

az maps account delete [--account-name]
                       [--ids]
                       [--resource-group]
                       [--subscription]

Beispiele

DeleteAccount

az maps account delete --name "myMapsAccount" --resource-group "myResourceGroup"

Optionale Parameter

--account-name --name -n

Der Name des Kartenkontos.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

Ressourcengruppenname

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

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 maps account list

Bearbeiten

Alle Kartenkonten in einem Abonnement oder in einer Ressourcengruppe anzeigen.

az maps account list [--resource-group]

Optionale Parameter

--resource-group -g

Ressourcengruppenname

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 maps account show

Bearbeiten

Zeigen Sie die Details eines Kartenkontos an.

az maps account show [--account-name]
                     [--ids]
                     [--resource-group]
                     [--subscription]

Beispiele

Zeigen Sie die Details eines Kartenkontos an. (automatisch generiert)

az maps account show --name MyMapsAccount --resource-group MyResourceGroup

Optionale Parameter

--account-name --name -n

Der Name des Kartenkontos.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

Ressourcengruppenname

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

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 maps account update

Bearbeiten

Aktualisiert ein Karten-Konto. Nach der Erstellung können nur eine Teilmenge der Parameter aktualisiert werden, z. B. Sku, Tags, Eigenschaften.

az maps account update --sku {G2, S0, S1}
                       [--account-name]
                       [--disable-local-auth {false, true}]
                       [--ids]
                       [--kind {Gen1, Gen2}]
                       [--linked-resources]
                       [--resource-group]
                       [--subscription]
                       [--tags]
                       [--type {None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned}]
                       [--user-identities]

Beispiele

Kontoverwaltete Identitäten aktualisieren

az maps account update --type "SystemAssigned, UserAssigned" --user-identities "{\"/subscriptions/21a9967a-e8a9-4656-a70b-96ff1c4d05a0/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName\":{}}" --kind "Gen2" --linked-resources id="/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}" unique-name="myBatchStorageAccount" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S1"

Kontotags aktualisieren

az maps account update --tags specialTag="true" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Auf Gen1-Konto aktualisieren

az maps account update --kind "Gen1" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Auf Gen2-Konto aktualisieren

az maps account update --kind "Gen2" --account-name "myMapsAccount" --resource-group "myResourceGroup" --sku "S0"

Erforderliche Parameter

--sku -s

Der Name der SKU im Standardformat (z. B. S0).

Zulässige Werte: G2, S0, S1

Optionale Parameter

--account-name --name -n

Der Name des Kartenkontos.

--disable-local-auth

Ermöglicht das Umschalten von Funktionen in Azure-Richtlinie, um die Unterstützung für die lokale Authentifizierung von Azure Karten zu deaktivieren. Dadurch wird die Authentifizierung mit freigegebenen Schlüsseln bei jeder Verwendung deaktiviert.

Zulässige Werte: false, true
--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--kind

Dient zum Abrufen oder Festlegen der Kind-Eigenschaft.

Zulässige Werte: Gen1, Gen2
--linked-resources

Legt die Ressourcen fest, die für verwaltete Identitäten basierende Vorgänge für die Zuordnungskontoressource verwendet werden sollen.

Verwendung: --linked-resources unique-name=XX id=XX

eindeutiger Name: Erforderlich. Ein bereitgestellter Name, der die verknüpfte Ressource eindeutig identifiziert. id: Erforderlich. ARM-Ressourcen-ID im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/accounts/{storageName}'.

Mehrere Aktionen können mithilfe von mehr als einem --linked-resources-Argument angegeben werden.

--resource-group -g

Ressourcengruppenname

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

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--type

Der Identitätstyp.

Zulässige Werte: None, SystemAssigned, SystemAssigned, UserAssigned, UserAssigned
--user-identities

Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Erwarteter Wert: json-string/@json-file.

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.