az dt twin relationship

Uwaga

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

Zarządzanie i konfigurowanie relacji cyfrowej reprezentacji bliźniaczej wystąpienia usługi Digital Twins.

Polecenia

Nazwa	Opis	Typ	Stan
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	Aktualizacje właściwości relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi za pośrednictwem specyfikacji poprawki JSON.	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.

--properties może być wbudowanym plikiem JSON lub ścieżką pliku.

az dt twin relationship create --dt-name
                               --kind
                               --relationship-id
                               --source
                               --target
                               [--if-none-match]
                               [--properties]
                               [--resource-group]

Przykłady

Utwórz relację między dwiema cyfrowymi reprezentacjami bliźniaczymi.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id}

Tworzenie relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi z tagiem if-none-match

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --if-none-match

Utwórz relację z zainicjowanymi właściwościami między dwiema reprezentacjami cyfrowymi.

az dt twin relationship create -n {instance_or_hostname} --relationship-id {relationship_id} --relationship contains --twin-id {source_twin_id} --target {target_twin_id} --properties '{"ownershipUser": "me", "ownershipDepartment": "Computer Science"}'

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.

--kind --relationship

Nazwa lub rodzaj relacji. Na przykład: "contains".

--relationship-id -r

Identyfikator relacji.

--source --twin-id -t

Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.

--target --target-twin-id

Identyfikator docelowej reprezentacji bliźniaczej dla relacji.

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ąpienia relacji cyfrowej reprezentacji bliźniaczej. Podaj ścieżkę pliku lub wbudowany kod JSON.

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

Usuń relację cyfrowej reprezentacji bliźniaczej w wystąpieniu usługi Digital Twins.

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

Przykłady

Usuń relację cyfrowej reprezentacji bliźniaczej.

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

Usuń relację cyfrowej reprezentacji bliźniaczej przy użyciu elementu etag.

az dt twin relationship delete -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_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.

--relationship-id -r

Identyfikator relacji.

--source --twin-id -t

Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.

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 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 delete-all --dt-name
                                   [--resource-group]
                                   [--source]
                                   [--yes]

Przykłady

Usuń wszystkie relacje cyfrowej reprezentacji bliźniaczej skojarzone z reprezentacją bliźniaczą.

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

Usuń wszystkie relacje cyfrowej reprezentacji bliźniaczej w ramach instace usługi Digital Twins.

az dt twin relationship 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>.

--source --twin-id -t

Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.

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

Wyświetlanie listy relacji cyfrowej reprezentacji bliźniaczej.

az dt twin relationship list --dt-name
                             --source
                             [--incoming {false, true}]
                             [--kind]
                             [--resource-group]

Przykłady

Wyświetlanie listy wychodzących relacji cyfrowej reprezentacji bliźniaczej.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id}

Wyświetlanie listy wychodzących relacji cyfrowej reprezentacji bliźniaczej i filtrowanie relacji "contains"

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains

Wyświetlanie listy przychodzących relacji cyfrowej reprezentacji bliźniaczej.

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --incoming

Wyświetlanie listy przychodzących relacji cyfrowej reprezentacji bliźniaczej i filtrowanie relacji "contains".

az dt twin relationship list -n {instance_or_hostname} --twin-id {twin_id} --relationship contains --incoming

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.

--source --twin-id -t

Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.

Parametry opcjonalne

--incoming

Pobiera wszystkie relacje przychodzące dla cyfrowej reprezentacji bliźniaczej.

akceptowane wartości: false, true

wartość domyślna: False

--kind --relationship

Filtruj wynik według rodzaju relacji.

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

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

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

Przykłady

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

az dt twin relationship show -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_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.

--relationship-id -r

Identyfikator relacji.

--source --twin-id -t

Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.

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

Aktualizacje właściwości relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi za pośrednictwem specyfikacji poprawki JSON.

Operacje są ograniczone do dodawania, zastępowania i usuwania.

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

Przykłady

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

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

Aktualizowanie relacji cyfrowej reprezentacji bliźniaczej za pomocą specyfikacji poprawek JSON i używanie narzędzia etag.

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

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

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

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

az dt twin relationship update -n {instance_or_hostname} --twin-id {twin_id} --relationship-id {relationship_id} --relationship contains --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 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.

--relationship-id -r

Identyfikator relacji.

--source --twin-id -t

Identyfikator źródłowej reprezentacji bliźniaczej dla relacji.

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.