az bot

Beheer Microsoft Azure Bot Service.

Opdracht

az bot authsetting

OAuth-verbindingsinstellingen op een bot beheren.

az bot authsetting create

Maak een OAuth-verbindingsinstelling voor een bot.

az bot authsetting delete

Verwijder een OAuth-verbindingsinstelling voor een bot.

az bot authsetting list

Alle OAuth-verbindingsinstellingen voor een bot tonen.

az bot authsetting list-providers

Lijst met details voor alle serviceproviders die beschikbaar zijn voor het maken van OAuth-verbindingsinstellingen.

az bot authsetting show

Details van een OAuth-verbindingsinstelling voor een bot tonen.

az bot create

Maak een nieuwe v4 SDK-bot.

az bot delete

Een bestaande bot verwijderen.

az bot directline

Het Directline-kanaal op een bot beheren.

az bot directline create

Maak het DirectLine-kanaal op een bot met alleen het v3-protocol ingeschakeld.

az bot directline delete

Verwijder het Directline-kanaal op een bot.

az bot directline show

Meer informatie over het Directline-kanaal op een bot.

az bot directline update

Werk het DirectLine-kanaal op een bot bij met alleen het v3-protocol ingeschakeld.

az bot download

Download een bestaande bot.

az bot email

Het e-mailkanaal op een bot beheren.

az bot email create

Maak het e-mailkanaal op een bot.

az bot email delete

Verwijder het e-mailkanaal op een bot.

az bot email show

Krijg details van het e-mailkanaal op een bot.

az bot facebook

Het Facebook-kanaal op een bot beheren.

az bot facebook create

Maak het Facebook-kanaal op een bot.

az bot facebook delete

Verwijder het Facebook-kanaal op een bot.

az bot facebook show

Meer informatie over het Facebook-kanaal op een bot.

az bot kik

Het Kanaal van Het Kanaal op een bot beheren.

az bot kik create

Maak het Channel Voor een bot.

az bot kik delete

Verwijder het Channel Channel op een bot.

az bot kik show

Meer informatie over het Channel Channel op een bot.

az bot msteams

Beheer het Microsoft Teams kanaal op een bot.

az bot msteams create

Maak het Microsoft Teams kanaal op een bot.

az bot msteams delete

Verwijder het Microsoft Teams kanaal op een bot.

az bot msteams show

Meer informatie over het Microsoft Teams kanaal op een bot.

az bot prepare-deploy

Voeg scripts/configuratiebestanden toe voor publicatie met az webapp deployment .

az bot prepare-publish

(Onderhoudsmodus) Voeg scripts toe aan uw lokale broncodemap om terug te kunnen publiceren met behulp az bot publish van voor v3 SDK-bots.

az bot publish

Publiceren naar de app-service die aan een bot is gekoppeld.

az bot show

Haal een bestaande bot op.

az bot skype

Beheer het Skype kanaal op een bot.

az bot skype create

Maak het Skype-kanaal op een bot.

az bot skype delete

Verwijder het Skype kanaal op een bot.

az bot skype show

Meer informatie over het Skype kanaal op een bot.

az bot slack

Beheer het Slack-kanaal op een bot.

az bot slack create

Maak het Slack-kanaal op een bot.

az bot slack delete

Verwijder het Slack-kanaal op een bot.

az bot slack show

Meer informatie over het Slack-kanaal op een bot.

az bot sms

Het SMS-kanaal op een bot beheren.

az bot sms create

Maak het SMS-kanaal op een bot.

az bot sms delete

Verwijder het SMS-kanaal op een bot.

az bot sms show

Meer informatie over het SMS-kanaal op een bot.

az bot telegram

Het Kanaal Telegram op een bot beheren.

az bot telegram create

Maak het Telegram-kanaal op een bot.

az bot telegram delete

Verwijder het Telegram-kanaal op een bot.

az bot telegram show

Meer informatie over het Telegram-kanaal op een bot.

az bot update

Een bestaande bot bijwerken.

az bot webchat

Het Webchat-kanaal op een bot beheren.

az bot webchat show

Meer informatie over het Webchat-kanaal op een bot.

az bot create

Maak een nieuwe v4 SDK-bot.

Maak een nieuwe v4 SDK-bot.

az bot create --appid
              --kind {registration, webapp}
              --name
              --resource-group
              [--cmk]
              [--description]
              [--display-name]
              [--echo {false, true}]
              [--endpoint]
              [--lang {Csharp, Javascript}]
              [--location]
              [--password]
              [--sku {F0, S1}]
              [--subscription]
              [--tags]

Vereiste parameters

--appid

De Microsoft-account-id (MSA-id) die moet worden gebruikt met de bot.

--kind -k

Het soort bot.

geaccepteerde waarden: registration, webapp
--name -n

De resourcenaam van de bot. De naam van de bot moet bestaan uit 4 tot 42 tekens. De naam van de bot mag alleen de volgende tekens bevatten: -, a - z, A - Z, 0 - 9 en _.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

Optionele parameters

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

De sleutel-URL van de sleutelkluis om door de klant beheerde sleutels te versleutelen.

--description -d

De beschrijving van de bot.

--display-name

De weergavenaam van de bot. Als dit niet wordt opgegeven, wordt standaard de naam van de bot gebruikt.

--echo

Implementeer een echobotsjabloon in de zojuist gemaakte v4-web-app-bot.

geaccepteerde waarden: false, true
--endpoint -e

Het berichteindpunt van de bot.

--lang

De taal die moet worden gebruikt om de bot te maken.

geaccepteerde waarden: Csharp, Javascript
--location -l

Locatie. Waarden van: az account list-locations . U kunt de standaardlocatie configureren met az configure --defaults location=<location> behulp van .

standaardwaarde: Central US
--password -p

Het Microsoft-account (MSA) voor de bot. Wordt gebruikt om berichten te autor toestemming te geven die vanuit de bot worden verzonden. Vereist wanneer '--kind' 'webapp' is.

--sku

De SKU van de bot.

geaccepteerde waarden: F0, S1
standaardwaarde: F0
--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--tags

Door ruimte gescheiden tags: sleutel[=waarde] [sleutel[=waarde] ...]. Gebruik '' om bestaande tags te verwijderen.

az bot delete

Een bestaande bot verwijderen.

az bot delete --name
              --resource-group
              [--subscription]

Vereiste parameters

--name -n

De resourcenaam van de bot. De naam van de bot moet bestaan uit 4 tot 42 tekens. De naam van de bot mag alleen de volgende tekens bevatten: -, a - z, A - Z, 0 - 9 en _.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

Optionele parameters

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az bot download

Download een bestaande bot.

De broncode wordt gedownload van de web-app die is gekoppeld aan de bot. Vervolgens kunt u er wijzigingen aan aanbrengen en deze terug publiceren naar uw app.

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

Vereiste parameters

--name -n

De resourcenaam van de bot. De naam van de bot moet bestaan uit 4 tot 42 tekens. De naam van de bot mag alleen de volgende tekens bevatten: -, a - z, A - Z, 0 - 9 en _.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

Optionele parameters

--save-path

De map waar botcode naar moet worden gedownload.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az bot prepare-deploy

Voeg scripts/configuratiebestanden toe voor publicatie met az webapp deployment .

Voeg scripts of configuratiebestanden toe aan de hoofdmap van uw lokale broncodemap om te kunnen publiceren met behulp van az webapp deployment . Wanneer uw code wordt geïmplementeerd in uw App Service, moeten de gegenereerde scripts of configuratiebestanden worden weergegeven in D:homesitewwwroot op de Kudu-webpagina van App Service.

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

Voorbeelden

Bereid u voor op `az webapp` het implementeren van een JavaScript-bot door een IIS-Node.js op web.config ophalen.

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

Bereid u voor op `az webapp` het implementeren van een Csharp-bot door een .deployment-bestand te maken.

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

Vereiste parameters

--lang

De taal of runtime van de bot.

geaccepteerde waarden: Csharp, Javascript, Typescript

Optionele parameters

--code-dir

De map waarin de gegenereerde implementatiebestanden moeten worden opgeslagen. De standaardinstelling is de huidige map van waar de opdracht wordt aangeroepen.

--proj-file-path

Het pad naar het .csproj-bestand ten opzichte van --code-dir.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

az bot prepare-publish

(Onderhoudsmodus) Voeg scripts toe aan uw lokale broncodemap om terug te kunnen publiceren met behulp az bot publish van voor v3 SDK-bots.

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

Vereiste parameters

--name -n

De resourcenaam van de bot. De naam van de bot moet bestaan uit 4 tot 42 tekens. De naam van de bot mag alleen de volgende tekens bevatten: -, a - z, A - Z, 0 - 9 en _.

--proj-file-path

Pad naar de bestandsnaam van het opstartproject. (Bijvoorbeeld "./EchoBotWithCounter.csproj") alleen vereist voor C#.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

--sln-name

Naam van de bestandsnaam van de opstartoplossing. Alleen vereist voor C#.

Optionele parameters

--code-dir

De map waar implementatiescripts naar moeten worden gedownload.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--version -v

De Microsoft Bot Builder SDK-versie die moet worden gebruikt in de botsjabloon die wordt gemaakt.

geaccepteerde waarden: v3, v4
standaardwaarde: v3

az bot publish

Publiceren naar de app-service die aan een bot is gekoppeld.

Publiceer uw broncode naar de app-service die aan uw bot is gekoppeld. Dit is afgeschaft voor v4-bots en wordt niet meer aanbevolen voor het publiceren van v4-bots naar Azure. Gebruik in az bot prepare-deploy plaats daarvan en om uw az webapp deployment v4-bot te implementeren. Zie https://aka.ms/deploy-your-bot voor meer informatie.

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

Voorbeelden

Publiceer broncode naar uw Azure-app, vanuit de map met botcode

az bot publish -n botName -g MyResourceGroup

Vereiste parameters

--name -n

De resourcenaam van de bot. De naam van de bot moet bestaan uit 4 tot 42 tekens. De naam van de bot mag alleen de volgende tekens bevatten: -, a - z, A - Z, 0 - 9 en _.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .

Optionele parameters

--code-dir

De map waar de botcode vandaan moet worden geüpload.

--keep-node-modules

Houd node_modules map en voer niet uit npm install op de App Service. Dit kan het publiceren van opdrachten voor Node.js SDK-bots sterk versnellen.

geaccepteerde waarden: false, true
--proj-file-path

Pad naar de bestandsnaam van het opstartproject. (Bijvoorbeeld "./EchoBotWithCounter.csproj").

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .

--timeout -t

Configureerbare time-out in seconden voor het controleren van de status van de implementatie.

--version -v

De Microsoft Bot Builder SDK-versie van de bot.

standaardwaarde: v4

az bot show

Haal een bestaande bot op.

Informatie over een bestaande bot. Gebruik de vlag --msbot met de opdracht om de informatie op te halen die nodig is om verbinding te maken met de bot.

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

Voorbeelden

Haal de informatie op die nodig is om verbinding te maken met een bestaande bot in Azure

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

Vereiste parameters

--name -n

De resourcenaam van de bot. De naam van de bot moet bestaan uit 4 tot 42 tekens. De naam van de bot mag alleen de volgende tekens bevatten: -, a - z, A - Z, 0 - 9 en _.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--msbot

Toon de uitvoer als JSON die compatibel is met een .bot-bestand.

geaccepteerde waarden: false, true
--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en deze na de parameter --query tussen dubbele aanhalingstekens plakken om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

az bot update

Een bestaande bot bijwerken.

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}]
              [--subscription]
              [--tags]

Voorbeelden

Beschrijving van een bot bijwerken

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

Vereiste parameters

--name -n

De resourcenaam van de bot. De naam van de bot moet bestaan uit 4 tot 42 tekens. De naam van de bot mag alleen de volgende tekens bevatten: -, a - z, A - Z, 0 - 9 en _.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

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

Azure-toepassing Insights API-sleutel die wordt gebruikt om botanalysegegevens te lezen. Geef een sleutel op als u analyses over uw bot wilt weergeven op de blade Analyse.

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

Azure-toepassing Insights toepassings-id die wordt gebruikt om botanalysegegevens te lezen. Geef een id op als u analyses over uw bot wilt weergeven op de blade Analyse.

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

Azure-toepassing Insights sleutel die wordt gebruikt om botanalysegegevens te schrijven. Geef een sleutel op als u botanalyses wilt ontvangen.

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

De sleutel-URL van de sleutelkluis om door de klant beheerde sleutels te versleutelen.

--cmk-off

Stel versleuteling in Microsoft-Managed sleutels.

--description

De nieuwe beschrijving van de bot.

--display-name -d

De nieuwe weergavenaam van de bot.

--endpoint -e

Het nieuwe eindpunt van de bot. Moet beginnen met 'https://'.

--icon-url

Pictogram-URL voor bot-avatar. Accepteert PNG-bestanden met een bestandslimiet van 30 kB.

--sku

De SKU van de bot.

geaccepteerde waarden: F0, S1
--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .

--tags

Door spatie gescheiden tags: sleutel[=waarde] [sleutel[=waarde] ...]. Gebruik '' om bestaande tags te verwijderen.