az iot central device

Uwaga

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.30.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az iot central device . Dowiedz się więcej o rozszerzeniach.

Zarządzanie i konfigurowanie urządzeń usługi IoT Central.

Polecenia

az iot central device c2d-message

Uruchamianie poleceń obsługi komunikatów z chmury do urządzenia.

az iot central device c2d-message purge

Przeczyszcza kolejkę komunikatów z chmury do urządzenia docelowego.

az iot central device command

Uruchom polecenia urządzenia.

az iot central device command history

Uzyskaj szczegółowe informacje o najnowszym żądaniu polecenia i odpowiedzi wysłanej na urządzenie.

az iot central device command run

Uruchom polecenie na urządzeniu i wyświetl skojarzona odpowiedź. Nie monitoruje aktualizacji właściwości, które może wykonać polecenie.

az iot central device compute-device-key

Generowanie pochodnego klucza sygnatury dostępu współdzielonego urządzenia.

az iot central device create

Utwórz urządzenie w usłudze IoT Central.

az iot central device delete

Usuń urządzenie z usługi IoT Central.

az iot central device edge

Zarządzanie urządzeniami usługi IoT Central Edge i konfigurowanie ich.

az iot central device edge children

Zarządzanie urządzeniami podrzędnym IoT Edge.

az iot central device edge children add

Dodaj urządzenia jako elementy podrzędne do docelowego urządzenia brzegowego.

az iot central device edge children list

Pobierz listę elementów podrzędnych urządzenia IoT Edge.

az iot central device edge children remove

Usuwanie urządzeń podrzędnych z docelowego urządzenia brzegowego.

az iot central device edge manifest

Zarządzanie manifestami urządzeń IoT Edge.

az iot central device edge manifest show

Pobierz manifest wdrożenia skojarzony z określonym urządzeniem IoT Edge.

az iot central device edge module

Zarządzanie modułami urządzeń IoT Edge.

az iot central device edge module list

Pobierz listę modułów na urządzeniu IoT Edge.

az iot central device edge module restart

Uruchom ponownie moduł na urządzeniu IoT Edge.

az iot central device edge module show

Pobierz moduł na urządzeniu IoT Edge.

az iot central device list

Pobierz listę urządzeń dla aplikacji usługi IoT Central.

az iot central device manual-failback

Przywraca wcześniej wykonane polecenie trybu failover, przenosząc urządzenie z powrotem do niego oryginalne IoT Hub.

az iot central device manual-failover

Wykonaj ręczne przejście w tryb failover urządzenia w wielu centrach IoT Hub, aby zweryfikować możliwość ponownego nawiązywania połączenia przy użyciu usługi DPS do innej IoT Hub.

az iot central device registration-info

Uzyskaj informacje o rejestracji na urządzeniach z usługi IoT Central.

az iot central device show

Pobierz urządzenie z usługi IoT Central.

az iot central device show-credentials

Pobieranie poświadczeń urządzenia z usługi IoT Central.

az iot central device twin

Zarządzanie bliźniaczymi reprezentacjami urządzeń usługi IoT Central.

az iot central device twin show

Pobierz bliźniaczą reprezentację urządzenia z IoT Hub.

az iot central device update

Aktualizowanie urządzenia w usłudze IoT Central.

az iot central device compute-device-key

Generowanie pochodnego klucza sygnatury dostępu współdzielonego urządzenia.

Wygeneruj pochodny klucz urządzenia na podstawie klucza sygnatury dostępu współdzielonego na poziomie grupy.

az iot central device compute-device-key --device-id
                                         --pk

Przykłady

Podstawowy sposób użycia

az iot central device compute-device-key --pk {primaryKey} --device-id {deviceid}

Parametry wymagane

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

--pk --primary-key

Podstawowy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.

az iot central device create

Utwórz urządzenie w usłudze IoT Central.

az iot central device create --app-id
                             --device-id
                             [--api-version {1.0, 1.1-preview, preview}]
                             [--central-api-uri]
                             [--device-name]
                             [--organizations]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

Przykłady

Tworzenie urządzenia

az iot central device create --app-id {appid} --device-id {deviceid}

Tworzenie symulowanego urządzenia

az iot central device create --app-id {appid} --device-id {deviceid} --template {devicetemplateid} --simulated

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.

--device-id -d

Unikatowy identyfikator urządzenia. Ciąg z uwzględnieniem wielkości liter (do 128 znaków długi) znaków alfanumerycznych ASCII 7-bitowych oraz określone znaki specjalne: - . + % _ # * ? ! ( ) , : = @ $ '.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview
wartość domyślna: 1.0
--central-api-uri --central-dns-suffix

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com
--device-name

Nazwa urządzenia czytelnego dla człowieka. Przykład: Lodówka.

--organizations --orgs

Przypisz urządzenie do określonych organizacji. Rozdzielona przecinkami lista identyfikatorów organizacji. Minimalna obsługiwana wersja: 1.1-preview.

--simulated

Dodaj tę flagę, jeśli chcesz, aby usługa IoT Central skonfigurowała tę funkcję jako symulowane urządzenie. --template jest wymagany, jeśli jest to prawda.

akceptowane wartości: false, true
--template

Identyfikator szablonu centralnego. Przykład: dtmi:ojpkindbz:modelDefinition:iild3tm_uo.

--token

Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.

az iot central device delete

Usuń urządzenie z usługi IoT Central.

az iot central device delete --app-id
                             --device-id
                             [--api-version {1.0, 1.1-preview, preview}]
                             [--central-api-uri]
                             [--token]

Przykłady

Usuwanie urządzenia

az iot central device delete --app-id {appid} --device-id {deviceid}

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview
wartość domyślna: 1.0
--central-api-uri --central-dns-suffix

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com
--token

Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.

az iot central device list

Pobierz listę urządzeń dla aplikacji usługi IoT Central.

az iot central device list --app-id
                           [--api-version {1.0, 1.1-preview, preview}]
                           [--central-api-uri]
                           [--edge-only]
                           [--token]

Przykłady

Wyświetl listę wszystkich urządzeń w aplikacji posortowanych według identyfikatora urządzenia (domyślnie)

az iot central device list --app-id {appid}

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview
wartość domyślna: 1.0
--central-api-uri --central-dns-suffix

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com
--edge-only -e

Wyświetlaj listę tylko IoT Edge urządzeń.

--token

Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.

az iot central device manual-failback

Przywraca wcześniej wykonane polecenie trybu failover, przenosząc urządzenie z powrotem do niego oryginalne IoT Hub.

Aby uzyskać więcej informacji na temat wysokiej dostępności, odwiedź stronę https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

az iot central device manual-failback --app-id
                                      --device-id
                                      [--api-version {1.0, 1.1-preview, preview}]
                                      [--central-api-uri]
                                      [--token]

Przykłady

Przywraca wcześniej wykonane polecenie trybu failover, przenosząc urządzenie z powrotem do oryginalnego IoT Hub

az iot central device manual-failback --app-id {appid} --device-id {deviceid}

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview
wartość domyślna: 1.0
--central-api-uri --central-dns-suffix

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com
--token

Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.

az iot central device manual-failover

Wykonaj ręczne przejście w tryb failover urządzenia w wielu centrach IoT Hub, aby zweryfikować możliwość ponownego nawiązywania połączenia przy użyciu usługi DPS do innej IoT Hub.

Aby uzyskać więcej informacji na temat wysokiej dostępności i wartości domyślnej dla czasu wygaśnięcia minut, odwiedź stronę https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

az iot central device manual-failover --app-id
                                      --device-id
                                      [--api-version {1.0, 1.1-preview, preview}]
                                      [--central-api-uri]
                                      [--token]
                                      [--ttl]

Przykłady

Wykonaj ręczne przejście w tryb failover urządzenia w wielu centrach IoT Hub, aby zweryfikować możliwość ponownego nawiązywania połączenia przy użyciu usługi DPS do innej IoT Hub.

az iot central device manual-failover --app-id {appid} --device-id {deviceid} --ttl-minutes {ttl_minutes}

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview
wartość domyślna: 1.0
--central-api-uri --central-dns-suffix

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com
--token

Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.

--ttl --ttl-minutes

Dodatnia liczba całkowita. Czas wygaśnięcia w minutach, aby przenieść urządzenie z powrotem do oryginalnego centrum. Ma wartość domyślną w zapleczu. Zapoznaj się z dokumentacją dotyczącą czasu domyślnego najnowszego zaplecza do wygaśnięcia, odwiedzając stronę https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

az iot central device registration-info

Uzyskaj informacje o rejestracji na urządzeniach z usługi IoT Central.

Uwaga: to polecenie może zająć dużo czasu, aby zwrócić, jeśli nie określono identyfikatora urządzenia, a aplikacja zawiera wiele urządzeń.

az iot central device registration-info --app-id
                                        --device-id
                                        [--api-version {1.0, 1.1-preview, preview}]
                                        [--central-api-uri]
                                        [--token]

Przykłady

Pobieranie informacji o rejestracji na określonym urządzeniu

az iot central device registration-info --app-id {appid} --device-id {deviceid}

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview
wartość domyślna: 1.0
--central-api-uri --central-dns-suffix

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com
--token

Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.

az iot central device show

Pobierz urządzenie z usługi IoT Central.

az iot central device show --app-id
                           --device-id
                           [--api-version {1.0, 1.1-preview, preview}]
                           [--central-api-uri]
                           [--token]

Przykłady

Pobieranie urządzenia

az iot central device show --app-id {appid} --device-id {deviceid}

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview
wartość domyślna: 1.0
--central-api-uri --central-dns-suffix

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com
--token

Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.

az iot central device show-credentials

Pobieranie poświadczeń urządzenia z usługi IoT Central.

az iot central device show-credentials --app-id
                                       --device-id
                                       [--api-version {1.0, 1.1-preview, preview}]
                                       [--central-api-uri]
                                       [--token]

Przykłady

Pobieranie poświadczeń urządzenia dla urządzenia

az iot central device show-credentials --app-id {appid} --device-id {deviceid}

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview
wartość domyślna: 1.0
--central-api-uri --central-dns-suffix

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com
--token

Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.

az iot central device update

Aktualizowanie urządzenia w usłudze IoT Central.

Umożliwia zmianę następujących właściwości urządzenia: "displayName", "template" i "simulated" i "enabled" flag. Nie można zmienić identyfikatora urządzenia. Jeśli określona wersja interfejsu API to "1.1-preview", można również zaktualizować organizacje dla urządzenia.

az iot central device update --app-id
                             --device-id
                             [--api-version {1.0, 1.1-preview, preview}]
                             [--central-api-uri]
                             [--device-name]
                             [--enable {false, true}]
                             [--organizations]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

Przykłady

Aktualizowanie nazwy wyświetlanej urządzenia

az iot central device update --app-id {appid} --device-id {deviceid} --device-name {deviceName}

Włączanie symulowanego urządzenia do rzeczywistego

az iot central device update --app-id {appid} --device-id {deviceid} --simulated false

Aktualizowanie organizacji dla urządzenia

az iot central device update --app-id {appid} --device-id {deviceid} --organizations {organizations}

Wyłączanie urządzenia

az iot central device update --app-id {appid} --device-id {deviceid} --enable false

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu pomocy.

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview
wartość domyślna: 1.0
--central-api-uri --central-dns-suffix

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com
--device-name

Nazwa urządzenia czytelnego dla człowieka. Przykład: Lodówka.

--enable

Dodaj tę flagę, jeśli chcesz, aby usługa IoT Central włączała lub wyłączała urządzenie.

akceptowane wartości: false, true
--organizations --orgs

Przypisz urządzenie do określonych organizacji. Rozdzielona przecinkami lista identyfikatorów organizacji. Minimalna obsługiwana wersja: 1.1-preview.

--simulated

Dodaj tę flagę, jeśli chcesz, aby usługa IoT Central skonfigurowała tę funkcję jako symulowane urządzenie. --template jest wymagany, jeśli jest to prawda.

akceptowane wartości: false, true
--template

Identyfikator szablonu centralnego. Przykład: dtmi:ojpkindbz:modelDefinition:iild3tm_uo.

--token

Jeśli chcesz przesłać żądanie bez uwierzytelniania względem interfejsu wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika do uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.