Freigeben über

az iot ops ns device

  • Vorschau

Note

Diese Referenz ist Teil der Azure-iot-ops-Erweiterung für die Azure CLI (Version 2.67.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az iot ops ns-Gerätebefehl zum ersten Mal ausführen. Erfahren Sie mehr über Erweiterungen.

Die Befehlsgruppe "iot ops ns" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten von Geräten in Geräteregistrierungsnamespaces.

Befehle

Name Beschreibung Typ Status
az iot ops ns device create

Erstellen Sie ein Gerät in einem Geräteregistrierungsnamespace.

 Extension Preview
az iot ops ns device delete

Löschen eines Geräts aus einem Device Registry-Namespace.

 Extension Preview
az iot ops ns device endpoint

Verwalten von Endpunkten für Geräte in Geräteregistrierungsnamespaces.

 Extension Preview
az iot ops ns device endpoint inbound

Verwalten sie eingehende Endpunkte für Geräte in Geräteregistrierungsnamespaces.

 Extension Preview
az iot ops ns device endpoint inbound add

Fügen Sie eingehende Endpunkte zu Geräten in Geräteregistrierungsnamespaces hinzu.

 Extension Preview
az iot ops ns device endpoint inbound add custom

Fügen Sie einem Gerät in einem Geräteregistrierungsnamespace einen benutzerdefinierten eingehenden Endpunkt hinzu.

 Extension Preview
az iot ops ns device endpoint inbound add media

Fügen Sie einem Gerät in einem Device Registry-Namespace einen mediengebundenen Endpunkt hinzu.

 Extension Preview
az iot ops ns device endpoint inbound add mqtt

Fügen Sie einem Gerät in einem Device Registry-Namespace einen MQTT-Endpunkt hinzu.

 Extension Preview
az iot ops ns device endpoint inbound add onvif

Fügen Sie einem Gerät in einem Device Registry-Namespace einen ONVIF-Endpunkt hinzu.

 Extension Preview
az iot ops ns device endpoint inbound add opcua

Fügen Sie einem Gerät in einem Device Registry-Namespace einen OPC UA-Endpunkt hinzu.

 Extension Preview
az iot ops ns device endpoint inbound add rest

Fügen Sie einem Gerät in einem Geräteregistrierungsnamespace einen restgebundenen Endpunkt hinzu.

 Extension Preview
az iot ops ns device endpoint inbound add sse

Fügen Sie einem Gerät in einem Device Registry-Namespace einen SSE-eingehenden Endpunkt hinzu.

 Extension Preview
az iot ops ns device endpoint inbound list

Auflisten eingehender Endpunkte eines Geräts in einem Geräteregistrierungsnamespace.

 Extension Preview
az iot ops ns device endpoint inbound remove

Entfernen sie eingehende Endpunkte von einem Gerät in einem Geräteregistrierungsnamespace.

 Extension Preview
az iot ops ns device endpoint list

Listet alle Endpunkte eines Geräts in einem Geräteregistrierungsnamespace auf.

 Extension Preview
az iot ops ns device query

Abfragen von Geräten in Device Registry-Namespaces.

 Extension Preview
az iot ops ns device show

Zeigen Sie Details eines Geräts in einem Device Registry-Namespace an.

 Extension Preview
az iot ops ns device update

Aktualisieren eines Geräts in einem Geräteregistrierungsnamespace.

 Extension Preview

az iot ops ns device create

Vorschau

Die Befehlsgruppe "iot ops ns" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie ein Gerät in einem Geräteregistrierungsnamespace.

Das Gerät wird mit einer Azure IoT Operations-Instanz verknüpft.

az iot ops ns device create --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--manufacturer]
                            [--model]
                            [--os]
                            [--os-version --osv]
                            [--tags]

Beispiele

Erstellen eines Geräts mit minimaler Konfiguration

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup

Erstellen eines Geräts mit benutzerdefinierten Attributen

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building1 floor=3

Erstellen eines Geräts mit Herstellerinformationen und Betriebssystemdetails

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --manufacturer "Contoso" --model "Gateway X1" --os "Linux" --os-version "4.15"

Erstellen eines deaktivierten Geräts mit Tags

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled --tags environment=test criticality=low

Erforderliche Parameter

--instance -i

Der Name der Azure IoT Operations-Instanz.

--name -n

Der Name des zu erstellenden Geräts.

--resource-group -g

Die Ressourcengruppe der Azure IoT Operations-Instanz.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--attr --custom-attribute

Leerzeichentrennte Schlüssel=Wertpaare, die zusätzlichen benutzerdefinierten Attributen für das Gerät entsprechen. Dieser Parameter kann mehrmals verwendet werden.

--disabled

Deaktivieren Sie das Gerät.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
Zulässige Werte: false, true
--manufacturer

Der Gerätehersteller.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
--model

Das Gerätemodell.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
--os

Das Betriebssystem des Geräts.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
--os-version --osv

Die Version des Gerätebetriebssystems.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
--tags

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

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

Ausgabeformat.

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 iot ops ns device delete

Vorschau

Die Befehlsgruppe "iot ops ns" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen eines Geräts aus einem Device Registry-Namespace.

az iot ops ns device delete --instance
                            --name
                            --resource-group
                            [--yes {false, true}]

Beispiele

Gerät löschen

az iot ops ns device delete --name mydevice --instance myInstance -g myInstanceResourceGroup

Erforderliche Parameter

--instance -i

Der Name der Azure IoT Operations-Instanz.

--name -n

Der Name des zu erstellenden Geräts.

--resource-group -g

Die Ressourcengruppe der Azure IoT Operations-Instanz.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--yes -y

Bestätigen Sie [y]es ohne Aufforderung. Nützlich für CI- und Automatisierungsszenarien.

Eigenschaft Wert
Standardwert: False
Zulässige Werte: false, true
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

Ausgabeformat.

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 iot ops ns device query

Vorschau

Die Befehlsgruppe "iot ops ns" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Abfragen von Geräten in Device Registry-Namespaces.

Abfragen von Geräten über Namespaces hinweg, die auf verschiedenen Suchkriterien basieren, einschließlich Gerätename, Hersteller, Modell und mehr.

az iot ops ns device query [--cq --custom-query]
                           [--disabled {false, true}]
                           [--instance]
                           [--manufacturer]
                           [--model]
                           [--name]
                           [--os]
                           [--os-version --osv]
                           [--resource-group]

Beispiele

Abfragen von Geräten in einer IoT Operations-Instanz

az iot ops ns device query --instance myInstance -g myInstanceResourceGroup

Abfragen nach einem bestimmten Gerät anhand des Namens

az iot ops ns device query --name mydevice

Abfragen nach Geräten eines bestimmten Herstellers

az iot ops ns device query --manufacturer "Contoso"

Verwenden einer benutzerdefinierten Abfrage zum Suchen nach Geräten

az iot ops ns device query --custom-query "where tags.environment=='production'"

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--cq --custom-query

Benutzerdefinierte Abfrage, die verwendet werden soll. Alle anderen Abfrageargumente, abgesehen von Instanzname und Ressourcengruppe, werden ignoriert.

--disabled

Status des Vermögens.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
Zulässige Werte: false, true
--instance -i

Der Name der Azure IoT Operations-Instanz.

--manufacturer

Der Gerätehersteller.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
--model

Das Gerätemodell.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
--name -n

Der Name des zu erstellenden Geräts.

--os

Das Betriebssystem des Geräts.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
--os-version --osv

Die Version des Gerätebetriebssystems.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
--resource-group -g

Die Ressourcengruppe der Azure IoT Operations-Instanz.

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

Ausgabeformat.

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 iot ops ns device show

Vorschau

Die Befehlsgruppe "iot ops ns" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Zeigen Sie Details eines Geräts in einem Device Registry-Namespace an.

az iot ops ns device show --instance
                          --name
                          --resource-group

Beispiele

Anzeigen von Details eines Geräts

az iot ops ns device show --name mydevice --instance myInstance -g myInstanceResourceGroup

Erforderliche Parameter

--instance -i

Der Name der Azure IoT Operations-Instanz.

--name -n

Der Name des zu erstellenden Geräts.

--resource-group -g

Die Ressourcengruppe der Azure IoT Operations-Instanz.

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

Ausgabeformat.

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 iot ops ns device update

Vorschau

Die Befehlsgruppe "iot ops ns" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktualisieren eines Geräts in einem Geräteregistrierungsnamespace.

az iot ops ns device update --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--os-version --osv]
                            [--tags]

Beispiele

Aktualisieren von benutzerdefinierten Geräteattributen

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building2 floor=5

Aktualisieren der Betriebssystemversion

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --os-version "4.18"

Deaktivieren eines Geräts

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled

Gerätetags aktualisieren

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --tags environment=production criticality=high

Erforderliche Parameter

--instance -i

Der Name der Azure IoT Operations-Instanz.

--name -n

Der Name des zu erstellenden Geräts.

--resource-group -g

Die Ressourcengruppe der Azure IoT Operations-Instanz.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--attr --custom-attribute

Leerzeichentrennte Schlüssel=Wertpaare, die zusätzlichen benutzerdefinierten Attributen für das Gerät entsprechen. Dieser Parameter kann mehrmals verwendet werden.

--disabled

Deaktivieren Sie das Gerät.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
Zulässige Werte: false, true
--os-version --osv

Die Version des Gerätebetriebssystems.

Eigenschaft Wert
Parametergruppe: Additional Info Arguments
--tags

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

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

Ausgabeformat.

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