Udostępnij przez

az iot central device twin

Note

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.67.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie 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.

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

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

 Extension 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 --av {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri --central-dns-suffix]
                                   [--co --component-name]
                                   [--mn --module-name]
                                   [--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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

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

Właściwość Wartość
Domyślna wartość: 2022-07-31
Dopuszczalne wartości: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

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

Właściwość Wartość
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 stronie https://aka.ms/iotcentraldocsapi.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

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 --av {2022-06-30-preview, 2022-07-31}]
                                [--central-api-uri --central-dns-suffix]
                                [--co --component-name]
                                [--mn --module-name]
                                [--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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

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

Właściwość Wartość
Domyślna wartość: 2022-07-31
Dopuszczalne wartości: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

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

Właściwość Wartość
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 stronie https://aka.ms/iotcentraldocsapi.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False

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 --av {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri --central-dns-suffix]
                                  [--co --component-name]
                                  [--mn --module-name]
                                  [--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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

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

Właściwość Wartość
Domyślna wartość: 2022-07-31
Dopuszczalne wartości: 2022-06-30-preview, 2022-07-31
--central-api-uri --central-dns-suffix

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

Właściwość Wartość
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 stronie https://aka.ms/iotcentraldocsapi.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False