az dt twin

Odwołanie

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

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

Polecenia

az dt twin component	Pokaż i zaktualizuj składniki cyfrowej reprezentacji bliźniaczej wystąpienia usługi Digital Twins.
az dt twin component show	Pokaż szczegóły składnika cyfrowej reprezentacji bliźniaczej.
az dt twin component update	Zaktualizuj składnik cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON.
az dt twin create	Tworzenie cyfrowej reprezentacji bliźniaczej w wystąpieniu.
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-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 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.
az dt twin relationship	Zarządzanie i konfigurowanie relacji cyfrowej reprezentacji bliźniaczej wystąpienia usługi Digital Twins.
az dt twin relationship create	Utwórz relację między źródłowymi i docelowymi cyfrowymi reprezentacjami bliźniaczymi.
az dt twin relationship delete	Usuń relację cyfrowej reprezentacji bliźniaczej w wystąpieniu usługi Digital Twins.
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.
az dt twin relationship list	Wyświetlanie listy relacji cyfrowej reprezentacji bliźniaczej.
az dt twin relationship show	Pokaż szczegóły relacji cyfrowej reprezentacji bliźniaczej.
az dt twin relationship update	Aktualizacje właściwości relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi za pośrednictwem specyfikacji poprawek JSON.
az dt twin show	Pokaż szczegóły cyfrowej reprezentacji bliźniaczej.
az dt twin telemetry	Przetestuj i zweryfikuj trasy zdarzeń i punkty końcowe wystąpienia usługi Digital Twins.
az dt twin telemetry send	Wysyła dane telemetryczne w imieniu cyfrowej reprezentacji bliźniaczej. Jeśli podano ścieżkę składnika, emitowane dane telemetryczne są w imieniu składnika.
az dt twin update	Aktualizowanie cyfrowej reprezentacji bliźniaczej wystąpienia za pomocą specyfikacji poprawek JSON.

az dt twin create

Tworzenie cyfrowej reprezentacji bliźniaczej w wystąpieniu.

--properties może być wbudowany kod JSON lub ścieżka pliku. Uwaga: --properties są wymagane w przypadku 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 z wartościami 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 (wcześniej utworzonych) 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 (wcześniej utworzonych) modeli. Utwórz wystąpienie z wartościami 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 o wystąpienie docelowe 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źniaka o tym samym identyfikatorze.

--properties -p

Początkowe wartości właściwości 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 bliźniaczych reprezentacji zawierających 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.

--query

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

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

Usuwanie cyfrowej reprezentacji bliźniaczej 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

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

--query

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

--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 --debug, 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 również zostaną usunięte.

az dt twin delete-all -n {instance_or_hostname}

Parametry wymagane

--dt-name --dtn -n

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.

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.

--query

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

--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 --debug, 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ływanie się $dtId do właściwości bliźniaczej reprezentacji. W powłokach przypominających powłoki bash lub programie PowerShell $ znak ma znaczenie funkcjonalne i musi zostać uniknięci w ramach 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 dotyczące wszystkich cyfrowych reprezentacji bliźniaczych w wystąpieniu docelowym i projektuj 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')"

Wykonywanie zapytań przy `$dtId` użyciu składni zgodnej z powłoką bash

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

Wykonywanie zapytań przy `$dtId` użyciu składni zgodnej z programem PowerShell

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

Parametry wymagane

--dt-name --dtn -n

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

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

--query

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

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

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

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.

az dt twin update

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

Aktualizacje wartości właściwości i $model elementy 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

--json-patch --patch

Specyfikacja aktualizacji opisana przez JSON-patch. Aktualizacje wartości właściwości i $model elementy 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.

--query

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

--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 --debug, aby uzyskać pełne dzienniki debugowania.