az dt

Note

このリファレンスは、Azure CLI (バージョン 2.37.0 以降) の azure-iot 拡張機能の一部です。 拡張機能は、az dt コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

Azure Digital Twins のソリューションとインフラストラクチャを管理します。

コマンド

名前 説明 Status
az dt create

Digital Twins インスタンスを作成または更新します。

拡張子 GA
az dt data-history

データ履歴を管理および構成します。

拡張子 GA
az dt data-history connection

データ履歴接続を管理および構成します。

拡張子 GA
az dt data-history connection create

Digital Twins インスタンスとサポートされているリソースの間にデータ履歴接続を作成します。

拡張子 GA
az dt data-history connection create adx

Digital Twins インスタンスと Azure Data エクスプローラー データベースの間にデータ履歴接続を作成します。 事前に作成された Azure Data エクスプローラーと Event Hub リソースが必要です。

拡張子 GA
az dt data-history connection delete

Digital Twins インスタンスで構成されたデータ履歴接続を削除します。

拡張子 GA
az dt data-history connection list

Digital Twins インスタンスで構成されているすべてのデータ履歴接続を一覧表示します。

拡張子 GA
az dt data-history connection show

Digital Twins インスタンスで構成されたデータ履歴接続の詳細を表示します。

拡張子 GA
az dt data-history connection wait

データ履歴接続に対する操作が完了するまで待ちます。

拡張子 GA
az dt delete

既存の Digital Twins インスタンスを削除します。

拡張子 GA
az dt endpoint

Digital Twins インスタンス エンドポイントを管理および構成します。

拡張子 GA
az dt endpoint create

Digital Twins インスタンスにエグレス エンドポイントを追加します。

拡張子 GA
az dt endpoint create eventgrid

EventGrid トピック エンドポイントを Digital Twins インスタンスに追加します。 事前に作成されたリソースが必要です。

拡張子 GA
az dt endpoint create eventhub

Digital Twins インスタンスに EventHub エンドポイントを追加します。

拡張子 GA
az dt endpoint create servicebus

ServiceBus トピック エンドポイントを Digital Twins インスタンスに追加します。

拡張子 GA
az dt endpoint delete

Digital Twins インスタンスからエンドポイントを削除します。

拡張子 GA
az dt endpoint list

Digital Twins インスタンスで構成されているすべてのエグレス エンドポイントを一覧表示します。

拡張子 GA
az dt endpoint show

Digital Twins インスタンスで構成されたエンドポイントの詳細を表示します。

拡張子 GA
az dt endpoint wait

エンドポイント操作が完了するまで待ちます。

拡張子 GA
az dt identity

Digital Twins インスタンスの ID を管理します。

拡張子 GA
az dt identity assign

マネージド ID を Digital Twins インスタンスに割り当てます。

拡張子 GA
az dt identity remove

Digital Twins インスタンスからマネージド ID を削除します。

拡張子 GA
az dt identity show

Digital Twins インスタンスの ID プロパティを表示します。

拡張子 GA
az dt job

デジタル ツイン インスタンスのジョブを管理および構成します。

拡張子 GA
az dt job deletion

デジタル ツイン インスタンス内のモデル、ツイン、リレーションシップのデータを削除するためのジョブを管理および構成します。

拡張子 GA
az dt job deletion create

デジタル ツイン インスタンスで削除ジョブを作成して実行します。

拡張子 GA
az dt job deletion list

デジタル ツイン インスタンスで実行されたすべての削除ジョブを一覧表示します。

拡張子 GA
az dt job deletion show

デジタル ツイン インスタンスで実行された削除ジョブの詳細を表示します。

拡張子 GA
az dt job import

モデル、ツイン、リレーションシップのデータをデジタル ツイン インスタンスにインポートするためのジョブを管理および構成します。

拡張子 GA
az dt job import cancel

デジタル ツイン インスタンスで実行されたデータ インポート ジョブを取り消します。

拡張子 GA
az dt job import create

デジタル ツイン インスタンスでデータ インポート ジョブを作成して実行します。

拡張子 GA
az dt job import delete

デジタル ツイン インスタンスで実行されるデータ インポート ジョブを削除します。

拡張子 GA
az dt job import list

デジタル ツイン インスタンスで実行されたすべてのデータ インポート ジョブを一覧表示します。

拡張子 GA
az dt job import show

デジタル ツイン インスタンスで実行されたデータ インポート ジョブの詳細を表示します。

拡張子 GA
az dt list

サブスクリプションまたはリソース グループ別に Digital Twins インスタンスのコレクションを一覧表示します。

拡張子 GA
az dt model

Digital Twins インスタンスで DTDL モデルと定義を管理します。

拡張子 GA
az dt model create

1 つ以上のモデルをアップロードします。

拡張子 GA
az dt model delete

モデルを削除します。 モデルは、他のモデルが参照していない場合にのみ削除できます。

拡張子 GA
az dt model delete-all

Digital Twins インスタンス内のすべてのモデルを削除します。

拡張子 GA
az dt model list

モデルのメタデータ、定義、依存関係を一覧表示します。

拡張子 GA
az dt model show

ターゲット モデルまたはモデル定義を取得します。

拡張子 GA
az dt model update

モデルのメタデータを更新します。 現在、モデルはデコミットのみ可能です。

拡張子 GA
az dt network

プライベート リンクやエンドポイント接続を含む Digital Twins ネットワーク構成を管理します。

拡張子 GA
az dt network private-endpoint

Digital Twins インスタンスのプライベート エンドポイントを管理します。

拡張子 GA
az dt network private-endpoint connection

Digital Twins インスタンスのプライベート エンドポイント接続を管理します。

拡張子 GA
az dt network private-endpoint connection delete

Digital Twins インスタンスに関連付けられているプライベート エンドポイント接続を削除します。

拡張子 GA
az dt network private-endpoint connection list

Digital Twins インスタンスに関連付けられているプライベート エンドポイント接続を一覧表示します。

拡張子 GA
az dt network private-endpoint connection set

Digital Twins インスタンスに関連付けられているプライベート エンドポイント接続の状態を設定します。

拡張子 GA
az dt network private-endpoint connection show

Digital Twins インスタンスに関連付けられているプライベート エンドポイント接続を表示します。

拡張子 GA
az dt network private-endpoint connection wait

プライベート エンドポイント接続の操作が完了するまで待ちます。

拡張子 GA
az dt network private-link

Digital Twins インスタンスのプライベート リンク操作を管理します。

拡張子 GA
az dt network private-link list

Digital Twins インスタンスに関連付けられているプライベート リンクを一覧表示します。

拡張子 GA
az dt network private-link show

インスタンスに関連付けられているプライベート リンクを表示します。

拡張子 GA
az dt reset

関連付けられている資産を削除して、既存の Digital Twins インスタンスをリセットします。 現時点では、モデルとツインの削除のみがサポートされています。

拡張子 非推奨
az dt role-assignment

Digital Twins インスタンスの RBAC ロールの割り当てを管理します。

拡張子 GA
az dt role-assignment create

Digital Twins インスタンスに対してロールにユーザー、グループ、またはサービス プリンシパルを割り当てます。

拡張子 GA
az dt role-assignment delete

Digital Twins インスタンスからユーザー、グループ、またはサービス プリンシパルロールの割り当てを削除します。

拡張子 GA
az dt role-assignment list

Digital Twins インスタンスの既存のロールの割り当てを一覧表示します。

拡張子 GA
az dt route

イベント ルートを管理および構成します。

拡張子 GA
az dt route create

Digital Twins インスタンスにイベント ルートを追加します。

拡張子 GA
az dt route delete

Digital Twins インスタンスからイベント ルートを削除します。

拡張子 GA
az dt route list

Digital Twins インスタンスの構成済みイベント ルートを一覧表示します。

拡張子 GA
az dt route show

Digital Twins インスタンスで構成されたイベント ルートの詳細を表示します。

拡張子 GA
az dt show

既存の Digital Twins インスタンスを表示します。

拡張子 GA
az dt twin

Digital Twins インスタンスのデジタル ツインを管理および構成します。

拡張子 GA
az dt twin component

Digital Twins インスタンスのデジタル ツイン コンポーネントを表示および更新します。

拡張子 GA
az dt twin component show

デジタル ツイン コンポーネントの詳細を表示します。

拡張子 GA
az dt twin component update

JSON パッチ仕様を使用してデジタル ツイン コンポーネントを更新します。

拡張子 GA
az dt twin create

インスタンスにデジタル ツインを作成します。

拡張子 GA
az dt twin delete

デジタル ツインを削除します。 このツインを参照するすべてのリレーションシップは既に削除されている必要があります。

拡張子 GA
az dt twin delete-all

Digital Twins インスタンス内のすべてのデジタル ツイン (それらのツインのすべてのリレーションシップを含む) を削除します。

拡張子 GA
az dt twin query

インスタンスのデジタル ツインに対してクエリを実行します。 リレーションシップの走査とプロパティ値によるフィルター処理を許可します。

拡張子 GA
az dt twin relationship

Digital Twins インスタンスのデジタル ツインリレーションシップを管理および構成します。

拡張子 GA
az dt twin relationship create

ソースとターゲットのデジタル ツインの間にリレーションシップを作成します。

拡張子 GA
az dt twin relationship delete

Digital Twins インスタンスのデジタル ツインリレーションシップを削除します。

拡張子 GA
az dt twin relationship delete-all

受信リレーションシップを含め、Digital Twins インスタンス内のすべてのデジタル ツイン リレーションシップを削除します。

拡張子 GA
az dt twin relationship list

デジタル ツインのリレーションシップを一覧表示します。

拡張子 GA
az dt twin relationship show

デジタル ツインリレーションシップの詳細を表示します。

拡張子 GA
az dt twin relationship update

JSON パッチ仕様を使用して、2 つのデジタル ツイン間のリレーションシップのプロパティを更新します。

拡張子 GA
az dt twin show

デジタル ツインの詳細を表示します。

拡張子 GA
az dt twin telemetry

Digital Twins インスタンスのイベント ルートとエンドポイントをテストして検証します。

拡張子 GA
az dt twin telemetry send

デジタル ツインに代わってテレメトリを送信します。 コンポーネント パスが指定されている場合、出力されるテレメトリはコンポーネントの代わりに使用されます。

拡張子 GA
az dt twin update

JSON パッチ仕様を使用してインスタンス デジタル ツインを更新します。

拡張子 GA
az dt wait

Digital Twins インスタンスの操作が完了するまで待ちます。

拡張子 GA

az dt create

Digital Twins インスタンスを作成または更新します。

az dt create --dt-name
             --resource-group
             [--assign-identity {false, true}]
             [--location]
             [--mi-system-assigned {false, true}]
             [--mi-user-assigned]
             [--no-wait]
             [--pna {Disabled, Enabled}]
             [--role]
             [--scopes]
             [--tags]

リソース グループの場所を使用して、ターゲット リソース グループにインスタンスを作成します。

az dt create -n {instance_name} -g {resouce_group}

指定した場所とタグを使用して、ターゲット リソース グループにインスタンスを作成します。

az dt create -n {instance_name} -g {resouce_group} -l westus --tags a=b c=d

システム マネージド ID を使用して、ターゲット リソース グループ内にインスタンスを作成します。

az dt create -n {instance_name} -g {resouce_group} --mi-system-assigned

ユーザー マネージド ID を使用して、ターゲット リソース グループ内にインスタンスを作成します。

az dt create -n {instance_name} -g {resouce_group} --mi-user-assigned {resource_id}

システム マネージド ID と複数のユーザー マネージド ID を使用して、ターゲット リソース グループ内にインスタンスを作成します。

az dt create -n {instance_name} -g {resouce_group} --mi-system-assigned --mi-user-assigned {resource_id} {resource_id}

システム マネージド ID を持つターゲット リソース グループにインスタンスを作成し、共同作成者のロールを持つ 1 つ以上のスコープ (スペース区切り) に ID を割り当てます。

az dt create -n {instance_name} -g {resouce_group} --mi-system-assigned --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic"

システム マネージド ID を持つターゲット リソース グループにインスタンスを作成し、カスタム指定ロールを持つ 1 つ以上のスコープに ID を割り当てます。

az dt create -n {instance_name} -g {resouce_group} --mi-system-assigned --scopes "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.EventHub/namespaces/myEventHubNamespace/eventhubs/myEventHub" "/subscriptions/a12345ea-bb21-994d-2263-c716348e32a1/resourceGroups/ProResourceGroup/providers/Microsoft.ServiceBus/namespaces/myServiceBusNamespace/topics/myTopic" --role MyCustomRole

ターゲット リソース グループ内のインスタンスを新しいタグ値で更新し、パブリック ネットワーク アクセスを無効にします。

az dt create -n {instance_name} -g {resouce_group} --tags env=prod --public-network-access Disabled

必須のパラメーター

--dt-name --dtn -n

Digital Twins インスタンス名。

--resource-group -g

Digital Twins インスタンス リソース グループ。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

省略可能のパラメーター

--assign-identity
非推奨

引数 'assign_identity' は非推奨となり、今後のリリースで削除される予定です。 代わりに '--mi-system-assigned' を使用してください。

システムによって生成された ID を Digital Twins インスタンスに割り当てます。

承認された値: false, true
--location -l

Digital Twins インスタンスの場所。 場所が指定されていない場合は、リソース グループの場所が使用されます。を使用して、既定の場所を az configure --defaults location=<name>構成できます。

--mi-system-assigned

システムによって生成された ID をこの Digital Twins インスタンスに割り当てます。

承認された値: false, true
--mi-user-assigned

Digital Twins インスタンスに追加するスペース区切りのユーザー ID リソース ID。

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--pna --public-network-access

Digital Twins インスタンスにパブリック ネットワークからアクセスできるかどうかを判断します。

承認された値: Disabled, Enabled
既定値: Enabled
--role

システム割り当て ID が持つロール名または ID。

既定値: Contributor
--scopes

システム割り当て ID がアクセスできるスペース区切りのスコープ。 --no-wait では使用できません。

--tags

Digital Twins インスタンス タグ。 次の形式のキーと値のペアのプロパティ バッグ: a=b c=d。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az dt delete

既存の Digital Twins インスタンスを削除します。

az dt delete --dt-name
             [--no-wait]
             [--resource-group]
             [--yes]

確認プロンプトを使用して、ブロックする方法で任意のインスタンスを削除します。

az dt delete -n {instance_name}

ブロックまたはプロンプトなしで任意のインスタンスを削除します。

az dt delete -n {instance_name} -y --no-wait

必須のパラメーター

--dt-name --dtn -n

Digital Twins インスタンス名。

省略可能のパラメーター

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False
--resource-group -g

Digital Twins インスタンス リソース グループ。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--yes -y

確認のダイアログを表示しません。

既定値: False
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az dt list

サブスクリプションまたはリソース グループ別に Digital Twins インスタンスのコレクションを一覧表示します。

az dt list [--resource-group]

現在のサブスクリプション内のすべてのインスタンスを一覧表示します。

az dt list

ターゲット リソース グループ内のすべてのインスタンスを一覧表示し、テーブル形式で出力します。

az dt list -g {resource_group} --output table

条件を満たすサブスクリプション内のすべてのインスタンスを一覧表示します。

az dt list --query "[?contains(name, 'Production')]"

条件を満たすインスタンスをカウントします。

az dt list --query "length([?contains(name, 'Production')])"

省略可能のパラメーター

--resource-group -g

Digital Twins インスタンス リソース グループ。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az dt reset

非推奨

このコマンドは非推奨となり、今後のリリースで削除される予定です。 代わりに 'az dt job delete-all create' を使用してください。

関連付けられている資産を削除して、既存の Digital Twins インスタンスをリセットします。 現時点では、モデルとツインの削除のみがサポートされています。

az dt reset --dt-name
            [--resource-group]
            [--yes]

Digital Twins インスタンスのすべての資産をリセットします。

az dt reset -n {instance_name}

必須のパラメーター

--dt-name --dtn -n

Digital Twins インスタンス名。

省略可能のパラメーター

--resource-group -g

Digital Twins インスタンス リソース グループ。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--yes -y

確認のダイアログを表示しません。

既定値: False
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az dt show

既存の Digital Twins インスタンスを表示します。

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

インスタンスを表示します。

az dt show -n {instance_name}

インスタンスとプロジェクトの特定のプロパティを表示します。

az dt show -n {instance_name} --query "{Endpoint:hostName, Location:location}"

必須のパラメーター

--dt-name --dtn -n

Digital Twins インスタンス名。

省略可能のパラメーター

--resource-group -g

Digital Twins インスタンス リソース グループ。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az dt wait

Digital Twins インスタンスの操作が完了するまで待ちます。

az dt wait --dt-name
           [--created]
           [--custom]
           [--deleted]
           [--exists]
           [--interval]
           [--resource-group]
           [--timeout]

任意のインスタンスが作成されるまで待ちます。

az dt wait -n {instance_name} --created

既存のインスタンスが削除されるまで待ちます。

az dt wait -n {instance_name} --deleted

既存のインスタンスの publicNetworkAccess プロパティが Enabled に設定されるまで待ちます

az dt wait -n {instance_name} --custom "publicNetworkAccess=='Enabled'"

必須のパラメーター

--dt-name --dtn -n

Digital Twins インスタンス名。

省略可能のパラメーター

--created

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

既定値: False
--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

--deleted

削除されるまで待ちます。

既定値: False
--exists

リソースが存在するまで待ちます。

既定値: False
--interval

ポーリング間隔 (秒単位)。

既定値: 30
--resource-group -g

Digital Twins インスタンス リソース グループ。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--timeout

最大待機時間 (秒単位)。

既定値: 3600
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。