Feedback

az iot central device command

  • Referenz

Hinweis

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

Führen Sie Gerätebefehle aus.

Befehle

az iot central device command history

Rufen Sie die Details für die neueste Befehlsanforderung und Antwort ab, die an das Gerät gesendet wird.
az iot central device command run

Führen Sie einen Befehl auf einem Gerät aus, und zeigen Sie die zugeordnete Antwort an. Überwacht KEINE Eigenschaftsupdates, die der Befehl ausführen kann.

az iot central device command history

Rufen Sie die Details für die neueste Befehlsanforderung und Antwort ab, die an das Gerät gesendet wird.

Listet die neueste Befehlsanforderung und -antwort auf, die vom IoT Central an das Gerät gesendet wurde. Alle Aktualisierungen, die das Gerät als Ergebnis der Befehlsausführung ausführt, werden nicht in der Antwort enthalten.

az iot central device command history --app-id
                                      --cn
                                      --device-id
                                      [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                                      [--central-api-uri]
                                      [--co]
                                      [--interface-id]
                                      [--mn]
                                      [--token]

Beispiele

Befehlsantwort anzeigen

az iot central device command history --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname}

Komponentenbefehlsantwort anzeigen

az iot central device command history --app-id {appid} --device-id {deviceid} --component-name {componentname} --command-name {commandname}

Befehlsantwort für Modulkomponenten anzeigen

az iot central device command history --app-id {appid} --device-id {deviceid} --module-name {modulename} --component-name {componentname} --command-name {commandname}

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Info" für Ihre Anwendung im Hilfemenü.

--cn --command-name

Der Befehlsname, wie in der Gerätevorlage angegeben. Der Befehlsname kann vom Anzeigenamen des Befehls abweichen.

--device-id -d

Die Geräte-ID des Zielgeräts. Sie finden die Geräte-ID, indem Sie auf der Seite "Gerätedetails" auf die Schaltfläche "Verbinden" klicken.

Optionale Parameter

--api-version --av

Die API-Version für den angeforderten Vorgang.

Zulässige Werte: 1.0, 1.1-preview, 2022-05-31, preview
Standardwert: 2022-05-31
--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com
--co --component-name

Der Name der Gerätekomponente.

--interface-id -i

Der Name der Schnittstelle/Komponente, wie in der Gerätevorlage angegeben. Sie können es finden, indem Sie zu "Gerätevorlage" navigieren und die Schnittstellen-/Komponentenidentität unter der entsprechenden Gerätefunktion anzeigen.

--mn --module-name

Der Name des Gerätemoduls.

--token

Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich gegen die Azure CLI zu authentifizieren, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.

az iot central device command run

Führen Sie einen Befehl auf einem Gerät aus, und zeigen Sie die zugeordnete Antwort an. Überwacht KEINE Eigenschaftsupdates, die der Befehl ausführen kann.

--content kann inline json oder dateipfad sein.

az iot central device command run --app-id
                                  --cn
                                  --content
                                  --device-id
                                  [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                                  [--central-api-uri]
                                  [--co]
                                  [--interface-id]
                                  [--mn]
                                  [--token]

Beispiele

Befehl mit Inlinenutzlast ausführen. Nutzlast sollte unter "anforderung" in json-Zeichenfolge sein

az iot central device command run --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname} --content '{"request": {payload}}'

Befehl für kurze Ausführung mit json-Nutzlastpfad.

az iot central device command run -n {appid} -d {deviceid} -i {interfaceid} --cn {commandname} -k {payload_file_path}

Ausführen des Komponentenbefehls.

az iot central device command run -n {appid} -d {deviceid} --co {componentname} --cn {commandname} -k {payload}

Ausführen des Modulkomponentenbefehls.

az iot central device command run -n {appid} -d {deviceid} --mn {modulename} --co {componentname} --cn {commandname} -k {payload}

Erforderliche Parameter

--app-id -n

Die App-ID der IoT Central-App, die Sie verwalten möchten. Sie finden die App-ID auf der Seite "Info" für Ihre Anwendung im Hilfemenü.

--cn --command-name

Der Befehlsname, wie in der Gerätevorlage angegeben. Der Befehlsname kann vom Anzeigenamen des Befehls abweichen.

--content -k

Konfiguration für Anforderung. Geben Sie Pfad zu JSON-Datei oder unformatiertem JSON an. [Dateipfadbeispiel: ./path/to/file.json] [Stringified JSON-Beispiel: {'a': 'b'}].

--device-id -d

Die Geräte-ID des Zielgeräts. Sie finden die Geräte-ID, indem Sie auf der Seite "Gerätedetails" auf die Schaltfläche "Verbinden" klicken.

Optionale Parameter

--api-version --av

Die API-Version für den angeforderten Vorgang.

Zulässige Werte: 1.0, 1.1-preview, 2022-05-31, preview
Standardwert: 2022-05-31
--central-api-uri --central-dns-suffix

Das IoT Central DNS-Suffix, das Ihrer Anwendung zugeordnet ist.

Standardwert: azureiotcentral.com
--co --component-name

Der Name der Gerätekomponente.

--interface-id -i

Der Name der Schnittstelle/Komponente, wie in der Gerätevorlage angegeben. Sie können es finden, indem Sie zu "Gerätevorlage" navigieren und die Schnittstellen-/Komponentenidentität unter der entsprechenden Gerätefunktion anzeigen.

--mn --module-name

Der Name des Gerätemoduls.

--token

Wenn Sie Ihre Anforderung lieber übermitteln möchten, ohne sich gegen die Azure CLI zu authentifizieren, können Sie ein gültiges Benutzertoken angeben, um Ihre Anforderung zu authentifizieren. Sie müssen den Schlüsseltyp als Teil der Anforderung angeben. Weitere Informationen finden Sie unter https://aka.ms/iotcentraldocsapi.