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

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

значение по умолчанию: global
--msi-resource-id

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

--sku

Sku бота.

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

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

--tenant-id

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

Глобальные параметры
--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 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
значение по умолчанию: 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
значение по умолчанию: 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 путем получения файла web.config Node.js IIS.

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
значение по умолчанию: 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
значение по умолчанию: v3
Глобальные параметры
--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 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 для бота.

значение по умолчанию: v4
Глобальные параметры
--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 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
значение по умолчанию: 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

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

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

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

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

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

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

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

--cmk-off

Задайте для шифрования ключи, управляемые корпорацией Майкрософт.

--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
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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