az dt endpoint create

Note

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

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

命令

名稱	Description	類型	狀態
az dt endpoint create eventgrid	將 EventGrid 主題端點新增至 Digital Twins 實例。需要預先建立的資源。	Extension	GA
az dt endpoint create eventhub	將 EventHub 端點新增至 Digital Twins 實例。	Extension	GA
az dt endpoint create servicebus	將 ServiceBus 主題端點新增至 Digital Twins 實例。	Extension	GA

az dt endpoint create eventgrid

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

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

az dt endpoint create eventgrid --dt-name --dtn
                                --egt --eventgrid-topic
                                --en --endpoint-name
                                [--deadletter-sas-uri --dsu]
                                [--deadletter-uri --du]
                                [--egg --eventgrid-resource-group]
                                [--egs --eventgrid-subscription]
                                [--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 主題名稱。

屬性	值
參數群組:	Event Grid Topic Arguments

--en --endpoint-name

端點名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--deadletter-sas-uri --dsu

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

屬性	值
參數群組:	Dead-letter Endpoint Arguments

--deadletter-uri --du

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

屬性	值
參數群組:	Dead-letter Endpoint Arguments

--egg --eventgrid-resource-group

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

屬性	值
參數群組:	Event Grid Topic Arguments

--egs --eventgrid-subscription

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

屬性	值
參數群組:	Event Grid Topic Arguments

--no-wait

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

屬性	值
預設值:	False

--resource-group -g

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az dt endpoint create eventhub

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

需要預先建立的資源。

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

az dt endpoint create eventhub --dt-name --dtn
                               --eh --eventhub
                               --ehn --eventhub-namespace
                               --en --endpoint-name
                               [--auth-type {IdentityBased, KeyBased}]
                               [--deadletter-sas-uri --dsu]
                               [--deadletter-uri --du]
                               [--ehg --eventhub-resource-group]
                               [--ehp --eventhub-policy]
                               [--ehs --eventhub-subscription]
                               [--mi-system-assigned --system {false, true}]
                               [--mi-user-assigned --user]
                               [--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 名稱。

屬性	值
參數群組:	Event Hub Arguments

--ehn --eventhub-namespace

EventHub 命名空間標識碼。

屬性	值
參數群組:	Event Hub Arguments

--en --endpoint-name

端點名稱。

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--auth-type

已被取代

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

端點驗證類型。

屬性	值
預設值:	KeyBased
接受的值:	IdentityBased, KeyBased

--deadletter-sas-uri --dsu

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

屬性	值
參數群組:	Dead-letter Endpoint Arguments

--deadletter-uri --du

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

屬性	值
參數群組:	Dead-letter Endpoint Arguments

--ehg --eventhub-resource-group

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

屬性	值
參數群組:	Event Hub Arguments

--ehp --eventhub-policy

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

屬性	值
參數群組:	Event Hub Arguments

--ehs --eventhub-subscription

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

屬性	值
參數群組:	Event Hub Arguments

--mi-system-assigned --system

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

屬性	值
接受的值:	false, true

--mi-user-assigned --user

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

--no-wait

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

屬性	值
預設值:	False

--resource-group -g

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

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

az dt endpoint create servicebus

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

需要預先建立的資源。

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

範例

使用金鑰型驗證，將 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 命名空間標識符。

屬性	值
參數群組:	Service Bus Topic Arguments

--sbt --servicebus-topic

要與整合的 ServiceBus 主題名稱。

屬性	值
參數群組:	Service Bus Topic Arguments

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--auth-type

已被取代

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

端點驗證類型。

屬性	值
預設值:	KeyBased
接受的值:	IdentityBased, KeyBased

--deadletter-sas-uri --dsu

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

屬性	值
參數群組:	Dead-letter Endpoint Arguments

--deadletter-uri --du

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

屬性	值
參數群組:	Dead-letter Endpoint Arguments

--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 實例資源群組。

屬性	值
參數群組:	Service Bus Topic Arguments

--sbp --servicebus-policy

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

屬性	值
參數群組:	Service Bus Topic Arguments

--sbs --servicebus-subscription

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

屬性	值
參數群組:	Service Bus Topic Arguments

全域參數

--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性	值
預設值:	False

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性	值
預設值:	False

--output -o

輸出格式。

屬性	值
預設值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

增加記錄的詳細程度。針對完整偵錯記錄使用 --debug。

屬性	值
預設值:	False

意見反應

此頁面對您有幫助嗎？

共用方式為

az dt endpoint create

命令

az dt endpoint create eventgrid

範例

必要參數

選擇性參數

az dt endpoint create eventhub

範例

必要參數

選擇性參數

az dt endpoint create servicebus

範例

必要參數

選擇性參數

意見反應