az dt twin relationship

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

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

Polecenia

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

Utwórz relację między źródłowymi i docelowymi cyfrowymi reprezentacjami bliźniaczymi.

--properties może być wbudowany kod JSON lub ścieżka 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 dwoma 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} --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 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.

--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źniaka o tym samym identyfikatorze.

--properties -p

Początkowe wartości właściwości służące do tworzenia wystąpień 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.

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

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

--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 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 instace usługi Digital Twins.

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

--source --twin-id -t

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

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

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

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

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

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

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

Aktualizacje właściwości relacji między dwiema cyfrowymi reprezentacjami bliźniaczymi za pośrednictwem specyfikacji poprawek 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 elementu 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 poprawek 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

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

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