共用方式為

az dt endpoint create

  • 參考

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分（2.46.0 版或更高版本）。 擴充功能會在您第一次執行 az dt endpoint create 命令時自動安裝。 深入了解擴充功能。

將輸出端點新增至 Digital Twins 實例。

命令

名稱 Description 類型 狀態
az dt endpoint create eventgrid

將 EventGrid 主題端點新增至 Digital Twins 實例。 需要預先建立的資源。

 副檔名 GA
az dt endpoint create eventhub

將 EventHub 端點新增至 Digital Twins 實例。

 副檔名 GA
az dt endpoint create servicebus

將 ServiceBus 主題端點新增至 Digital Twins 實例。

 副檔名 GA

az dt endpoint create eventgrid

將 EventGrid 主題端點新增至 Digital Twins 實例。 需要預先建立的資源。

EventGrid 主題端點不支援身分識別型端點整合。

az dt endpoint create eventgrid --dt-name
                                --egt
                                --en
                                [--deadletter-sas-uri]
                                [--deadletter-uri]
                                [--egg]
                                [--egs]
                                [--no-wait]
                                [--resource-group]

範例

將 EventGrid 主題端點新增至目標實例。

az dt endpoint create eventgrid --endpoint-name {endpoint_name} --eventgrid-resource-group {eventgrid_resource_group} --eventgrid-topic {eventgrid_topic_name} -n {instance_name}

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱。

--egt --eventgrid-topic

要與整合的 EventGrid 主題名稱。

--en --endpoint-name

端點名稱。

選擇性參數

--deadletter-sas-uri --dsu

使用 SAS 令牌進行金鑰型驗證的寄不出的信件記憶體容器 URL。

--deadletter-uri --du

身分識別型驗證的寄不出的信件記憶體容器 URL。

--egg --eventgrid-resource-group

EventGrid 主題資源群組的名稱。 如果未提供，則會使用 Digital Twin 實例資源群組。

--egs --eventgrid-subscription

端點資源所在的訂用帳戶名稱或標識碼。 如果未提供任何訂用帳戶，則會使用預設訂用帳戶。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--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

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az dt endpoint create eventhub

將 EventHub 端點新增至 Digital Twins 實例。

需要預先建立的資源。

實例必須具有系統指派的身分識別，才能支持系統指派的身分識別型端點整合。 實例必須具有相關聯的使用者指派身分識別，以支援使用者指派的身分識別型端點整合。

az dt endpoint create eventhub --dt-name
                               --eh
                               --ehn
                               --en
                               [--auth-type {IdentityBased, KeyBased}]
                               [--deadletter-sas-uri]
                               [--deadletter-uri]
                               [--ehg]
                               [--ehp]
                               [--ehs]
                               [--mi-system-assigned {false, true}]
                               [--mi-user-assigned]
                               [--no-wait]
                               [--resource-group]

範例

使用金鑰型驗證，將 EventHub 端點新增至目標實例。

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --eventhub-policy {eventhub_policy} -n {instance_name}

使用系統指派的身分識別進行驗證，將 EventHub 端點新增至目標實例。

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --mi-system-assigned -n {instance_name}

使用使用者指派的身分識別進行驗證，將 EventHub 端點新增至目標實例。

az dt endpoint create eventhub --endpoint-name {endpoint_name} --eventhub-resource-group {eventhub_resource_group} --eventhub-namespace {eventhub_namespace} --eventhub {eventhub_name} --mi-user-assigned {resource_id} -n {instance_name}

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱。

--eh --eventhub

要與整合的 EventHub 名稱。

--ehn --eventhub-namespace

EventHub 命名空間標識碼。

--en --endpoint-name

端點名稱。

選擇性參數

--auth-type
已被取代

自變數 'auth_type' 已被取代，並將在未來版本中移除。 請改用 「身分識別」。

端點驗證類型。

接受的值: IdentityBased, KeyBased
預設值: KeyBased
--deadletter-sas-uri --dsu

使用 SAS 令牌進行金鑰型驗證的寄不出的信件記憶體容器 URL。

--deadletter-uri --du

身分識別型驗證的寄不出的信件記憶體容器 URL。

--ehg --eventhub-resource-group

EventHub 資源群組的名稱。 如果未提供，則會使用 Digital Twin 實例資源群組。

--ehp --eventhub-policy

要用於端點設定的 EventHub 原則。 --auth-type 為 KeyBased 時的必要專案。

--ehs --eventhub-subscription

端點資源所在的訂用帳戶名稱或標識碼。 如果未提供任何訂用帳戶，則會使用預設訂用帳戶。

--mi-system-assigned --system

使用系統指派的受控識別進行端點驗證。

接受的值: false, true
--mi-user-assigned --user

使用使用者指派的受控識別進行端點驗證。 接受識別資源標識碼。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--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

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az dt endpoint create servicebus

將 ServiceBus 主題端點新增至 Digital Twins 實例。

需要預先建立的資源。

實例必須具有系統指派的身分識別，才能支持系統指派的身分識別型端點整合。 實例必須具有相關聯的使用者指派身分識別，以支援使用者指派的身分識別型端點整合。

az dt endpoint create servicebus --dt-name
                                 --en
                                 --sbn
                                 --sbt
                                 [--auth-type {IdentityBased, KeyBased}]
                                 [--deadletter-sas-uri]
                                 [--deadletter-uri]
                                 [--mi-system-assigned {false, true}]
                                 [--mi-user-assigned]
                                 [--no-wait]
                                 [--resource-group]
                                 [--sbg]
                                 [--sbp]
                                 [--sbs]

範例

使用金鑰型驗證，將 ServiceBus 主題端點新增至目標實例。

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --servicebus-policy {servicebus_policy} -n {instance_name}

使用系統指派的身分識別進行驗證，將 ServiceBus 主題端點新增至目標實例。

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --mi-system-assigned -n {instance_name}

使用使用者指派的身分識別進行驗證，將 ServiceBus 主題端點新增至目標實例。

az dt endpoint create servicebus --endpoint-name {endpoint_name} --servicebus-resource-group {servicebus_resource_group} --servicebus-namespace {servicebus_namespace} --servicebus-topic {servicebus_topic_name} --mi-user-assigned {resource_id} -n {instance_name}

必要參數

--dt-name --dtn -n

Digital Twins 實例名稱。

--en --endpoint-name

端點名稱。

--sbn --servicebus-namespace

ServiceBus 命名空間標識符。

--sbt --servicebus-topic

要與整合的 ServiceBus 主題名稱。

選擇性參數

--auth-type
已被取代

自變數 'auth_type' 已被取代，並將在未來版本中移除。 請改用 「身分識別」。

端點驗證類型。

接受的值: IdentityBased, KeyBased
預設值: KeyBased
--deadletter-sas-uri --dsu

使用 SAS 令牌進行金鑰型驗證的寄不出的信件記憶體容器 URL。

--deadletter-uri --du

身分識別型驗證的寄不出的信件記憶體容器 URL。

--mi-system-assigned --system

使用系統指派的受控識別進行端點驗證。

接受的值: false, true
--mi-user-assigned --user

使用使用者指派的受控識別進行端點驗證。 接受識別資源標識碼。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

Digital Twins 實例資源群組。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--sbg --servicebus-resource-group

ServiceBus 資源群組的名稱。 如果未提供，則會使用 Digital Twin 實例資源群組。

--sbp --servicebus-policy

要用於端點設定的 ServiceBus 主題原則。 --auth-type 為 KeyBased 時的必要專案。

--sbs --servicebus-subscription

端點資源所在的訂用帳戶名稱或標識碼。 如果未提供任何訂用帳戶，則會使用預設訂用帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。