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