az iot central device

Uwaga

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

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

Polecenia

Nazwa Opis Typ Stan
az iot central device attestation

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

Numer wewnętrzny Ogólna dostępność
az iot central device attestation create

Utwórz indywidualne zaświadczenie urządzenia.

Numer wewnętrzny Ogólna dostępność
az iot central device attestation delete

Usuń indywidualne zaświadczenie urządzenia.

Numer wewnętrzny Ogólna dostępność
az iot central device attestation show

Pobierz zaświadczenie urządzenia.

Numer wewnętrzny Ogólna dostępność
az iot central device attestation update

Zaktualizuj zaświadczanie poszczególnych urządzeń za pomocą poprawki.

Numer wewnętrzny Ogólna dostępność
az iot central device c2d-message

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

Numer wewnętrzny Ogólna dostępność
az iot central device c2d-message purge

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

Numer wewnętrzny Ogólna dostępność
az iot central device command

Uruchom polecenia urządzenia.

Numer wewnętrzny Ogólna dostępność
az iot central device command history

Uzyskaj szczegółowe informacje dotyczące najnowszego żądania polecenia i odpowiedzi wysłanej na urządzenie.

Numer wewnętrzny Ogólna dostępność
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.

Numer wewnętrzny Ogólna dostępność
az iot central device compute-device-key

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

Numer wewnętrzny Ogólna dostępność
az iot central device create

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

Numer wewnętrzny Ogólna dostępność
az iot central device delete

Usuwanie urządzenia z usługi IoT Central.

Numer wewnętrzny Ogólna dostępność
az iot central device edge

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

Numer wewnętrzny Ogólna dostępność
az iot central device edge children

Zarządzanie urządzeniami podrzędnymi urządzeń usługi IoT Edge.

Numer wewnętrzny Ogólna dostępność
az iot central device edge children add

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

Numer wewnętrzny Wersja Preview
az iot central device edge children list

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

Numer wewnętrzny Ogólna dostępność
az iot central device edge children remove

Usuń urządzenia podrzędne z docelowego urządzenia brzegowego.

Numer wewnętrzny Wersja Preview
az iot central device edge manifest

Zarządzanie manifestami urządzeń usługi IoT Edge.

Numer wewnętrzny Wersja Preview
az iot central device edge manifest show

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

Numer wewnętrzny Wersja Preview
az iot central device edge module

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

Numer wewnętrzny Wersja Preview
az iot central device edge module list

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

Numer wewnętrzny Wersja Preview
az iot central device edge module restart

Uruchom ponownie moduł na urządzeniu usługi IoT Edge.

Numer wewnętrzny Wersja Preview
az iot central device edge module show

Pobierz moduł na urządzeniu usługi IoT Edge.

Numer wewnętrzny Wersja Preview
az iot central device list

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

Numer wewnętrzny Ogólna dostępność
az iot central device list-components

Wyświetl listę składników znajdujących się na urządzeniu.

Numer wewnętrzny Ogólna dostępność
az iot central device list-modules

Wyświetl listę modułów znajdujących się na urządzeniu.

Numer wewnętrzny Ogólna dostępność
az iot central device manual-failback

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

Numer wewnętrzny Ogólna dostępność
az iot central device manual-failover

Wykonaj ręczne przełączenie urządzenia w tryb failover w wielu centrach IoT Hub, aby zweryfikować możliwość ponownego nawiązania połączenia przy użyciu usługi DPS z inną usługą IoT Hub.

Numer wewnętrzny Ogólna dostępność
az iot central device registration-info

Uzyskaj informacje o rejestracji urządzeń z usługi IoT Central.

Numer wewnętrzny Ogólna dostępność
az iot central device show

Pobierz urządzenie z usługi IoT Central.

Numer wewnętrzny Ogólna dostępność
az iot central device show-credentials

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

Numer wewnętrzny Ogólna dostępność
az iot central device telemetry

Wykonaj zapytanie dotyczące ostatniej wartości telemetrii urządzenia usługi IoT Central.

Numer wewnętrzny Ogólna dostępność
az iot central device telemetry show

Pobierz ostatnią wartość telemetrii z urządzenia.

Numer wewnętrzny Ogólna dostępność
az iot central device twin

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

Numer wewnętrzny Ogólna dostępność
az iot central device twin replace

Zastąp wartości właściwości zapisywalnych urządzenia, składnika urządzenia lub modułu urządzenia lub składnika modułu urządzenia.

Numer wewnętrzny Ogólna dostępność
az iot central device twin show

Pobierz wszystkie wartości właściwości urządzenia, składnika urządzenia, modułu urządzenia lub składnika modułu urządzenia.

Numer wewnętrzny Ogólna dostępność
az iot central device twin update

Aktualizowanie zapisywalnych wartości właściwości urządzenia, składnika urządzenia, modułu urządzenia lub składnika modułu urządzenia.

Numer wewnętrzny Ogólna dostępność
az iot central device update

Aktualizowanie urządzenia w usłudze IoT Central.

Numer wewnętrzny Ogólna dostępność

az iot central device compute-device-key

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

Wygeneruj klucz pochodny 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łączenie na stronie Szczegóły urządzenia.

--pk --primary-key

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

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 {2022-06-30-preview, 2022-07-31}]
                             [--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 uwzględniający wielkość liter (maksymalnie 128 znaków) znaków alfanumerycznych ASCII 7-bitowych oraz niektóre znaki specjalne: - . + % _ # * ? ! ( ) , : = @ $ '.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--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 urządzenie symulowane. — szablon jest wymagany, jeśli jest to prawda.

akceptowane wartości: false, true
wartość domyślna: False
--template

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

--token

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot central device delete

Usuwanie urządzenia z usługi IoT Central.

az iot central device delete --app-id
                             --device-id
                             [--api-version {2022-06-30-preview, 2022-07-31}]
                             [--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łączenie na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--central-api-uri --central-dns-suffix

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

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

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot central device list

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

az iot central device list --app-id
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri]
                           [--edge-only]
                           [--token]

Przykłady

Wyświetlanie listy wszystkich urządzeń w aplikacji posortowanych według identyfikatora urządzenia (ustawienie domyślne)

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
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--central-api-uri --central-dns-suffix

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

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

Lista tylko urządzeń usługi IoT Edge.

wartość domyślna: False
--token

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot central device list-components

Wyświetl listę składników znajdujących się na urządzeniu.

az iot central device list-components --app-id
                                      --device-id
                                      [--api-version {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--mn]
                                      [--token]

Przykłady

Wyświetlanie listy składników znajdujących się na urządzeniu

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

Wyświetlanie listy składników znajdujących się w module urządzenia

az iot central device list-components --app-id {appid} --module-name {modulename} --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łączenie na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--central-api-uri --central-dns-suffix

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

wartość domyślna: azureiotcentral.com
--mn --module-name

Nazwa modułu urządzenia.

--token

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot central device list-modules

Wyświetl listę modułów znajdujących się na urządzeniu.

az iot central device list-modules --app-id
                                   --device-id
                                   [--api-version {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri]
                                   [--token]

Przykłady

Wyświetlanie listy modułów znajdujących się na urządzeniu

az iot central device list-modules --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łączenie na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--central-api-uri --central-dns-suffix

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

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

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot central device manual-failback

Przywraca wcześniej wykonane polecenie trybu failover, przenosząc urządzenie z powrotem do oryginalnego centrum 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 {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--token]

Przykłady

Przywraca wcześniej wykonane polecenie trybu failover, przenosząc urządzenie z powrotem do oryginalnego centrum 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łączenie na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--central-api-uri --central-dns-suffix

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

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

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot central device manual-failover

Wykonaj ręczne przełączenie urządzenia w tryb failover w wielu centrach IoT Hub, aby zweryfikować możliwość ponownego nawiązania połączenia przy użyciu usługi DPS z inną usługą IoT Hub.

Aby uzyskać więcej informacji na temat wysokiej dostępności i wartości domyślnej czasu wygaśnięcia w minutach, 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 {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri]
                                      [--token]
                                      [--ttl]

Przykłady

Wykonaj ręczne przełączenie urządzenia w tryb failover w wielu centrach IoT Hub, aby zweryfikować możliwość ponownego nawiązania połączenia przy użyciu usługi DPS z inną usługą 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łączenie na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--central-api-uri --central-dns-suffix

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

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

Jeśli wolisz przesłać żądanie bez uwierzytelniania w interfejsie wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika w celu uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na 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 dla wartości na żywo, odwiedzając stronę https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot central device registration-info

Uzyskaj informacje o rejestracji urządzeń z usługi IoT Central.

Uwaga: Zwrócenie tego polecenia może zająć dużo czasu, 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 {2022-06-30-preview, 2022-07-31}]
                                        [--central-api-uri]
                                        [--token]

Przykłady

Uzyskiwanie 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łączenie na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--central-api-uri --central-dns-suffix

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

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

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

az iot central device show

Pobierz urządzenie z usługi IoT Central.

az iot central device show --app-id
                           --device-id
                           [--api-version {2022-06-30-preview, 2022-07-31}]
                           [--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łączenie na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--central-api-uri --central-dns-suffix

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

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

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

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 {2022-06-30-preview, 2022-07-31}]
                                       [--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łączenie na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--central-api-uri --central-dns-suffix

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

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

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

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

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", "simulated", "enabled" i "organizations". Nie można zmienić identyfikatora urządzenia.

az iot central device update --app-id
                             --device-id
                             [--api-version {2022-06-30-preview, 2022-07-31}]
                             [--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łączenie na stronie Szczegóły urządzenia.

Parametry opcjonalne

--api-version --av
Przestarzałe

Argument "api_version" został wycofany i zostanie usunięty w przyszłej wersji.

Ten parametr polecenia został przestarzały i zostanie zignorowany. W przyszłej wersji będziemy obsługiwać tylko interfejsy API usługi IoT Central z najnowszej wersji ogólnie dostępnej. Jeśli jakikolwiek interfejs API nie jest jeszcze ogólnie dostępny, wywołamy najnowszą wersję zapoznawcza.

akceptowane wartości: 2022-06-30-preview, 2022-07-31
wartość domyślna: 2022-07-31
--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 urządzenie symulowane. — szablon 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 wolisz przesłać żądanie bez uwierzytelniania w interfejsie wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika w celu uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na https://aka.ms/iotcentraldocsapi.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

akceptowane wartości: json, jsonc, none, table, tsv, yaml, yamlc
wartość domyślna: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.