az iot central device twin

Uwaga

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

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

Polecenia

Nazwa	Opis	Typ	Stan
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 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.

Podanie parametru --component-name, --module-name lub obu z nich w celu zastąpienia właściwości składnika urządzenia, właściwości modułu urządzenia lub właściwości składnika modułu urządzenia.

az iot central device twin replace --app-id
                                   --content
                                   --device-id
                                   [--api-version {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri]
                                   [--co]
                                   [--mn]
                                   [--token]

Przykłady

Zamień właściwości urządzenia

az iot central device twin replace --app-id {appid} --device-id {deviceid} -k {content}

Zamień właściwości składnika urządzenia

az iot central device twin replace --app-id {appid} --device-id {deviceid} --co {componentname} -k {content}

Zastępowanie właściwości składnika modułu urządzenia

az iot central device twin replace --app-id {appid} --device-id {deviceid} --mn {modulename} --co {componentname} -k {content}

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.

--content -k

Konfiguracja żądania. Podaj ścieżkę do pliku JSON lub nieprzetworzonego ciągu JSON. [Przykład ścieżki pliku: ./path/to/file.json] [Stringified JSON Example: {'a': 'b'}].

--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

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.

Dopuszczalne wartości: 2022-06-30-preview, 2022-07-31

Domyślna wartość: 2022-07-31

--central-api-uri --central-dns-suffix

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

Domyślna wartość: azureiotcentral.com

--co --component-name

Nazwa składnika urządzenia.

--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.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc

Domyślna wartość: 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 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.

Podanie parametru --component-name, --module-name lub obu z nich w celu pobrania właściwości składnika urządzenia, właściwości modułu urządzenia lub właściwości składnika modułu urządzenia.

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

Przykłady

Pobieranie właściwości urządzenia

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

Pobieranie właściwości składnika urządzenia

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

Pobieranie właściwości składnika modułu urządzenia

az iot central device twin show --app-id {appid} --device-id {deviceid} --mn {modulename} --co {componentname}

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

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.

Dopuszczalne wartości: 2022-06-30-preview, 2022-07-31

Domyślna wartość: 2022-07-31

--central-api-uri --central-dns-suffix

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

Domyślna wartość: azureiotcentral.com

--co --component-name

Nazwa składnika urządzenia.

--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.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc

Domyślna wartość: 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 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.

Podanie parametru --component-name, --module-name lub obu z nich w celu zaktualizowania właściwości składnika urządzenia, właściwości modułu urządzenia lub właściwości składnika modułu urządzenia.

az iot central device twin update --app-id
                                  --content
                                  --device-id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--co]
                                  [--mn]
                                  [--token]

Przykłady

Aktualizowanie właściwości urządzenia

az iot central device twin update --app-id {appid} --device-id {deviceid} -k {content}

Aktualizowanie właściwości składnika urządzenia

az iot central device twin update --app-id {appid} --device-id {deviceid} --co {componentname} -k {content}

Aktualizowanie właściwości składnika modułu urządzenia

az iot central device twin update --app-id {appid} --device-id {deviceid} --mn {modulename} --co {componentname} -k {content}

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.

--content -k

Konfiguracja żądania. Podaj ścieżkę do pliku JSON lub nieprzetworzonego ciągu JSON. [Przykład ścieżki pliku: ./path/to/file.json] [Stringified JSON Example: {'a': 'b'}].

--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

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.

Dopuszczalne wartości: 2022-06-30-preview, 2022-07-31

Domyślna wartość: 2022-07-31

--central-api-uri --central-dns-suffix

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

Domyślna wartość: azureiotcentral.com

--co --component-name

Nazwa składnika urządzenia.

--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.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc

Domyślna wartość: 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.