Поделиться через

az bot

  • Ссылка

Управление Служба Bot Microsoft Azure.

Команды

Имя Описание Тип Состояние
az bot authsetting

Управление параметрами подключения OAuth в боте.

 Ядро ГА
az bot authsetting create

Создайте параметр подключения OAuth в боте.

 Ядро ГА
az bot authsetting delete

Удалите параметр подключения OAuth в боте.

 Ядро ГА
az bot authsetting list

Отображение всех параметров подключения OAuth в боте.

 Ядро ГА
az bot authsetting list-providers

Список сведений обо всех поставщиках услуг, доступных для создания параметров подключения OAuth.

 Ядро ГА
az bot authsetting show

Отображение сведений о параметре подключения OAuth в боте.

 Ядро ГА
az bot create

Создайте бот пакета SDK версии 4.

 Ядро ГА
az bot delete

Удаление существующего бота.

 Ядро ГА
az bot directline

Управление каналом Directline на боте.

 Ядро Предварительный просмотр
az bot directline create

Создайте канал DirectLine на боте с включенным протоколом версии 3.

 Ядро Предварительный просмотр
az bot directline delete

Удалите канал Directline в боте.

 Ядро Предварительный просмотр
az bot directline show

Получение сведений о канале Directline на боте.

 Ядро Предварительный просмотр
az bot directline update

Обновите канал DirectLine в боте только с включенным протоколом версии 3.

 Ядро Предварительный просмотр
az bot download

Скачайте существующий бот.

 Ядро Предварительный просмотр
az bot email

Управление каналом электронной почты в боте.

 Ядро Предварительный просмотр
az bot email create

Создайте канал электронной почты в боте.

 Ядро Предварительный просмотр
az bot email delete

Удалите канал электронной почты в боте.

 Ядро Предварительный просмотр
az bot email show

Получение сведений о канале электронной почты в боте.

 Ядро Предварительный просмотр
az bot facebook

Управление каналом Facebook на боте.

 Ядро Предварительный просмотр
az bot facebook create

Создайте канал Facebook на боте.

 Ядро Предварительный просмотр
az bot facebook delete

Удалите канал Facebook на боте.

 Ядро Предварительный просмотр
az bot facebook show

Получение сведений о канале Facebook на боте.

 Ядро Предварительный просмотр
az bot kik

Управление каналом Kik на боте.

 Ядро Предварительный просмотр
az bot kik create

Создайте Канал Kik на боте.

 Ядро Предварительный просмотр
az bot kik delete

Удалите Канал Kik на боте.

 Ядро Предварительный просмотр
az bot kik show

Получение сведений о Канале Kik на боте.

 Ядро Предварительный просмотр
az bot msteams

Управление каналом Microsoft Teams на боте.

 Ядро Предварительный просмотр
az bot msteams create

Создайте канал Microsoft Teams на боте.

 Ядро Предварительный просмотр
az bot msteams delete

Удалите канал Microsoft Teams на боте.

 Ядро Предварительный просмотр
az bot msteams show

Получение сведений о канале Microsoft Teams в боте.

 Ядро Предварительный просмотр
az bot prepare-deploy

Добавьте файлы скриптов и конфигурации для публикации с az webapp deployment.

 Ядро ГА
az bot prepare-publish

(режим обслуживания) Добавьте скрипты в локальный каталог исходного кода, чтобы иметь возможность публиковать обратно с помощью az bot publish для ботов пакета SDK версии 3.

 Ядро Предварительный просмотр
az bot publish

Публикация в связанной службе приложений бота.

 Ядро Предварительный просмотр
az bot show

Получите существующего бота.

 Ядро ГА
az bot skype

Управление каналом Skype на боте.

 Ядро Предварительный просмотр
az bot skype create

Создайте канал Skype на боте.

 Ядро Предварительный просмотр
az bot skype delete

Удалите канал Skype на боте.

 Ядро Предварительный просмотр
az bot skype show

Получение сведений о канале Skype на боте.

 Ядро Предварительный просмотр
az bot slack

Управление каналом Slack на боте.

 Ядро Предварительный просмотр
az bot slack create

Создайте канал Slack на боте.

 Ядро Предварительный просмотр
az bot slack delete

Удалите канал Slack на боте.

 Ядро Предварительный просмотр
az bot slack show

Получение сведений о канале Slack на боте.

 Ядро Предварительный просмотр
az bot sms

Управление SMS-каналом в боте.

 Ядро Предварительный просмотр
az bot sms create

Создайте SMS-канал в боте.

 Ядро Предварительный просмотр
az bot sms delete

Удалите SMS-канал в боте.

 Ядро Предварительный просмотр
az bot sms show

Получение сведений о SMS-канале в боте.

 Ядро Предварительный просмотр
az bot telegram

Управление каналом Telegram на боте.

 Ядро Предварительный просмотр
az bot telegram create

Создайте канал Telegram на боте.

 Ядро Предварительный просмотр
az bot telegram delete

Удалите канал Telegram на боте.

 Ядро Предварительный просмотр
az bot telegram show

Получение сведений о канале Telegram на боте.

 Ядро Предварительный просмотр
az bot update

Обновление существующего бота.

 Ядро ГА
az bot webchat

Управление каналом Webchat на боте.

 Ядро ГА
az bot webchat show

Получение сведений о канале Webchat на боте.

 Ядро ГА

az bot create

Изменить

Создайте бот пакета SDK версии 4.

az bot create --app-type
              --appid
              --name
              --resource-group
              [--cmk]
              [--description]
              [--display-name]
              [--endpoint]
              [--location]
              [--msi-resource-id]
              [--sku {F0, S1}]
              [--tags]
              [--tenant-id]

Обязательные параметры

--app-type

Тип приложения Майкрософт для бота. Возможные значения: UserAssignedMSI, SingleTenant, MultiTenant.

--appid

Идентификатор учетной записи Майкрософт (ИДЕНТИФИКАТОР MSA), используемый с ботом.

--name -n

Имя ресурса бота. Имя бота должно содержать от 4 до 42 символов. Имя бота может состоять только из этих символов: -, a–z, A–Z, 0–9 и _.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--cmk --cmk-key-vault-key-url

URL-адрес ключа хранилища ключей для включения шифрования управляемых клиентом ключей.

--description -d

Описание бота.

--display-name

Отображаемое имя бота. Если не указано, по умолчанию используется имя бота.

--endpoint -e

Конечная точка обмена сообщениями бота.

--location -l

Местоположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

Default value: global
--msi-resource-id

Идентификатор ресурса управляемого удостоверения приложения Майкрософт для бота.

--sku

Sku бота.

Допустимые значения: F0, S1
Default value: F0
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

--tenant-id

Идентификатор клиента приложения Майкрософт для бота.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az bot delete

Изменить

Удаление существующего бота.

az bot delete --name
              --resource-group

Обязательные параметры

--name -n

Имя ресурса бота. Имя бота должно содержать от 4 до 42 символов. Имя бота может состоять только из этих символов: -, 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
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az bot download

Изменить
Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Скачайте существующий бот.

Исходный код скачан из веб-приложения, связанного с ботом. Затем вы можете внести в него изменения и опубликовать его обратно в приложении.

az bot download --name
                --resource-group
                [--save-path]

Обязательные параметры

--name -n

Имя ресурса бота. Имя бота должно содержать от 4 до 42 символов. Имя бота может состоять только из этих символов: -, a–z, A–Z, 0–9 и _.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--save-path

Каталог для скачивания кода бота в.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az bot prepare-deploy

Изменить

Добавьте файлы скриптов и конфигурации для публикации с az webapp deployment.

Добавьте скрипты или файлы конфигурации в корневой каталог локального исходного кода, чтобы можно было опубликовать с помощью az webapp deployment. При развертывании кода в службе приложений созданные скрипты или файлы конфигурации должны отображаться на веб-странице Kudu службы приложений D:\home\site\wwwroot на веб-странице Kudu службы приложений.

az bot prepare-deploy --lang {Csharp, Javascript, Typescript}
                      [--code-dir]
                      [--proj-file-path]

Примеры

Подготовка к использованию az webapp для развертывания бота Javascript путем получения файла Node.js IIS web.config.

az bot prepare-deploy --lang Javascript --code-dir "MyBotCode"

Подготовка к использованию az webapp для развертывания бота Csharp путем создания файла развертывания.

az bot prepare-deploy --lang Csharp --code-dir "." --proj-file-path "MyBot.csproj"

Обязательные параметры

--lang

Язык или среда выполнения бота.

Допустимые значения: Csharp, Javascript, Typescript

Необязательные параметры

--code-dir

Каталог для размещения созданных файлов развертывания. По умолчанию используется текущий каталог, из которой вызывается команда.

--proj-file-path

Путь к CSPROJ-файлу относительно --code-dir.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az bot prepare-publish

Изменить
Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

(режим обслуживания) Добавьте скрипты в локальный каталог исходного кода, чтобы иметь возможность публиковать обратно с помощью az bot publish для ботов пакета SDK версии 3.

az bot prepare-publish --name
                       --proj-file-path
                       --resource-group
                       --sln-name
                       [--code-dir]
                       [--version {v3, v4}]

Обязательные параметры

--name -n

Имя ресурса бота. Имя бота должно содержать от 4 до 42 символов. Имя бота может состоять только из этих символов: -, a–z, A–Z, 0–9 и _.

--proj-file-path

Путь к имени файла проекта запуска. (Например, "./EchoBotWithCounter.csproj") Требуется только для C#.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--sln-name

Имя файла начального решения. Требуется только для C#.

Необязательные параметры

--code-dir

Каталог для скачивания скриптов развертывания.

--version -v

Версия пакета SDK для Microsoft Bot Builder, используемая в шаблоне бота, который будет создан.

Допустимые значения: v3, v4
Default value: v3
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az bot publish

Изменить
Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Публикация в связанной службе приложений бота.

Опубликуйте исходный код в связанной службе приложений бота. Это не рекомендуется для ботов версии 4 и больше не рекомендуется публиковать боты версии 4 в Azure. Вместо этого используйте az bot prepare-deploy и az webapp deployment для развертывания бота версии 4. Дополнительные сведения см. в https://aka.ms/deploy-your-bot.

az bot publish --name
               --resource-group
               [--code-dir]
               [--keep-node-modules {false, true}]
               [--proj-file-path]
               [--timeout]
               [--version]

Примеры

Публикация исходного кода в приложении Azure из папки кода бота

az bot publish -n botName -g MyResourceGroup

Обязательные параметры

--name -n

Имя ресурса бота. Имя бота должно содержать от 4 до 42 символов. Имя бота может состоять только из этих символов: -, a–z, A–Z, 0–9 и _.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--code-dir

Каталог для отправки кода бота из.

--keep-node-modules

Сохраняйте папку node_modules и не выполняйте npm install в службе приложений. Это может значительно ускорить публикацию команд для ботов пакета SDK Node.js.

Допустимые значения: false, true
--proj-file-path

Путь к имени файла проекта запуска. (Например, "./EchoBotWithCounter.csproj").

--timeout -t

Настраиваемое время ожидания в секундах для проверки состояния развертывания.

--version -v

Версия пакета SDK microsoft Bot Builder для бота.

Default value: v4
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az bot show

Изменить

Получите существующего бота.

Получение сведений о существующем боте. Чтобы получить сведения, необходимые для подключения к боту, используйте флаг --msbot с командой.

az bot show --name
            --resource-group
            [--msbot {false, true}]

Примеры

Получение сведений, необходимых для подключения к существующему боту в Azure

az bot show -n botName -g MyResourceGroup --msbot

Обязательные параметры

--name -n

Имя ресурса бота. Имя бота должно содержать от 4 до 42 символов. Имя бота может состоять только из этих символов: -, a–z, A–Z, 0–9 и _.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--msbot

Отображение выходных данных в формате JSON, совместимого с .bot-файлом.

Допустимые значения: false, true
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az bot update

Изменить

Обновление существующего бота.

az bot update --name
              --resource-group
              [--ai-api-key]
              [--ai-app-id]
              [--ai-key]
              [--cmk]
              [--cmk-off]
              [--description]
              [--display-name]
              [--endpoint]
              [--icon-url]
              [--sku {F0, S1}]
              [--tags]

Примеры

Обновление описания бота

az bot update -n botName -g MyResourceGroup --endpoint "https://bing.com/api/messages" --display-name "Hello World"

Обязательные параметры

--name -n

Имя ресурса бота. Имя бота должно содержать от 4 до 42 символов. Имя бота может состоять только из этих символов: -, a–z, A–Z, 0–9 и _.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

--ai-api-key --app-insights-api-key

Ключ API Azure Application Insights, используемый для чтения данных аналитики ботов. Укажите ключ, если вы хотите просмотреть аналитику о боте в колонке "Аналитика".

--ai-app-id --app-insights-app-id

Идентификатор приложения Azure Application Insights, используемый для чтения данных аналитики бота. Укажите идентификатор, если вы хотите просмотреть аналитику о боте в колонке "Аналитика".

--ai-key --app-insights-key

Ключ Azure Application Insights, используемый для записи данных аналитики бота. Укажите ключ, если вы хотите получить аналитику бота.

--cmk --cmk-key-vault-key-url

URL-адрес ключа хранилища ключей для включения шифрования управляемых клиентом ключей.

--cmk-off

Задайте для шифрования значение Microsoft-Managed Ключей.

--description

Новое описание бота.

--display-name -d

Новое отображаемое имя бота.

--endpoint -e

Новая конечная точка бота. Должен начинаться с "https://".

--icon-url

URL-адрес значка для аватара бота. Принимает PNG-файлы с ограничением размера файла размером 30 КБ.

--sku

Sku бота.

Допустимые значения: F0, S1
--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.