az bot

A Microsoft Azure Bot Service kezelése.

Parancsok

az bot authsetting	OAuth-kapcsolati beállítások kezelése egy roboton.
az bot authsetting create	OAuth kapcsolatbeállítás létrehozása roboton.
az bot authsetting delete	OAuth-kapcsolati beállítás törlése egy roboton.
az bot authsetting list	Az OAuth-kapcsolat összes beállításának megjelenítése egy roboton.
az bot authsetting list-providers	Az OAuth-kapcsolat beállításainak létrehozásához elérhető összes szolgáltató adatainak listázása.
az bot authsetting show	OAuth-kapcsolati beállítás részleteinek megjelenítése egy roboton.
az bot create	Hozzon létre egy új v4 SDK-robotot.
az bot delete	Meglévő robot törlése.
az bot directline	A Directline-csatorna kezelése egy roboton.
az bot directline create	Hozza létre a DirectLine-csatornát egy olyan roboton, amelyen csak a v3 protokoll van engedélyezve.
az bot directline delete	Törölje a Directline-csatornát egy roboton.
az bot directline show	A Directline-csatorna részleteinek lekérése egy roboton.
az bot directline update	Frissítse a DirectLine-csatornát egy olyan roboton, amelyen csak a v3 protokoll van engedélyezve.
az bot download	Töltsön le egy meglévő robotot.
az bot email	Az e-mail csatorna kezelése egy roboton.
az bot email create	Hozza létre a Email csatornát egy roboton.
az bot email delete	Törölje az e-mail-csatornát egy roboton.
az bot email show	Az e-mail csatorna részleteinek lekérése egy roboton.
az bot facebook	A Facebook-csatorna kezelése egy roboton.
az bot facebook create	Hozza létre a Facebook-csatornát egy roboton.
az bot facebook delete	Törölje a Facebook-csatornát egy roboton.
az bot facebook show	A Facebook-csatorna részleteinek lekérése egy roboton.
az bot kik	A Kik-csatorna kezelése egy roboton.
az bot kik create	Hozza létre a Kik-csatornát egy roboton.
az bot kik delete	Törölje a Kik-csatornát egy roboton.
az bot kik show	A Kik-csatorna részleteinek lekérése egy roboton.
az bot msteams	A Microsoft Teams-csatorna kezelése egy roboton.
az bot msteams create	Hozza létre a Microsoft Teams-csatornát egy roboton.
az bot msteams delete	Törölje a Microsoft Teams-csatornát egy roboton.
az bot msteams show	A Microsoft Teams-csatorna részleteinek lekérése egy roboton.
az bot prepare-deploy	Szkriptek/konfigurációs fájlok hozzáadása közzétételhez a következővel az webapp deployment: .
az bot prepare-publish	(Karbantartási mód) Adjon hozzá szkripteket a helyi forráskódkönyvtárhoz, hogy a v3 SDK-robotok használatával az bot publish újra közzétehesse a fájlt.
az bot publish	Közzététel egy robot társított App Service-szolgáltatásában.
az bot show	Szerezzen be egy meglévő robotot.
az bot skype	A Skype-csatorna kezelése egy roboton.
az bot skype create	Hozza létre a Skype-csatornát egy roboton.
az bot skype delete	Törölje a Skype-csatornát egy roboton.
az bot skype show	A Skype-csatorna részleteinek lekérése egy roboton.
az bot slack	A Slack-csatorna kezelése egy roboton.
az bot slack create	Hozza létre a Slack-csatornát egy roboton.
az bot slack delete	Törölje a Slack-csatornát egy roboton.
az bot slack show	A Slack-csatorna részleteinek lekérése egy roboton.
az bot sms	Az SMS-csatorna kezelése egy roboton.
az bot sms create	Hozza létre az SMS-csatornát egy roboton.
az bot sms delete	Törölje az SMS-csatornát egy roboton.
az bot sms show	Az SMS-csatorna részleteinek lekérése egy roboton.
az bot telegram	A Telegram csatorna kezelése egy roboton.
az bot telegram create	Hozza létre a Telegram csatornát egy roboton.
az bot telegram delete	Törölje a Telegram csatornát egy roboton.
az bot telegram show	A telegramcsatorna részleteinek lekérése egy roboton.
az bot update	Meglévő robot frissítése.
az bot webchat	Webchat-csatorna kezelése egy roboton.
az bot webchat show	A webchatcsatorna részleteinek lekérése egy roboton.

az bot create

Hozzon létre egy új v4 SDK-robotot.

Hozzon létre egy új v4 SDK-robotot.

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

Kötelező paraméterek

--app-type

A robot Microsoft-alkalmazástípusa.

--appid

A robottal használandó Microsoft-fiókazonosító (MSA-azonosító).

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

Opcionális paraméterek

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

A Key Vault-kulcs URL-címe az ügyfél által felügyelt kulcsok titkosításának engedélyezéséhez.

--description -d

A robot leírása.

--display-name

A robot megjelenítendő neve. Ha nincs megadva, alapértelmezés szerint a robot neve lesz.

--endpoint -e

A robot üzenetkezelési végpontja.

--location -l

Tartózkodási hely beállításnál. Értékek innen: az account list-locations. Az alapértelmezett helyet a használatával az configure --defaults location=<location>konfigurálhatja.

alapértelmezett érték: global

--msi-resource-id

A robotHoz tartozó Microsoft App Managed Identity erőforrás-azonosítója.

--sku

A robot termékváltozata.

elfogadott értékek: F0, S1

alapértelmezett érték: F0

--tags

Szóközzel elválasztott címkék: kulcs[=érték] [kulcs[=érték] ...]. A "" használatával törölheti a meglévő címkéket.

--tenant-id

A robotHoz tartozó Microsoft-alkalmazás bérlőazonosítója.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot delete

Meglévő robot törlése.

az bot delete --name
              --resource-group

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot download

Töltsön le egy meglévő robotot.

A forráskód a robothoz társított webalkalmazásból lesz letöltve. Ezután módosíthatja azt, és közzéteheti az alkalmazásban.

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

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

Opcionális paraméterek

--save-path

A könyvtár, amelybe le szeretné tölteni a robot kódját.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot prepare-deploy

Szkriptek/konfigurációs fájlok hozzáadása közzétételhez a következővel az webapp deployment: .

Adjon hozzá szkripteket vagy konfigurációs fájlokat a helyi forráskódkönyvtár gyökeréhez, hogy közzétehesse azokat a használatával az webapp deployment. Amikor a kódot üzembe helyezi a App Service, a létrehozott szkripteknek vagy konfigurációs fájloknak meg kell jelennie a D:homesitewwroot fájlban App Service Kudu webhelyén.

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

Példák

Készüljön fel arra, hogy az "az webapp" használatával javascript-robotot helyez üzembe egy Node.js IIS-web.config fájl beolvasásával.

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

Készüljön fel arra, hogy az "az webapp" használatával üzembe helyez egy Csharp-robotot egy .deployment fájl létrehozásával.

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

Kötelező paraméterek

--lang

A robot nyelve vagy futtatókörnyezete.

elfogadott értékek: Csharp, Javascript, Typescript

Opcionális paraméterek

--code-dir

A létrehozott központi telepítési fájlok elhelyezésére vonatkozó könyvtár. Alapértelmezés szerint az aktuális könyvtárban hívja meg a parancsot.

--proj-file-path

A .csproj fájl elérési útja a --code-dir fájlhoz viszonyítva.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot prepare-publish

(Karbantartási mód) Adjon hozzá szkripteket a helyi forráskódkönyvtárhoz, hogy a v3 SDK-robotok használatával az bot publish újra közzétehesse azokat.

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

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--proj-file-path

Az indítási projekt fájlnevének elérési útja. (Pl. "./EchoBotWithCounter.csproj") Csak C# esetén szükséges.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

--sln-name

Az indítási megoldás fájljának neve. Csak C# esetén szükséges.

Opcionális paraméterek

--code-dir

A könyvtár, amelybe az üzembehelyezési szkripteket le szeretné tölteni.

--version -v

A létrehozandó robotsablonban használni kívánt Microsoft Bot Builder SDK-verzió.

elfogadott értékek: v3, v4

alapértelmezett érték: v3

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot publish

Közzététel egy robot társított App Service-szolgáltatásában.

Tegye közzé a forráskódot a robot társított App Service-szolgáltatásában. Ez a v4-robotok esetében elavult, és már nem ajánlott a v4-robotok Azure-ban való közzétételéhez. Ehelyett használja az bot prepare-deploy és az webapp deployment helyezze üzembe a v4-robotot. További információ: https://aka.ms/deploy-your-bot.

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

Példák

Forráskód közzététele a Azure-alkalmazás a robot kódmappájából

az bot publish -n botName -g MyResourceGroup

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

Opcionális paraméterek

--code-dir

A robot kódjának feltöltésére szolgáló könyvtár.

--keep-node-modules

Hagyja node_modules mappát, és ne fusson npm install a App Service. Ez jelentősen felgyorsíthatja Node.js SDK-robotok közzétételi parancsainak közzétételét.

elfogadott értékek: false, true

--proj-file-path

Az indítási projekt fájlnevének elérési útja. (Pl. "./EchoBotWithCounter.csproj").

--timeout -t

Konfigurálható időtúllépés másodpercben az üzembe helyezés állapotának ellenőrzéséhez.

--version -v

A robot Microsoft Bot Builder SDK-verziója.

alapértelmezett érték: v4

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot show

Meglévő robot lekérése.

Információk lekérése egy meglévő robotról. A robothoz való csatlakozáshoz szükséges információk lekéréséhez használja az --msbot jelzőt a paranccsal.

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

Példák

Az Azure-beli meglévő robothoz való csatlakozáshoz szükséges információk lekérése

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

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

Opcionális paraméterek

--msbot

A kimenet megjelenítése .bot fájllal kompatibilis JSON-fájlként.

elfogadott értékek: false, true

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az bot update

Meglévő robot frissítése.

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]

Példák

Robot leírásának frissítése

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

Kötelező paraméterek

--name -n

A robot erőforrásneve. A robot neve csak 4 és 42 karakter közötti hosszúságú lehet. A robot nevében csak a következő karakterek szerepelhetnek: -, a–z, A–Z, 0–9 és _.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a használatával az configure --defaults group=<name>konfigurálhatja.

Opcionális paraméterek

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

Azure-alkalmazás Insights API-kulcs a robotelemzési adatok olvasásához. Adja meg a kulcsot, ha meg szeretné tekinteni a robottal kapcsolatos elemzéseket az Elemzés panelen.

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

Azure-alkalmazás Insights alkalmazásazonosítója a robotelemzési adatok olvasásához. Adja meg az azonosítót, ha meg szeretné tekinteni a robottal kapcsolatos elemzéseket az Elemzés panelen.

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

Azure-alkalmazás Elemzési kulcs robotelemzési adatok írásához. Adjon meg egy kulcsot, ha robotelemzést szeretne kapni.

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

A Key Vault-kulcs URL-címe az ügyfél által felügyelt kulcsok titkosításának engedélyezéséhez.

--cmk-off

Állítsa a titkosítást Microsoft-Managed kulcsra.

--description

A robot új leírása.

--display-name -d

A robot új megjelenítendő neve.

--endpoint -e

A robot új végpontja. A "https://" betűvel kell kezdődnie.

--icon-url

A robot avatarjának ikon URL-címe. 30 KB-os fájlméretkorláttal rendelkező PNG-fájlokat fogad el.

--sku

A robot termékváltozata.

elfogadott értékek: F0, S1

--tags

Szóközzel tagolt címkék: kulcs[=érték] [kulcs[=érték] ...]. A "" használatával törölheti a meglévő címkéket.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a használatával az account set -s NAME_OR_IDkonfigurálhatja.

--verbose

Növelje a naplózás részletességét. Használja a --debug parancsot a teljes hibakeresési naplókhoz.