az bot directline

此命令群組處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

管理 Bot 上的 Directline 通道。

命令

名稱	Description	類型	狀態
az bot directline create	在僅啟用 v3 通訊協定的 Bot 上建立 DirectLine 通道。	核心	預覽​​
az bot directline delete	刪除 Bot 上的 Directline 通道。	核心	預覽​​
az bot directline show	取得 Bot 上 Directline 通道的詳細數據。	核心	預覽​​
az bot directline update	僅啟用 v3 通訊協定的 Bot 上更新 DirectLine 通道。	核心	預覽​​

az bot directline create

預覽

命令群組 『bot directline』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

在僅啟用 v3 通訊協定的 Bot 上建立 DirectLine 通道。

az bot directline create --name
                         --resource-group
                         [--add-disabled {false, true}]
                         [--disablev1 {false, true}]
                         [--disablev3 {false, true}]
                         [--enable-enhanced-auth {false, true}]
                         [--location]
                         [--site-name]
                         [--trusted-origins]

範例

建立 Bot 的 DirectLine 通道。

az bot directline create -n botName -g MyResourceGroup --disablev1

必要參數

--name -n

Bot 的資源名稱。 Bot 名稱長度必須介於 4 到 42 個字元之間。 Bot 名稱只能包含下列字元：-、a 到 z、A 到 Z、0 到 9 和 _。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--add-disabled

以停用狀態新增通道。

接受的值: false, true

--disablev1

如果為 true，則會在通道上停用 v1 通訊協定。

接受的值: false, true

--disablev3

如果為 true，則會在通道上停用 v3 通訊協定。

接受的值: false, true

--enable-enhanced-auth

如果為 true，請啟用增強的驗證功能。 --trusted-origins 參數必須成立才能運作。

接受的值: false, true

預設值: False

--location -l

位置。​​ 值的來源：az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

預設值: global

--site-name -s

Directline 信道網站的名稱。

預設值: Default Site

--trusted-origins

空白分隔的受信任來源 URL（必須使用 HTTPS），例如 --trusted-origins https://mybotsite1.azurewebsites.net https://mybotsite2.azurewebsites.net。

全域參數

--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 bot directline delete

預覽

命令群組 『bot directline』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

刪除 Bot 上的 Directline 通道。

az bot directline delete --name
                         --resource-group

必要參數

--name -n

Bot 的資源名稱。 Bot 名稱長度必須介於 4 到 42 個字元之間。 Bot 名稱只能包含下列字元：-、a 到 z、A 到 Z、0 到 9 和 _。

--resource-group -g

資源群組的名稱。 您可以使用 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 bot directline show

預覽

命令群組 『bot directline』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

取得 Bot 上 Directline 通道的詳細數據。

az bot directline show --name
                       --resource-group
                       [--with-secrets {false, true}]

必要參數

--name -n

Bot 的資源名稱。 Bot 名稱長度必須介於 4 到 42 個字元之間。 Bot 名稱只能包含下列字元：-、a 到 z、A 到 Z、0 到 9 和 _。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--with-secrets

顯示回應通道的秘密。

接受的值: false, true

全域參數

--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 bot directline update

預覽

命令群組 『bot directline』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

僅啟用 v3 通訊協定的 Bot 上更新 DirectLine 通道。

az bot directline update --name
                         --resource-group
                         [--add-disabled {false, true}]
                         [--disablev1 {false, true}]
                         [--disablev3 {false, true}]
                         [--enable-enhanced-auth {false, true}]
                         [--site-name]
                         [--trusted-origins]

範例

更新 Bot 的 DirectLine 通道。

az bot directline update -n botName -g MyResourceGroup --disablev1

必要參數

--name -n

Bot 的資源名稱。 Bot 名稱長度必須介於 4 到 42 個字元之間。 Bot 名稱只能包含下列字元：-、a 到 z、A 到 Z、0 到 9 和 _。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--add-disabled

以停用狀態新增通道。

接受的值: false, true

--disablev1

如果為 true，則會在通道上停用 v1 通訊協定。

接受的值: false, true

--disablev3

如果為 true，則會在通道上停用 v3 通訊協定。

接受的值: false, true

--enable-enhanced-auth

如果為 true，請啟用增強的驗證功能。 --trusted-origins 參數必須成立才能運作。

接受的值: false, true

預設值: False

--site-name -s

Directline 信道網站的名稱。

預設值: Default Site

--trusted-origins

空白分隔的受信任來源 URL（必須使用 HTTPS），例如 --trusted-origins https://mybotsite1.azurewebsites.net https://mybotsite2.azurewebsites.net。

全域參數

--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 來取得完整偵錯記錄。