az bot

Başvuru

Microsoft Azure Bot Hizmeti yönetme.

Komutlar

az bot authsetting	Botta OAuth bağlantı ayarlarını yönetme.
az bot authsetting create	Botta OAuth bağlantı ayarı oluşturun.
az bot authsetting delete	Botta OAuth bağlantı ayarını silme.
az bot authsetting list	Bir botta tüm OAuth bağlantı ayarlarını gösterme.
az bot authsetting list-providers	OAuth bağlantı ayarlarını oluşturmak için kullanılabilen tüm hizmet sağlayıcılarının ayrıntılarını listeleyin.
az bot authsetting show	Botta OAuth bağlantı ayarının ayrıntılarını gösterme.
az bot create	Yeni bir v4 SDK botu oluşturun.
az bot delete	Mevcut botu silin.
az bot directline	Bir botta Directline Kanalı'nı yönetin.
az bot directline create	Yalnızca v3 protokolü etkinleştirilmiş bir botta DirectLine Kanalı oluşturun.
az bot directline delete	Botta Directline Kanalı'nı silin.
az bot directline show	Botta Directline Kanalının ayrıntılarını alın.
az bot directline update	Yalnızca v3 protokolü etkinleştirilmiş bir botta DirectLine Kanalı'nı güncelleştirin.
az bot download	Mevcut botu indirin.
az bot email	Botta e-posta Kanalını yönetin.
az bot email create	Botta E-posta Kanalı oluşturun.
az bot email delete	Botta e-posta Kanalını silin.
az bot email show	Botta e-posta Kanalının ayrıntılarını alın.
az bot facebook	Botta Facebook Kanalı'nı yönetin.
az bot facebook create	Bir botta Facebook Kanalı oluşturun.
az bot facebook delete	Botta Facebook Kanalı'nı silin.
az bot facebook show	Botta Facebook Kanalının ayrıntılarını alın.
az bot kik	Botta Kik Kanalı'nı yönetme.
az bot kik create	Botta Kik Kanalı oluşturun.
az bot kik delete	Botta Kik Kanalı'nı silin.
az bot kik show	Botta Kik Kanalının ayrıntılarını alın.
az bot msteams	Botta Microsoft Teams Kanalını yönetin.
az bot msteams create	Botta Microsoft Teams Kanalı oluşturun.
az bot msteams delete	Botta Microsoft Teams Kanalını silin.
az bot msteams show	Botta Microsoft Teams Kanalının ayrıntılarını alın.
az bot prepare-deploy	ile `az webapp deployment`yayımlamak için betikler/yapılandırma dosyaları ekleyin.
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.
az bot publish	Botla ilişkili uygulama hizmetinde yayımlama.
az bot show	Mevcut bir botu edinin.
az bot skype	Botta Skype Kanalını yönetme.
az bot skype create	Botta Skype Kanalı oluşturun.
az bot skype delete	Botta Skype Kanalını silin.
az bot skype show	Botta Skype Kanalının ayrıntılarını alın.
az bot slack	Botta Slack Kanalı'nı yönetin.
az bot slack create	Botta Slack Kanalı oluşturun.
az bot slack delete	Botta Slack Kanalı'nı silin.
az bot slack show	Botta Slack Kanalının ayrıntılarını alın.
az bot sms	Bir botta SMS Kanalı'nı yönetin.
az bot sms create	Bir botta SMS Kanalı oluşturun.
az bot sms delete	Botta SMS Kanalını silin.
az bot sms show	Botta SMS Kanalının ayrıntılarını alın.
az bot telegram	Botta Telegram Kanalı'nı yönetin.
az bot telegram create	Botta Telegram Kanalı oluşturun.
az bot telegram delete	Botta Telegram Kanalı'nı silin.
az bot telegram show	Botta Telegram Kanalının ayrıntılarını alın.
az bot update	Mevcut botu güncelleştirme.
az bot webchat	Bir botta WebChat Kanalı'nı yönetin.
az bot webchat show	Botta WebChat Kanalının ayrıntılarını alın.

az bot create

Düzenle

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

--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ı. varsayılan grubu kullanarak 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. varsayılan konumu kullanarak az configure --defaults location=<location>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: anahtar[=değer] [anahtar[=değer] ...]. 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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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

Düzenle

Mevcut 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ı. varsayılan grubu kullanarak 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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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

Düzenle

Mevcut botu indirin.

Kaynak kodu 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ı. varsayılan grubu kullanarak az configure --defaults group=<name>yapılandırabilirsiniz.

İsteğe Bağlı Parametreler

--save-path

Bot kodunu indirebileceğiniz 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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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

Düzenle

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 dağıtıldığında, oluşturulan betikler veya yapılandırma dosyaları App Service Kudu web sayfasındaki D:homesitewwwroot içinde görünmelidir.

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

Örnekler

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

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

Bir .deployment dosyası oluşturarak csharp botu dağıtmak için kullanmaya `az webapp` 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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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

Düzenle

(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ı. varsayılan grubu kullanarak 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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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

Düzenle

Botla ilişkili uygulama hizmetinde yayımlama.

Kaynak kodunuzu botunuzun ilişkili uygulama hizmetinde yayımlayın. Bu, v4 botları için KULLANIMDAN KALDıRıLMıŞTıR ve v4 botlarını Azure'da yayımlamak için artık ö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

Bot kodu klasörünün içinden kaynak kodu 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ı. varsayılan grubu kullanarak 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ü tutun ve App Service üzerinde çalıştırmayınnpm 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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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

Düzenle

Mevcut bir botu edinin.

Mevcut 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ı. varsayılan grubu kullanarak 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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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

Düzenle

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ı. varsayılan grubu kullanarak 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ı İçgörüler 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 analizi verilerini okumak için kullanılan Azure Uygulaması İçgörüler Uygulama Kimliği. Analiz dikey penceresinde botunuzla ilgili analizleri görüntülemek istiyorsanız bir kimlik belirtin.

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

Azure Uygulaması İçgörüler Anahtarı, bot analiz verilerini yazmak için kullanılır. 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-Managed 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: anahtar[=değer] [anahtar[=değer] ...]. 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öster, uyarıları gizle.

--output -o

Çıkış biçimi.

--query

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

--subscription

Aboneliğin adı veya kimliği. kullanarak varsayılan aboneliği az account set -s NAME_OR_IDyapı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.