az dt 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 dt twin . Dowiedz się więcej o rozszerzeniach.

Zarządzanie i konfigurowanie cyfrowych reprezentacji bliźniaczych wystąpienia usługi Digital Twins.

Polecenia

Nazwa	Opis	Typ	Stan
az dt twin component	Pokaż i zaktualizuj składniki cyfrowej reprezentacji bliźniaczej wystąpienia usługi Digital Twins.	Numer wewnętrzny	Ogólna dostępność
az dt twin component show	Pokaż szczegóły składnika cyfrowej reprezentacji bliźniaczej.	Numer wewnętrzny	Ogólna dostępność
az dt twin component update	Zaktualizuj składnik cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.	Numer wewnętrzny	Ogólna dostępność
az dt twin create	Tworzenie cyfrowej reprezentacji bliźniaczej w wystąpieniu.	Numer wewnętrzny	Ogólna dostępność
az dt twin delete	Usuwanie cyfrowej reprezentacji bliźniaczej. Wszystkie relacje odwołujące się do tej reprezentacji bliźniaczej muszą już zostać usunięte.	Numer wewnętrzny	Ogólna dostępność
az dt twin delete-all	Usuwa wszystkie cyfrowe reprezentacje bliźniacze w wystąpieniu usługi Digital Twins, w tym wszystkie relacje dla tych reprezentacji bliźniaczych.	Numer wewnętrzny	Ogólna dostępność
az dt twin query	Wykonywanie zapytań względem cyfrowych reprezentacji bliźniaczych wystąpienia. Umożliwia przechodzenie relacji i filtrowanie według wartości właściwości.	Numer wewnętrzny	Ogólna dostępność
az dt twin relationship	Zarządzanie i konfigurowanie relacji cyfrowej reprezentacji bliźniaczej wystąpienia usługi Digital Twins.	Numer wewnętrzny	Ogólna dostępność
az dt twin relationship create	Utwórz relację między źródłowymi i docelowymi cyfrowymi reprezentacjami bliźniaczymi.	Numer wewnętrzny	Ogólna dostępność
az dt twin relationship delete	Usuń relację cyfrowej reprezentacji bliźniaczej w wystąpieniu usługi Digital Twins.	Numer wewnętrzny	Ogólna dostępność
az dt twin relationship delete-all	Usuwa wszystkie relacje cyfrowej reprezentacji bliźniaczej w wystąpieniu usługi Digital Twins, w tym relacje przychodzące.	Numer wewnętrzny	Ogólna dostępność
az dt twin relationship list	Wyświetlanie listy relacji cyfrowej reprezentacji bliźniaczej.	Numer wewnętrzny	Ogólna dostępność
az dt twin relationship show	Pokaż szczegóły relacji cyfrowej reprezentacji bliźniaczej.	Numer wewnętrzny	Ogólna dostępność
az dt twin relationship update	Aktualizuje właściwości relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi za pośrednictwem specyfikacji poprawek JSON.	Numer wewnętrzny	Ogólna dostępność
az dt twin show	Pokaż szczegóły cyfrowej reprezentacji bliźniaczej.	Numer wewnętrzny	Ogólna dostępność
az dt twin telemetry	Przetestuj i zweryfikuj trasy zdarzeń i punkty końcowe wystąpienia usługi Digital Twins.	Numer wewnętrzny	Ogólna dostępność
az dt twin telemetry send	Wysyła dane telemetryczne w imieniu cyfrowej reprezentacji bliźniaczej. Jeśli podano ścieżkę składnika, emitowana telemetria jest w imieniu składnika.	Numer wewnętrzny	Ogólna dostępność
az dt twin update	Zaktualizuj wystąpienie cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.	Numer wewnętrzny	Ogólna dostępność

az dt twin create

Tworzenie cyfrowej reprezentacji bliźniaczej w wystąpieniu.

--properties może być wbudowanym plikiem JSON lub ścieżką pliku. Uwaga: --properties są wymagane dla reprezentacji bliźniaczych, które zawierają składniki.

az dt twin create --dt-name
                  --dtmi
                  --twin-id
                  [--if-none-match]
                  [--properties]
                  [--resource-group]

Przykłady

Utwórz cyfrową reprezentację bliźniaczą na podstawie istniejącego (utworzonego wcześniej) modelu.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id}

Utwórz cyfrową reprezentację bliźniaczą na podstawie istniejącego (utworzonego wcześniej) modelu z tagiem if-none-match.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:Room;1" --twin-id {twin_id} --if-none-match

Utwórz cyfrową reprezentację bliźniaczą na podstawie istniejącego (utworzonego wcześniej) modelu. Utwórz wystąpienie przy użyciu wartości właściwości.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:DeviceInformation;1" --twin-id {twin_id} --properties '{"manufacturer": "Microsoft"}'

Utwórz cyfrową reprezentację bliźniaczą ze składnikiem na podstawie istniejących (utworzonych wcześniej) modeli. Utwórz wystąpienie składnika z minimalnymi właściwościami.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Thermostat": {
        "$metadata": {},
    }
}'

Utwórz cyfrową reprezentację bliźniaczą ze składnikiem na podstawie istniejących (utworzonych wcześniej) modeli. Utwórz wystąpienie przy użyciu wartości właściwości.

az dt twin create -n {instance_or_hostname} --dtmi "dtmi:com:example:TemperatureController;1" --twin-id {twin_id} --properties '{
    "Temperature": 10.2,
    "Thermostat": {
        "$metadata": {},
        "setPointTemp": 23.12
    }
}'

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

--dtmi --model-id -m

Identyfikator modelu usługi Digital Twins. Przykład: dtmi:com:example:Room;2.

--twin-id -t

Identyfikator cyfrowej reprezentacji bliźniaczej.

Parametry opcjonalne

--if-none-match

Wskazuje, że operacja tworzenia powinna zakończyć się niepowodzeniem, jeśli istnieje istniejąca reprezentacja bliźniaczyna o tym samym identyfikatorze.

wartość domyślna: False

--properties -p

Początkowe wartości właściwości służące do tworzenia wystąpień cyfrowej reprezentacji bliźniaczej lub powiązanych składników. Podaj ścieżkę pliku lub wbudowany kod JSON. Właściwości są wymagane dla reprezentacji bliźniaczych, które zawierają składniki, co najmniej należy podać pusty obiekt $metadata dla każdego składnika.

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

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 dt twin delete

Usuwanie cyfrowej reprezentacji bliźniaczej. Wszystkie relacje odwołujące się do tej reprezentacji bliźniaczej muszą już zostać usunięte.

az dt twin delete --dt-name
                  --twin-id
                  [--etag]
                  [--resource-group]

Przykłady

Usuń cyfrową reprezentację bliźniaczą według identyfikatora.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id}

Usuń cyfrową reprezentację bliźniaczą przy użyciu identyfikatora etag.

az dt twin delete -n {instance_or_hostname} --twin-id {twin_id} --etag {etag}

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

--twin-id -t

Identyfikator cyfrowej reprezentacji bliźniaczej.

Parametry opcjonalne

--etag -e

Wartość tagu jednostki. Polecenie powiedzie się, jeśli element etag pasuje do bieżącego elementu etag dla zasobu.

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

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 dt twin delete-all

Usuwa wszystkie cyfrowe reprezentacje bliźniacze w wystąpieniu usługi Digital Twins, w tym wszystkie relacje dla tych reprezentacji bliźniaczych.

az dt twin delete-all --dt-name
                      [--resource-group]
                      [--yes]

Przykłady

Usuń wszystkie cyfrowe reprezentacje bliźniacze. Wszystkie relacje odwołujące się do bliźniaczych reprezentacji zostaną również usunięte.

az dt twin delete-all -n {instance_or_hostname}

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

Parametry opcjonalne

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--yes -y

Nie monituj o potwierdzenie.

wartość domyślna: False

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 dt twin query

Wykonywanie zapytań względem cyfrowych reprezentacji bliźniaczych wystąpienia. Umożliwia przechodzenie relacji i filtrowanie według wartości właściwości.

W wielu zapytaniach $ bliźniaczych znak jest używany do odwołowania się $dtId do właściwości bliźniaczej reprezentacji. W powłokach przypominających powłokę bash lub program PowerShell $ znak ma znaczenie funkcjonalne i musi zostać usunięty jako część danych wejściowych zapytania. Aby uzyskać więcej informacji, zapoznaj się z dokumentem https://docs.microsoft.com/en-us/azure/digital-twins/concepts-cli Pojęcia dotyczące interfejsu wiersza polecenia usługi Digital Twins.

az dt twin query --dt-name
                 --query-command
                 [--cost {false, true}]
                 [--resource-group]

Przykłady

Wykonaj zapytanie o wszystkie cyfrowe reprezentacje bliźniacze w wystąpieniu docelowym i przeprojektuj wszystkie atrybuty. Pokaż również koszt w jednostkach zapytań.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins" --show-cost

Wykonywanie zapytań według modelu i wszystkich atrybutów projektu.

az dt twin query -n {instance_or_hostname} -q "select * from digitaltwins T where IS_OF_MODEL(T, 'dtmi:com:example:Room;2')"

Zapytanie korzystające z składni "$dtId" ze składnią zgodną z powłoką bash

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.\$dtId = 'room0'"

Zapytanie wykorzystujące składnię zgodną z programem PowerShell przy użyciu $dtId

az dt twin query -n {instance_or_hostname} --query-command "SELECT * FROM DigitalTwins T Where T.`$dtId = 'room0'"

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

--query-command -q

Zapytanie użytkownika do wykonania.

Parametry opcjonalne

--cost --show-cost

Oblicza i wyświetla opłatę za zapytanie.

akceptowane wartości: false, true

wartość domyślna: False

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

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 dt twin show

Pokaż szczegóły cyfrowej reprezentacji bliźniaczej.

az dt twin show --dt-name
                --twin-id
                [--resource-group]

Przykłady

Pokaż szczegóły cyfrowej reprezentacji bliźniaczej.

az dt twin show -n {instance_or_hostname} --twin-id {twin_id}

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

--twin-id -t

Identyfikator cyfrowej reprezentacji bliźniaczej.

Parametry opcjonalne

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

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 dt twin update

Zaktualizuj wystąpienie cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.

Aktualizacje wartości właściwości i $model elementów mogą wystąpić w tym samym żądaniu. Operacje są ograniczone do dodawania, zastępowania i usuwania.

az dt twin update --dt-name
                  --json-patch
                  --twin-id
                  [--etag]
                  [--resource-group]

Przykłady

Aktualizowanie cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Aktualizowanie cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON i używanie elementu etag.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --etag {etag} --json-patch '{"op":"replace", "path":"/Temperature", "value": 20.5}'

Aktualizowanie cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch '[
  {"op":"replace", "path":"/Temperature", "value": 20.5},
  {"op":"add", "path":"/Areas", "value": ["ControlSystem"]}
]'

Aktualizowanie cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON zdefiniowanej w pliku.

az dt twin update -n {instance_or_hostname} --twin-id {twin_id} --json-patch ./my/patch/document.json

Parametry wymagane

--dt-name --dtn -n

Nazwa wystąpienia usługi Digital Twins lub nazwa hosta. Jeśli podano nazwę wystąpienia, subskrypcja użytkownika jest najpierw odpytywana dla wystąpienia docelowego w celu pobrania nazwy hosta. Jeśli zostanie podana nazwa hosta, zapytanie subskrypcji zostanie pominięte, a podana wartość zostanie użyta do kolejnej interakcji.

--json-patch --patch

Specyfikacja aktualizacji opisana przez JSON-patch. Aktualizacje wartości właściwości i $model elementów mogą wystąpić w tym samym żądaniu. Operacje są ograniczone do dodawania, zastępowania i usuwania. Podaj ścieżkę pliku lub wbudowany kod JSON.

--twin-id -t

Identyfikator cyfrowej reprezentacji bliźniaczej.

Parametry opcjonalne

--etag -e

Wartość tagu jednostki. Polecenie powiedzie się, jeśli element etag pasuje do bieżącego elementu etag dla zasobu.

--resource-group -g

Grupa zasobów wystąpienia usługi Digital Twins. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

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.