Freigeben über


az iot du account

Hinweis

Diese Referenz ist Teil der Azure-iot-Erweiterung für die Azure CLI (Version 2.46.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az iot du account-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Geräteaktualisierungskontoverwaltung.

Befehle

Name Beschreibung Typ Status
az iot du account create

Erstellen Sie ein Geräteaktualisierungskonto.

Erweiterung Allgemein verfügbar
az iot du account delete

Löschen eines Geräteaktualisierungskontos.

Erweiterung Allgemein verfügbar
az iot du account list

Alle Geräteaktualisierungskonten in einem Abonnement oder einer Ressourcengruppe auflisten.

Erweiterung Allgemein verfügbar
az iot du account private-endpoint-connection

Geräteaktualisierungskonto für private Endpunktverbindungsverwaltung.

Erweiterung Allgemein verfügbar
az iot du account private-endpoint-connection delete

Löschen Einer privaten Endpunktverbindung, die einem Geräteaktualisierungskonto zugeordnet ist.

Erweiterung Allgemein verfügbar
az iot du account private-endpoint-connection list

Listet private Endpunktverbindungen auf, die einem Geräteaktualisierungskonto zugeordnet sind.

Erweiterung Allgemein verfügbar
az iot du account private-endpoint-connection set

Legen Sie den Status einer privaten Endpunktverbindung fest, die einem Geräteaktualisierungskonto zugeordnet ist.

Erweiterung Allgemein verfügbar
az iot du account private-endpoint-connection show

Zeigt eine private Endpunktverbindung an, die einem Geräteaktualisierungskonto zugeordnet ist.

Erweiterung Allgemein verfügbar
az iot du account private-link-resource

Ressourcenverwaltung des Geräteaktualisierungskontos für private Verknüpfungen.

Erweiterung Allgemein verfügbar
az iot du account private-link-resource list

Auflisten privater Linkressourcen, die vom Konto unterstützt werden.

Erweiterung Allgemein verfügbar
az iot du account show

Zeigen Sie die Details eines Geräteaktualisierungskontos an.

Erweiterung Allgemein verfügbar
az iot du account update

Aktualisieren eines Geräteaktualisierungskontos.

Erweiterung Allgemein verfügbar
az iot du account wait

Blockieren, bis ein gewünschter Kontoressourcenstatus erfüllt wurde.

Erweiterung Allgemein verfügbar

az iot du account create

Erstellen Sie ein Geräteaktualisierungskonto.

Dieser Befehl kann auch verwendet werden, um den Status eines vorhandenen Kontos zu aktualisieren.

az iot du account create --account
                         --resource-group
                         [--assign-identity]
                         [--location]
                         [--no-wait]
                         [--pna {Disabled, Enabled}]
                         [--role]
                         [--scopes]
                         [--sku {Free, Standard}]
                         [--tags]

Beispiele

Erstellen Sie ein Geräteaktualisierungskonto in der Zielressourcengruppe mithilfe des Speicherorts der Ressourcengruppe.

az iot du account create -n {account_name} -g {resouce_group}

Erstellen Sie ein kostenloses Sku-Geräteaktualisierungskonto in der Zielressourcengruppe mit angegebenen Speicherorten und Tags ohne Blockierung.

az iot du account create -n {account_name} -g {resouce_group} -l westus --tags a=b c=d --sku Free --no-wait

Erstellen Sie ein Geräteaktualisierungskonto in der Zielressourcengruppe mit einer vom System verwalteten Identität.

az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system]

Erstellen Sie ein Geräteaktualisierungskonto in der Zielressourcengruppe mit einer vom System verwalteten Identität, und weisen Sie die Systemidentität einem einzelnen Bereich mit der Rolle "Mitwirkender" zu.

az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system] --scopes /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount

Erstellen Sie ein Geräteaktualisierungskonto in der Zielressourcengruppe mit system- und vom Benutzer zugewiesenen verwalteten Identitäten, und weisen Sie die Systemidentität einem oder mehreren Bereichen (durch Leerzeichen getrennt) mit einer benutzerdefinierten angegebenen Rolle zu.

az iot du account create -n {account_name} -g {resouce_group} --assign-identity [system] /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourcegroups/ProResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myIdentity --scopes /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount1
  /subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.Storage/storageAccounts/myStorageAccount2
--role "Storage Blob Data Contributor"

Erforderliche Parameter

--account -n

Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>.

--resource-group -g

Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name> konfigurieren.

Optionale Parameter

--assign-identity

Akzeptiert System- oder Benutzeridentitäten, die durch Leerzeichen getrennt sind. Verwenden Sie "[System]", um auf die vom System zugewiesene Identität oder eine Ressourcen-ID zu verweisen, um auf eine vom Benutzer zugewiesene Identität zu verweisen. Sehen Sie sich die Hilfe zu Beispielen an.

--location -l

Standort des Geräteaktualisierungskontos. Wenn kein Speicherort angegeben wird, wird der Speicherort der Ressourcengruppe verwendet. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<name> konfigurieren.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--pna --public-network-access

Gibt an, ob über ein öffentliches Netzwerk auf das Geräteupdatekonto zugegriffen werden kann.

Zulässige Werte: Disabled, Enabled
Standardwert: Enabled
--role

Rollenname oder ID, über die die vom System zugewiesene Identität verfügt.

Standardwert: Contributor
--scopes

Bereichstrennte Bereiche, auf die die vom System zugewiesene Identität zugreifen kann. Kann nicht mit "--no-wait" verwendet werden.

--sku

Geräteaktualisierungskonto-SKU.

Zulässige Werte: Free, Standard
Standardwert: Standard
--tags

Ressourcentags. Eigenschaftenbehälter in Schlüsselwertpaaren mit dem folgenden Format: a=b c=d.

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 iot du account delete

Löschen eines Geräteaktualisierungskontos.

az iot du account delete --account
                         [--no-wait]
                         [--resource-group]
                         [--yes {false, true}]

Beispiele

Löschen eines Zielkontos.

az iot du account delete -n {account_name}

Löschen Sie ein Zielkonto ohne Bestätigung oder Blockierung.

az iot du account delete -n {account_name} -y --no-wait

Erforderliche Parameter

--account -n

Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name> konfigurieren.

--yes -y

Benutzeraufforderungen überspringen. Gibt die Annahme der Aktion an. Wird hauptsächlich für Automatisierungsszenarien verwendet. Standardwert: false.

Zulässige Werte: false, true
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 iot du account list

Alle Geräteaktualisierungskonten in einem Abonnement oder einer Ressourcengruppe auflisten.

az iot du account list [--resource-group]

Beispiele

Listet alle Konten in einem Abonnement auf.

az iot du account list

Auflisten von Konten in einem Abonnement, das Filterkriterien entspricht.

az iot du account list --query "[?tags.env == 'test']"

Auflisten aller Konten in einer Ressourcengruppe.

az iot du account list -g {resource_group}

Optionale Parameter

--resource-group -g

Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name> 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 iot du account show

Zeigen Sie die Details eines Geräteaktualisierungskontos an.

az iot du account show --account
                       [--resource-group]

Beispiele

Anzeigen eines Zielkontos.

az iot du account show -n {account_name}

Zeigen Sie eine Zielkontofilterung für eine bestimmte Eigenschaft an.

az iot du account show -n {account_name} --query identity

Erforderliche Parameter

--account -n

Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>.

Optionale Parameter

--resource-group -g

Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name> 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 iot du account update

Aktualisieren eines Geräteaktualisierungskontos.

Derzeit können die folgenden Kontoeigenschaften aktualisiert werden – Identität, publicNetworkAccess und Tags.

az iot du account update --account
                         [--add]
                         [--force-string]
                         [--no-wait]
                         [--remove]
                         [--resource-group]
                         [--set]

Beispiele

Legen Sie ein bestimmtes Kontotag-Attribut fest.

az iot du account update -n {account_name} --set tags.env='test'

Deaktivieren des Zugriffs auf das öffentliche Netzwerk

az iot du account update -n {account_name} --set publicNetworkAccess='Disabled'

Erforderliche Parameter

--account -n

Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>.

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--resource-group -g

Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name> konfigurieren.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
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 iot du account wait

Blockieren, bis ein gewünschter Kontoressourcenstatus erfüllt wurde.

az iot du account wait --account
                       [--created]
                       [--custom]
                       [--deleted]
                       [--exists]
                       [--interval]
                       [--resource-group]
                       [--timeout]
                       [--updated]

Beispiele

Blockieren, bis die Aktualisierung einer Kontoressource abgeschlossen ist.

az iot du account wait -n {account_name} -g {resource_group} --updated

Erforderliche Parameter

--account -n

Name des Geräteaktualisierungskontos. Sie können den Standardkontonamen mithilfe von az config set defaults.adu_account=<name>.

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--interval

Abrufintervall in Sekunden.

Standardwert: 30
--resource-group -g

Name der Geräteaktualisierungskontoressourcengruppe. Sie können die Standardgruppe mit az config set defaults.adu_group=<name> konfigurieren.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

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.