az bot

Microsoft Azure Bot Service를 관리 합니다.

명령

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

새 v4 SDK 봇을 만듭니다.

az bot delete

기존 봇을 삭제 합니다.

az bot directline

봇에서 Directline 채널을 관리 합니다.

az bot directline create

V3 프로토콜만 사용 하도록 설정 된 봇에서 DirectLine 채널을 만듭니다.

az bot directline delete

봇에서 Directline 채널을 삭제 합니다.

az bot directline show

Bot의 Directline 채널에 대 한 세부 정보를 가져옵니다.

az bot directline update

V3 프로토콜만 사용 하도록 설정 된 봇에서 DirectLine 채널을 업데이트 합니다.

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

Bot의 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

(유지 관리 모드) V3 SDK 봇 용을 사용 하 여 다시 게시할 수 있도록 로컬 소스 코드 디렉터리에 스크립트를 추가 az bot publish 합니다.

az bot publish

Bot의 연결 된 app service에 게시 합니다.

az bot show

기존 봇을 가져옵니다.

az bot skype

봇에서 Skype 채널을 관리 합니다.

az bot skype create

봇에 Skype 채널을 만듭니다.

az bot skype delete

봇에서 Skype 채널을 삭제 합니다.

az bot skype show

bot의 Skype 채널에 대 한 세부 정보를 가져옵니다.

az bot slack

봇에서 여유 채널을 관리 합니다.

az bot slack create

봇에 여유 채널을 만듭니다.

az bot slack delete

봇에서 여유 채널을 삭제 합니다.

az bot slack show

봇에서 여유 시간 채널의 세부 정보를 가져옵니다.

az bot sms

봇에서 SMS 채널을 관리 합니다.

az bot sms create

Bot에 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

봇에서 웹 채팅 채널을 관리합니다.

az bot webchat show

봇의 웹 채팅 채널에 대한 세부 정보를 얻습니다.

az bot create

새 v4 SDK 봇을 만듭니다.

새 v4 SDK 봇을 만듭니다.

az bot create --appid
              --kind {registration, webapp}
              --name
              --resource-group
              [--cmk]
              [--description]
              [--display-name]
              [--echo {false, true}]
              [--endpoint]
              [--lang {Csharp, Javascript}]
              [--location]
              [--password]
              [--sku {F0, S1}]
              [--subscription]
              [--tags]

필수 매개 변수

--appid

봇에서 사용할 Microsoft 계정 ID(MSA ID)입니다.

--kind -k

봇의 종류입니다.

허용되는 값: registration, webapp
--name -n

봇의 리소스 이름입니다. 봇 이름은 4자~42자여야 합니다. 봇 이름에는 -, a - z, A - Z, 0 - 9 및 _ 문자만 사용할 수 있습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

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

고객 관리 키 암호화를 사용 하도록 설정 하는 key vault 키 url입니다.

--description -d

Bot에 대 한 설명입니다.

--display-name

Bot의 표시 이름입니다. 지정 하지 않으면 기본값은 봇의 이름입니다.

--echo

새로 만든 v4 웹 앱 봇에 Echo Bot template을 배포 합니다.

허용되는 값: false, true
--endpoint -e

Bot의 메시징 끝점입니다.

--lang

Bot을 만드는 데 사용할 언어입니다.

허용되는 값: Csharp, Javascript
--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

기본값: Central US
--password -p

봇의 Microsoft 계정(MSA) 암호입니다. Bot에서 전송 되는 메시지에 권한을 부여 하는 데 사용 됩니다. "--Kind"가 "webapp" 일 때 필요 합니다.

--sku

봇의 Sku입니다.

허용되는 값: F0, S1
기본값: F0
--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

--tags

공백으로 구분 된 태그: 키 [= 값] [키 [= 값] ...]. ""를 사용 하 여 기존 태그를 지웁니다.

az bot delete

기존 봇을 삭제 합니다.

az bot delete --name
              --resource-group
              [--subscription]

필수 매개 변수

--name -n

봇의 리소스 이름입니다. 봇 이름은 4자~42자여야 합니다. 봇 이름에는 -, a - z, A - Z, 0 - 9 및 _ 문자만 사용할 수 있습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

az bot download

기존 봇을 다운로드 합니다.

소스 코드는 봇과 연결 된 웹 앱에서 다운로드 됩니다. 그런 다음 해당 파일을 변경 하 고 앱에 다시 게시할 수 있습니다.

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

필수 매개 변수

--name -n

봇의 리소스 이름입니다. 봇 이름은 4자~42자여야 합니다. 봇 이름에는 -, a - z, A - Z, 0 - 9 및 _ 문자만 사용할 수 있습니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--save-path

Bot 코드를 다운로드할 디렉터리입니다.

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

az bot prepare-deploy

를 사용 하 여 게시할 스크립트/구성 파일을 추가 az webapp deployment 합니다.

를 사용 하 여 게시할 수 있도록 로컬 소스 코드 디렉터리의 루트에 스크립트나 구성 파일을 추가 az webapp deployment 합니다. App Service에 코드를 배포 하면 생성 된 스크립트나 구성 파일이 D:homesitewwwroot on App Service의 Kudu 웹 페이지에 표시 됩니다.

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

예제

`az webapp`Node.js IIS web.config 파일을 가져와 Javascript bot을 배포 하는 데 사용할 준비를 합니다.

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

Bot의 언어 또는 런타임입니다.

허용되는 값: Csharp, Javascript, Typescript

선택적 매개 변수

--code-dir

생성 된 배포 파일을 저장할 디렉터리입니다. 는 명령이 호출 되는 현재 디렉터리로 기본 설정 됩니다.

--proj-file-path

--Code-dir에 상대적인 .csproj 파일의 경로입니다.

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

az bot prepare-publish

(유지 관리 모드) V3 SDK 봇 용을 사용 하 여 다시 게시할 수 있도록 로컬 소스 코드 디렉터리에 스크립트를 추가 az bot publish 합니다.

az bot prepare-publish --name
                       --proj-file-path
                       --resource-group
                       --sln-name
                       [--code-dir]
                       [--subscription]
                       [--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

배포 스크립트를 다운로드할 디렉터리입니다.

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

--version -v

만들 봇 템플릿에서 사용할 Microsoft Bot Builder SDK 버전입니다.

허용되는 값: v3, v4
기본값: v3

az bot publish

Bot의 연결 된 app service에 게시 합니다.

Bot의 연결 된 app service에 소스 코드를 게시 합니다. 이는 v4 봇에서 사용 되지 않으며 Azure에 v4 봇을 게시 하는 데 더 이상 권장 되지 않습니다. 대신 az bot prepare-deployaz webapp deployment 를 사용 하 여 v4 봇을 배포 합니다. 자세한 내용은 https://aka.ms/deploy-your-bot를 참조하세요.

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

예제

Bot code 폴더 내에서 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 폴더를 유지 하 고 App Service 실행 하지 않습니다 npm install . 이렇게 하면 Node.js SDK bot의 게시 명령을 크게 단축할 수 있습니다.

허용되는 값: false, true
--proj-file-path

시작 프로젝트 파일 이름에 대 한 경로입니다. (예: "./EchoBotWithCounter.csproj").

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

--timeout -t

배포 상태를 확인 하는 구성 가능한 제한 시간 (초)입니다.

--version -v

Microsoft Bot Builder SDK 버전의 봇입니다.

기본값: v4

az bot show

기존 봇을 가져옵니다.

기존 봇에 대 한 정보를 가져옵니다. Bot에 연결 하는 데 필요한 정보를 가져오려면 명령과 함께--msbot 플래그를 사용 합니다.

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

예제

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

출력을 bot 파일과 호환 되는 JSON으로 표시 합니다.

허용되는 값: false, true
--query-examples

JMESPath 문자열을 권장 합니다. 쿼리 중 하나를 복사 하 여 결과를 볼 수 있도록 큰따옴표 내에서--query 매개 변수 뒤에 붙여 넣을 수 있습니다. 이러한 주요 단어를 기준으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

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}]
              [--subscription]
              [--tags]

예제

Bot 설명 업데이트

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 애플리케이션 Insights API 키입니다. 분석 블레이드에서 봇에 대 한 분석을 보려면 키를 입력 합니다.

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

bot 분석 데이터를 읽는 데 사용 되는 Azure 애플리케이션 Insights 응용 프로그램 ID입니다. 분석 블레이드에서 봇에 대 한 분석을 보려면 Id를 입력 합니다.

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

bot 분석 데이터를 작성 하는 데 사용 되는 Azure 애플리케이션 Insights 키입니다. Bot analytics를 수신 하려면 키를 제공 합니다.

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

고객 관리 키 암호화를 사용 하도록 설정 하는 key vault 키 url입니다.

--cmk-off

암호화를 Microsoft-Managed 키로 설정 합니다.

--description

Bot의 새 설명입니다.

--display-name -d

Bot의 새 표시 이름입니다.

--endpoint -e

Bot의 새 끝점입니다. "Https://"로 시작 해야 합니다.

--icon-url

Bot 아바타의 아이콘 URL입니다. 파일 크기가 30KB 인 PNG 파일을 허용 합니다.

--sku

봇의 Sku입니다.

허용되는 값: F0, S1
--subscription

구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .

--tags

공백으로 구분 된 태그: 키 [= 값] [키 [= 값] ...]. ""를 사용 하 여 기존 태그를 지웁니다.