az bot

Mengelola Microsoft Azure Bot Service.

Perintah

Nama	Deskripsi	Jenis	Status
az bot authsetting	Mengelola pengaturan koneksi OAuth pada bot.	Inti	GA
az bot authsetting create	Buat pengaturan koneksi OAuth pada bot.	Inti	GA
az bot authsetting delete	Menghapus pengaturan koneksi OAuth pada bot.	Inti	GA
az bot authsetting list	Perlihatkan semua pengaturan koneksi OAuth pada bot.	Inti	GA
az bot authsetting list-providers	Mencantumkan detail untuk semua penyedia layanan yang tersedia untuk membuat pengaturan koneksi OAuth.	Inti	GA
az bot authsetting show	Tampilkan detail pengaturan koneksi OAuth pada bot.	Inti	GA
az bot create	Buat bot SDK v4 baru.	Inti	GA
az bot delete	Menghapus bot yang ada.	Inti	GA
az bot directline	Kelola Saluran Directline pada bot.	Inti	Pratinjau
az bot directline create	Buat Saluran DirectLine pada bot hanya dengan protokol v3 yang diaktifkan.	Inti	Pratinjau
az bot directline delete	Hapus Saluran Directline pada bot.	Inti	Pratinjau
az bot directline show	Dapatkan detail Saluran Directline pada bot.	Inti	Pratinjau
az bot directline update	Perbarui Saluran DirectLine pada bot dengan hanya protokol v3 yang diaktifkan.	Inti	Pratinjau
az bot download	Unduh bot yang ada.	Inti	Pratinjau
az bot email	Kelola Saluran email di bot.	Inti	Pratinjau
az bot email create	Buat Saluran Email di bot.	Inti	Pratinjau
az bot email delete	Hapus Saluran email pada bot.	Inti	Pratinjau
az bot email show	Dapatkan detail Saluran email di bot.	Inti	Pratinjau
az bot facebook	Kelola Saluran Facebook di bot.	Inti	Pratinjau
az bot facebook create	Buat Saluran Facebook di bot.	Inti	Pratinjau
az bot facebook delete	Hapus Saluran Facebook di bot.	Inti	Pratinjau
az bot facebook show	Dapatkan detail Saluran Facebook di bot.	Inti	Pratinjau
az bot kik	Kelola Saluran Kik pada bot.	Inti	Pratinjau
az bot kik create	Buat Saluran Kik pada bot.	Inti	Pratinjau
az bot kik delete	Hapus Saluran Kik pada bot.	Inti	Pratinjau
az bot kik show	Dapatkan detail Saluran Kik pada bot.	Inti	Pratinjau
az bot msteams	Mengelola Saluran Microsoft Teams pada bot.	Inti	Pratinjau
az bot msteams create	Buat Saluran Microsoft Teams pada bot.	Inti	Pratinjau
az bot msteams delete	Hapus Saluran Microsoft Teams pada bot.	Inti	Pratinjau
az bot msteams show	Dapatkan detail Saluran Microsoft Teams pada bot.	Inti	Pratinjau
az bot prepare-deploy	Tambahkan file skrip/konfigurasi untuk penerbitan dengan az webapp deployment.	Inti	GA
az bot prepare-publish	(Mode pemeliharaan) Tambahkan skrip ke direktori kode sumber lokal Anda untuk dapat menerbitkan kembali menggunakan az bot publish untuk bot SDK v3.	Inti	Pratinjau
az bot publish	Terbitkan ke layanan aplikasi terkait bot.	Inti	Pratinjau
az bot show	Dapatkan bot yang ada.	Inti	GA
az bot skype	Mengelola Saluran Skype pada bot.	Inti	Pratinjau
az bot skype create	Buat Saluran Skype di bot.	Inti	Pratinjau
az bot skype delete	Hapus Saluran Skype di bot.	Inti	Pratinjau
az bot skype show	Dapatkan detail Saluran Skype di bot.	Inti	Pratinjau
az bot slack	Kelola Saluran Slack pada bot.	Inti	Pratinjau
az bot slack create	Buat Saluran Slack pada bot.	Inti	Pratinjau
az bot slack delete	Hapus Saluran Slack pada bot.	Inti	Pratinjau
az bot slack show	Dapatkan detail Saluran Slack pada bot.	Inti	Pratinjau
az bot sms	Kelola Saluran SMS pada bot.	Inti	Pratinjau
az bot sms create	Buat Saluran SMS pada bot.	Inti	Pratinjau
az bot sms delete	Hapus Saluran SMS pada bot.	Inti	Pratinjau
az bot sms show	Dapatkan detail Saluran SMS pada bot.	Inti	Pratinjau
az bot telegram	Kelola Saluran Telegram pada bot.	Inti	Pratinjau
az bot telegram create	Buat Saluran Telegram pada bot.	Inti	Pratinjau
az bot telegram delete	Hapus Saluran Telegram pada bot.	Inti	Pratinjau
az bot telegram show	Dapatkan detail Saluran Telegram pada bot.	Inti	Pratinjau
az bot update	Perbarui bot yang ada.	Inti	GA
az bot webchat	Kelola Saluran Webchat pada bot.	Inti	GA
az bot webchat show	Dapatkan detail Saluran Webchat pada bot.	Inti	GA

az bot create

Buat bot SDK v4 baru.

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

Parameter yang Diperlukan

--app-type

Jenis Aplikasi Microsoft untuk bot. Nilai yang mungkin termasuk: "UserAssignedMSI", "SingleTenant", "MultiTenant".

--appid

ID akun Microsoft (ID MSA) yang akan digunakan dengan bot.

--name -n

Nama sumber daya bot. Panjang nama vault harus terdiri antara 4 dan 42 karakter. Nama but hanya dapat memiliki karakter berikut -, a - z, A - Z, 0 - 9, dan _.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

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

Url kunci brankas kunci untuk mengaktifkan enkripsi Kunci yang Dikelola Pelanggan.

--description -d

Penjabaran dari bot.

--display-name

Nama tampilan bot. Jika tidak ditentukan, default ke nama bot.

--endpoint -e

Titik akhir olahpesan bot.

--location -l

Lokasi. Nilai dari: az account list-locations. Anda dapat mengonfigurasi lokasi default menggunakan az configure --defaults location=<location>.

nilai default: global

--msi-resource-id

Id Sumber Daya Identitas Terkelola Aplikasi Microsoft untuk bot.

--sku

Sku bot.

nilai yang diterima: F0, S1

nilai default: F0

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

--tenant-id

Id Penyewa Aplikasi Microsoft untuk bot.

Parameter Global

--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc

nilai default: json

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az bot delete

Menghapus bot yang ada.

az bot delete --name
              --resource-group

Parameter yang Diperlukan

--name -n

Nama sumber daya bot. Panjang nama vault harus terdiri antara 4 dan 42 karakter. Nama but hanya dapat memiliki karakter berikut -, a - z, A - Z, 0 - 9, dan _.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Global

--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc

nilai default: json

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az bot download

Pratinjau

Perintah ini sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Unduh bot yang ada.

Kode sumber diunduh dari aplikasi web yang terkait dengan bot. Anda kemudian dapat membuat perubahan pada dan menerbitkannya kembali ke aplikasi Anda.

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

Parameter yang Diperlukan

--name -n

Nama sumber daya bot. Panjang nama vault harus terdiri antara 4 dan 42 karakter. Nama but hanya dapat memiliki karakter berikut -, a - z, A - Z, 0 - 9, dan _.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--save-path

Direktori untuk mengunduh kode bot.

Parameter Global

--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc

nilai default: json

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az bot prepare-deploy

Tambahkan file skrip/konfigurasi untuk penerbitan dengan az webapp deployment.

Tambahkan skrip atau file konfigurasi ke akar direktori kode sumber lokal Anda untuk dapat menerbitkan menggunakan az webapp deployment. Saat kode Anda disebarkan ke App Service Anda, skrip atau file konfigurasi yang dihasilkan akan muncul di D:\home\site\wwwroot di halaman web Kudu App Service.

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

Contoh

Bersiaplah untuk menggunakan 'az webapp' untuk menyebarkan bot Javascript dengan mengambil file web.config IIS Node.js.

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

Bersiaplah untuk menggunakan 'az webapp' untuk menyebarkan bot Csharp dengan membuat file .deployment.

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

Parameter yang Diperlukan

--lang

Bahasa atau runtime bot.

nilai yang diterima: Csharp, Javascript, Typescript

Parameter Opsional

--code-dir

Direktori untuk menempatkan file penyebaran yang dihasilkan. Default ke direktori saat ini tempat perintah dipanggil.

--proj-file-path

Jalur ke file .csproj relatif terhadap --code-dir.

Parameter Global

--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc

nilai default: json

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az bot prepare-publish

Pratinjau

Perintah ini sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

(Mode pemeliharaan) Tambahkan skrip ke direktori kode sumber lokal Anda untuk dapat menerbitkan kembali menggunakan az bot publish untuk bot SDK v3.

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

Parameter yang Diperlukan

--name -n

Nama sumber daya bot. Panjang nama vault harus terdiri antara 4 dan 42 karakter. Nama but hanya dapat memiliki karakter berikut -, a - z, A - Z, 0 - 9, dan _.

--proj-file-path

Jalur ke nama file proyek mulai. (Mis. "./EchoBotWithCounter.csproj") Diperlukan hanya untuk C#.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--sln-name

Nama nama file solusi start up. Diperlukan hanya untuk C#.

Parameter Opsional

--code-dir

Direktori untuk mengunduh skrip penyebaran.

--version -v

Versi Microsoft Bot Builder SDK yang akan digunakan dalam templat bot yang akan dibuat.

nilai yang diterima: v3, v4

nilai default: v3

Parameter Global

--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc

nilai default: json

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az bot publish

Pratinjau

Perintah ini sedang dalam pratinjau dan sedang dalam pengembangan. Tingkat referensi dan dukungan: https://aka.ms/CLI_refstatus

Terbitkan ke layanan aplikasi terkait bot.

Terbitkan kode sumber Anda ke layanan aplikasi terkait bot Anda. Ini tidak digunakan lagi untuk bot v4 dan tidak lagi direkomendasikan untuk menerbitkan bot v4 ke Azure. Sebagai gantinya, gunakan az bot prepare-deploy dan az webapp deployment untuk menyebarkan bot v4 Anda. Untuk informasi selengkapnya, lihat https://aka.ms/deploy-your-bot.

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

Contoh

Terbitkan kode sumber ke Aplikasi Azure Anda, dari dalam folder kode bot

az bot publish -n botName -g MyResourceGroup

Parameter yang Diperlukan

--name -n

Nama sumber daya bot. Panjang nama vault harus terdiri antara 4 dan 42 karakter. Nama but hanya dapat memiliki karakter berikut -, a - z, A - Z, 0 - 9, dan _.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--code-dir

Direktori untuk mengunggah kode bot.

--keep-node-modules

Simpan folder node_modules dan jangan jalankan npm install di App Service. Ini dapat sangat mempercepat perintah publikasi untuk bot SDK Node.js.

nilai yang diterima: false, true

--proj-file-path

Jalur ke nama file proyek mulai. (Mis. "./EchoBotWithCounter.csproj").

--timeout -t

Batas waktu yang dapat dikonfigurasi dalam hitungan detik untuk memeriksa status penyebaran.

--version -v

Bot Versi Microsoft Bot Builder SDK dari bot.

nilai default: v4

Parameter Global

--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc

nilai default: json

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az bot show

Dapatkan bot yang ada.

Dapatkan informasi tentang bot yang ada. Untuk mendapatkan informasi yang diperlukan untuk terhubung ke bot, gunakan bendera --msbot dengan perintah .

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

Contoh

Dapatkan informasi yang diperlukan untuk menyambungkan ke bot yang sudah ada di Azure

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

Parameter yang Diperlukan

--name -n

Nama sumber daya bot. Panjang nama vault harus terdiri antara 4 dan 42 karakter. Nama but hanya dapat memiliki karakter berikut -, a - z, A - Z, 0 - 9, dan _.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--msbot

Tampilkan output sebagai JSON yang kompatibel dengan file .bot.

nilai yang diterima: false, true

Parameter Global

--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc

nilai default: json

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az bot update

Perbarui bot yang ada.

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]

Contoh

Memperbarui deskripsi pada bot

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

Parameter yang Diperlukan

--name -n

Nama sumber daya bot. Panjang nama vault harus terdiri antara 4 dan 42 karakter. Nama but hanya dapat memiliki karakter berikut -, a - z, A - Z, 0 - 9, dan _.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

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

Kunci API Azure Application Insights digunakan untuk membaca data analitik bot. Berikan kunci jika Anda ingin melihat analitik tentang bot Anda di bilah Analytics.

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

ID Aplikasi Azure Application Insights digunakan untuk membaca data analitik bot. Berikan Id jika Anda ingin melihat analitik tentang bot Anda di bilah Analitik.

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

Kunci Azure Application Insights digunakan untuk menulis data analitik bot. Berikan kunci jika Anda ingin menerima analitik bot.

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

Url kunci brankas kunci untuk mengaktifkan enkripsi Kunci yang Dikelola Pelanggan.

--cmk-off

Atur enkripsi ke Kunci yang Dikelola Microsoft.

--description

Deskripsi baru bot.

--display-name -d

Nama tampilan baru bot.

--endpoint -e

Titik akhir baru bot. Harus dimulai dengan "https://".

--icon-url

URL ikon untuk avatar bot. Menerima file PNG dengan batas ukuran file 30KB.

--sku

Sku bot.

nilai yang diterima: F0, S1

--tags

Tag yang dipisahkan spasi: key[=value] [key[=value] ...]. Gunakan "" untuk menghapus tag yang ada.

Parameter Global

--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc

nilai default: json

--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.