az bot

Microsoft Azure Bot Hizmeti'i yönetin.

Komutlar

Name Description Tür Durum
az bot authsetting

Botta OAuth bağlantı ayarlarını yönetin.

Temel GA
az bot authsetting create

Botta OAuth bağlantı ayarı oluşturun.

Temel GA
az bot authsetting delete

Botta OAuth bağlantı ayarını silme.

Temel GA
az bot authsetting list

Botta tüm OAuth bağlantı ayarlarını gösterme.

Temel GA
az bot authsetting list-providers

OAuth bağlantı ayarları oluşturmak için kullanılabilen tüm hizmet sağlayıcılarının ayrıntılarını listeleyin.

Temel GA
az bot authsetting show

Botta OAuth bağlantı ayarının ayrıntılarını gösterin.

Temel GA
az bot create

Yeni bir v4 SDK botu oluşturun.

Temel GA
az bot delete

Mevcut bir botu silin.

Temel GA
az bot directline

Botta Directline Kanalı'nı yönetin.

Temel Önizle
az bot directline create

Yalnızca v3 protokolü etkinleştirilmiş bir botta DirectLine Kanalı oluşturun.

Temel Önizle
az bot directline delete

Botta Directline Kanalı'nı silin.

Temel Önizle
az bot directline show

Botta Directline Kanalının ayrıntılarını alın.

Temel Önizle
az bot directline update

Yalnızca v3 protokolü etkinleştirilmiş bir botta DirectLine Kanalı'nı güncelleştirin.

Temel Önizle
az bot download

Mevcut bir botu indirin.

Temel Önizle
az bot email

Botta e-posta Kanalı'nı yönetin.

Temel Önizle
az bot email create

Botta E-posta Kanalı oluşturun.

Temel Önizle
az bot email delete

Botta e-posta Kanalı'nı silin.

Temel Önizle
az bot email show

Botta e-posta Kanalının ayrıntılarını alın.

Temel Önizle
az bot facebook

Botta Facebook Kanalı'nı yönetin.

Temel Önizle
az bot facebook create

Botta Facebook Kanalı oluşturun.

Temel Önizle
az bot facebook delete

Botta Facebook Kanalı'nı silin.

Temel Önizle
az bot facebook show

Botta Facebook Kanalının ayrıntılarını alın.

Temel Önizle
az bot kik

Botta Kik Kanalı'nı yönetme.

Temel Önizle
az bot kik create

Botta Kik Kanalı oluşturun.

Temel Önizle
az bot kik delete

Botta Kik Kanalı'nı silin.

Temel Önizle
az bot kik show

Botta Kik Kanalının ayrıntılarını alın.

Temel Önizle
az bot msteams

Botta Microsoft Teams Kanalı'nı yönetin.

Temel Önizle
az bot msteams create

Botta Microsoft Teams Kanalı oluşturun.

Temel Önizle
az bot msteams delete

Botta Microsoft Teams Kanalı'nı silin.

Temel Önizle
az bot msteams show

Botta Microsoft Teams Kanalının ayrıntılarını alın.

Temel Önizle
az bot prepare-deploy

ile az webapp deploymentyayımlamak için betikler/yapılandırma dosyaları ekleyin.

Temel GA
az bot prepare-publish

(Bakım modu) v3 SDK botlarını kullanarak az bot publish yeniden yayımlamak için yerel kaynak kodu dizininize betikler ekleyin.

Temel Önizle
az bot publish

Botla ilişkilendirilmiş uygulama hizmetinde yayımlama.

Temel Önizle
az bot show

Mevcut bir botu edinin.

Temel GA
az bot skype

Botta Skype Kanalı'nı yönetin.

Temel Önizle
az bot skype create

Botta Skype Kanalı oluşturun.

Temel Önizle
az bot skype delete

Botta Skype Kanalı'nı silin.

Temel Önizle
az bot skype show

Botta Skype Kanalının ayrıntılarını alın.

Temel Önizle
az bot slack

Botta Slack Kanalı'nı yönetin.

Temel Önizle
az bot slack create

Botta Slack Kanalı oluşturun.

Temel Önizle
az bot slack delete

Botta Slack Kanalı'nı silin.

Temel Önizle
az bot slack show

Botta Slack Kanalının ayrıntılarını alın.

Temel Önizle
az bot sms

Botta SMS Kanalı'nı yönetin.

Temel Önizle
az bot sms create

Botta SMS Kanalı oluşturun.

Temel Önizle
az bot sms delete

Botta SMS Kanalı'nı silin.

Temel Önizle
az bot sms show

Botta SMS Kanalının ayrıntılarını alın.

Temel Önizle
az bot telegram

Botta Telegram Kanalı'nı yönetin.

Temel Önizle
az bot telegram create

Botta Telegram Kanalı oluşturun.

Temel Önizle
az bot telegram delete

Botta Telegram Kanalı'nı silin.

Temel Önizle
az bot telegram show

Botta Telegram Kanalının ayrıntılarını alın.

Temel Önizle
az bot update

Mevcut botu güncelleştirme.

Temel GA
az bot webchat

Bir botta WebChat Kanalı'nı yönetin.

Temel GA
az bot webchat show

Botta WebChat Kanalının ayrıntılarını alın.

Temel GA

az bot create

Yeni bir v4 SDK botu oluşturun.

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

Gerekli Parametreler

--app-type

Bot için Microsoft Uygulama Türü. Olası değerler şunlardır: "UserAssignedMSI", "SingleTenant", "MultiTenant".

--appid

Botla birlikte kullanılacak Microsoft hesap kimliği (MSA Kimliği).

--name -n

Botun kaynak adı. Bot adı 4 ile 42 karakter uzunluğunda olmalıdır. Bot adında yalnızca şu karakterler kullanılabilir: -, a - z, A - Z, 0 - 9 ve _.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

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

Müşteri Tarafından Yönetilen Anahtarlar şifrelemesini etkinleştirmek için anahtar kasası anahtar URL'si.

--description -d

Botun açıklaması.

--display-name

Botun görünen adı. Belirtilmezse, varsayılan olarak botun adını kullanır.

--endpoint -e

Botun mesajlaşma uç noktası.

--location -l

Konum. Değerleri: az account list-locations. kullanarak az configure --defaults location=<location>varsayılan konumu yapılandırabilirsiniz.

varsayılan değer: global
--msi-resource-id

Bot için Microsoft Uygulama Yönetilen Kimlik Kaynak Kimliği.

--sku

Botun Sku'su.

kabul edilen değerler: F0, S1
varsayılan değer: F0
--tags

Boşlukla ayrılmış etiketler: key[=value] [key[=value] ...]. Mevcut etiketleri temizlemek için "" kullanın.

--tenant-id

Bot için Microsoft Uygulama Kiracı Kimliği.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az bot delete

Mevcut bir botu silin.

az bot delete --name
              --resource-group

Gerekli Parametreler

--name -n

Botun kaynak adı. Bot adı 4 ile 42 karakter uzunluğunda olmalıdır. Bot adında yalnızca şu karakterler kullanılabilir: -, a - z, A - Z, 0 - 9 ve _.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az bot download

Önizleme

Bu komut önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

Mevcut bir botu indirin.

Kaynak kod, botla ilişkilendirilmiş web uygulamasından indirilir. Daha sonra bu uygulamada değişiklik yapabilir ve uygulamanızda yeniden yayımlayabilirsiniz.

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

Gerekli Parametreler

--name -n

Botun kaynak adı. Bot adı 4 ile 42 karakter uzunluğunda olmalıdır. Bot adında yalnızca şu karakterler kullanılabilir: -, a - z, A - Z, 0 - 9 ve _.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--save-path

Bot kodunun indirilmesi için dizin.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az bot prepare-deploy

ile az webapp deploymentyayımlamak için betikler/yapılandırma dosyaları ekleyin.

kullanarak az webapp deploymentyayımlamak için yerel kaynak kod dizininizin köküne betikler veya yapılandırma dosyaları ekleyin. Kodunuz App Service'inize dağıtıldığında, oluşturulan betikler veya yapılandırma dosyaları App Service'in Kudu web sayfasında D:\home\site\wwwroot konumunda görünmelidir.

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

Örnekler

Node.js IIS web.config dosyasını getirerek javascript botu dağıtmak için 'az webapp' kullanmaya hazırlanın.

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

Bir .deployment dosyası oluşturarak csharp botu dağıtmak için 'az webapp' kullanmaya hazırlanın.

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

Gerekli Parametreler

--lang

Botun dili veya çalışma zamanı.

kabul edilen değerler: Csharp, Javascript, Typescript

İsteğe Bağlı Parametreler

--code-dir

Oluşturulan dağıtım dosyalarını yerleştirecek dizin. Varsayılan olarak komutun çağrıldığı geçerli dizindir.

--proj-file-path

--code-dir ile ilgili .csproj dosyasının yolu.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az bot prepare-publish

Önizleme

Bu komut önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

(Bakım modu) v3 SDK botlarını kullanarak az bot publish yeniden yayımlamak için yerel kaynak kodu dizininize betikler ekleyin.

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

Gerekli Parametreler

--name -n

Botun kaynak adı. Bot adı 4 ile 42 karakter uzunluğunda olmalıdır. Bot adında yalnızca şu karakterler kullanılabilir: -, a - z, A - Z, 0 - 9 ve _.

--proj-file-path

Başlangıç projesi dosya adının yolu. (Örn. "./EchoBotWithCounter.csproj") Yalnızca C# için gereklidir.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--sln-name

Başlangıç çözümü dosya adının adı. Yalnızca C# için gereklidir.

İsteğe Bağlı Parametreler

--code-dir

Dağıtım betiklerini indirebileceğiniz dizin.

--version -v

Oluşturulacak bot şablonunda kullanılacak Microsoft Bot Builder SDK sürümü.

kabul edilen değerler: v3, v4
varsayılan değer: v3
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az bot publish

Önizleme

Bu komut önizleme aşamasında ve geliştirme aşamasındadır. Başvuru ve destek düzeyleri: https://aka.ms/CLI_refstatus

Botla ilişkilendirilmiş uygulama hizmetinde yayımlama.

Kaynak kodunuzu botunuzun ilişkili uygulama hizmetinde yayımlayın. Bu, v4 botları için KULLANIMSIZDIR ve artık v4 botlarını Azure'da yayımlamak için önerilmez. Bunun yerine v4 botunuzu dağıtmak için ve az webapp deployment kullanınaz bot prepare-deploy. Daha fazla bilgi için bkz. https://aka.ms/deploy-your-bot.

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

Örnekler

Kaynak kodu bot kodu klasörünün içinden Azure Uygulaması yayımlama

az bot publish -n botName -g MyResourceGroup

Gerekli Parametreler

--name -n

Botun kaynak adı. Bot adı 4 ile 42 karakter uzunluğunda olmalıdır. Bot adında yalnızca şu karakterler kullanılabilir: -, a - z, A - Z, 0 - 9 ve _.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--code-dir

Bot kodunun yüklendiği dizin.

--keep-node-modules

node_modules klasörünü tutun ve App Service'te çalıştırmayın npm install . Bu, Node.js SDK botları için yayımlama komutlarını büyük ölçüde hızlandırabilir.

kabul edilen değerler: false, true
--proj-file-path

Başlangıç projesi dosya adının yolu. (Örn. "./EchoBotWithCounter.csproj").

--timeout -t

Dağıtımın durumunu denetlemek için saniyeler içinde yapılandırılabilir zaman aşımı.

--version -v

Botun Microsoft Bot Builder SDK sürümü.

varsayılan değer: v4
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az bot show

Mevcut bir botu edinin.

Mevcut bir bot hakkında bilgi edinin. Bota bağlanmak için gereken bilgileri almak için komutuyla --msbot bayrağını kullanın.

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

Örnekler

Azure'da mevcut bir bota bağlanmak için gereken bilgileri alma

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

Gerekli Parametreler

--name -n

Botun kaynak adı. Bot adı 4 ile 42 karakter uzunluğunda olmalıdır. Bot adında yalnızca şu karakterler kullanılabilir: -, a - z, A - Z, 0 - 9 ve _.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--msbot

Çıktıyı bir .bot dosyasıyla uyumlu JSON olarak gösterin.

kabul edilen değerler: false, true
Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az bot update

Mevcut botu güncelleştirme.

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]

Örnekler

Botta açıklamayı güncelleştirme

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

Gerekli Parametreler

--name -n

Botun kaynak adı. Bot adı 4 ile 42 karakter uzunluğunda olmalıdır. Bot adında yalnızca şu karakterler kullanılabilir: -, a - z, A - Z, 0 - 9 ve _.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

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

bot analiz verilerini okumak için kullanılan Azure Uygulaması Analizler API Anahtarı. Analiz dikey penceresinde botunuzla ilgili analizleri görüntülemek istiyorsanız bir anahtar sağlayın.

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

bot analiz verilerini okumak için kullanılan Azure Uygulaması Analizler Uygulama Kimliği. Analiz dikey penceresinde botunuzla ilgili analizleri görüntülemek istiyorsanız bir Kimlik belirtin.

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

bot analiz verilerini yazmak için kullanılan Azure Uygulaması Analizler Anahtarı. Bot analizi almak istiyorsanız bir anahtar sağlayın.

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

Müşteri Tarafından Yönetilen Anahtarlar şifrelemesini etkinleştirmek için anahtar kasası anahtar URL'si.

--cmk-off

Şifrelemeyi Microsoft Tarafından Yönetilen Anahtarlar olarak ayarlayın.

--description

Bot'un yeni açıklaması.

--display-name -d

Bot'un yeni görünen adı.

--endpoint -e

Botun yeni uç noktası. "https://" ile başlamalıdır.

--icon-url

Bot avatarı için simge URL'si. Dosya boyutu sınırı 30 KB olan PNG dosyalarını kabul eder.

--sku

Botun Sku'su.

kabul edilen değerler: F0, S1
--tags

Boşlukla ayrılmış etiketler: key[=value] [key[=value] ...]. Mevcut etiketleri temizlemek için "" kullanın.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.