az bot

Microsoft Azure Bot Service를 관리합니다.

명령

Name	Description	형식	상태
az bot authsetting	봇에서 OAuth 연결 설정을 관리합니다.	핵심	GA
az bot authsetting create	봇에서 OAuth 연결 설정을 만듭니다.	핵심	GA
az bot authsetting delete	봇에서 OAuth 연결 설정을 삭제합니다.	핵심	GA
az bot authsetting list	봇에 모든 OAuth 연결 설정을 표시합니다.	핵심	GA
az bot authsetting list-providers	OAuth 연결 설정을 만드는 데 사용할 수 있는 모든 서비스 공급자에 대한 세부 정보를 나열합니다.	핵심	GA
az bot authsetting show	봇에서 OAuth 연결 설정의 세부 정보를 표시합니다.	핵심	GA
az bot create	새 v4 SDK 봇을 만듭니다.	핵심	GA
az bot delete	기존 봇을 삭제합니다.	핵심	GA
az bot directline	봇에서 Directline 채널을 관리합니다.	핵심	프리뷰
az bot directline create	v3 프로토콜만 사용하도록 설정된 봇에서 DirectLine 채널을 만듭니다.	핵심	프리뷰
az bot directline delete	봇에서 Directline 채널을 삭제합니다.	핵심	프리뷰
az bot directline show	봇에서 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	봇에서 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할 스크립트/구성 파일을 추가합니다.	핵심	GA
az bot prepare-publish	(유지 관리 모드) v3 SDK 봇을 사용하여 az bot publish 다시 게시할 수 있도록 로컬 소스 코드 디렉터리에 스크립트를 추가합니다.	핵심	프리뷰
az bot publish	봇의 연결된 앱 서비스에 게시합니다.	핵심	프리뷰
az bot show	기존 봇을 가져옵니다.	핵심	GA
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	봇에서 전보 채널을 관리합니다.	핵심	프리뷰
az bot telegram create	봇에서 전보 채널을 만듭니다.	핵심	프리뷰
az bot telegram delete	봇에서 전보 채널을 삭제합니다.	핵심	프리뷰
az bot telegram show	봇에서 전보 채널의 세부 정보를 가져옵니다.	핵심	프리뷰
az bot update	기존 봇을 업데이트합니다.	핵심	GA
az bot webchat	봇에서 웹 채팅 채널을 관리합니다.	핵심	GA
az bot webchat show	봇에서 웹 채팅 채널의 세부 정보를 가져옵니다.	핵심	GA

az bot create

새 v4 SDK 봇을 만듭니다.

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

봇에 대한 Microsoft 앱 유형입니다. 가능한 값은 "UserAssignedMSI", "SingleTenant", "MultiTenant"입니다.

--appid

봇과 함께 사용할 MSA ID(Microsoft 계정 ID)입니다.

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

봇에 대한 Microsoft 앱 관리 ID 리소스 ID입니다.

--sku

봇의 Sku입니다.

허용되는 값: F0, S1

Default value: F0

--tags

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

--tenant-id

봇에 대한 Microsoft 앱 테넌트 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

구독의 이름 또는 ID입니다. 를 사용하여 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

구독의 이름 또는 ID입니다. 를 사용하여 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

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az bot prepare-deploy

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

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

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

예제

Node.js IIS web.config 파일을 가져와 'az webapp'을 사용하여 Javascript 봇을 배포하도록 준비합니다.

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

.deployment 파일을 만들어 '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

--code-dir을 기준으로 하는 .csproj 파일의 경로입니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az bot prepare-publish

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

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

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

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

허용되는 값: 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

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az bot publish

미리 보기

이 명령은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

봇의 연결된 앱 서비스에 게시합니다.

소스 코드를 봇의 연결된 앱 서비스에 게시합니다. 이는 v4 봇의 경우 사용되지 않으며 더 이상 v4 봇을 Azure에 게시하는 데 권장되지 않습니다. 대신 v4 봇을 사용하고 az bot prepare-deploy az webapp deployment 배포합니다. 자세한 내용은 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 폴더를 유지하고 App Service에서 실행 npm install 되지 않습니다. 이렇게 하면 Node.js SDK 봇에 대한 게시 명령의 속도를 크게 높일 수 있습니다.

허용되는 값: false, true

--proj-file-path

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

--timeout -t

배포 상태 검사 구성 가능한 시간 제한(초)입니다.

--version -v

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

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

구독의 이름 또는 ID입니다. 를 사용하여 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

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

허용되는 값: 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

구독의 이름 또는 ID입니다. 를 사용하여 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 애플리케이션 봇 분석 데이터를 읽는 데 사용되는 Insights API 키입니다. 분석 블레이드에서 봇에 대한 분석을 보려면 키를 제공합니다.

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

Azure 애플리케이션 봇 분석 데이터를 읽는 데 사용되는 Insights 애플리케이션 ID입니다. 분석 블레이드에서 봇에 대한 분석을 보려면 ID를 제공합니다.

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

Azure 애플리케이션 Insights 키는 봇 분석 데이터를 작성하는 데 사용됩니다. 봇 분석을 받으려면 키를 제공합니다.

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

고객 관리형 키 암호화를 사용하도록 설정하는 키 자격 증명 모음 키 URL입니다.

--cmk-off

암호화를 Microsoft 관리형 키로 설정합니다.

--description

봇의 새 설명입니다.

--display-name -d

봇의 새 표시 이름입니다.

--endpoint -e

봇의 새 엔드포인트입니다. "https://"로 시작해야 합니다.

--icon-url

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

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

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.