az bot

Verwalten von Microsoft Azure Bot Service.

Befehle

az bot authsetting	Verwalten von OAuth-Verbindungseinstellungen auf einem Bot.
az bot authsetting create	Erstellen Sie eine OAuth-Verbindungseinstellung für einen Bot.
az bot authsetting delete	Löschen einer OAuth-Verbindungseinstellung auf einem Bot.
az bot authsetting list	Alle OAuth-Verbindungseinstellungen auf einem Bot anzeigen.
az bot authsetting list-providers	Listet Details zu allen Dienstanbietern auf, die zum Erstellen von OAuth-Verbindungseinstellungen verfügbar sind.
az bot authsetting show	Details einer OAuth-Verbindungseinstellung auf einem Bot anzeigen.
az bot create	Erstellen Sie einen neuen v4 SDK-Bot.
az bot delete	Löschen sie einen vorhandenen Bot.
az bot directline	Verwalten sie den Directline-Kanal auf einem Bot.
az bot directline create	Erstellen Sie den DirectLine-Kanal auf einem Bot mit nur aktiviertem v3-Protokoll.
az bot directline delete	Löschen Sie den Directline-Kanal auf einem Bot.
az bot directline show	Erhalten Sie Details des Directline-Kanals auf einem Bot.
az bot directline update	Aktualisieren Sie den DirectLine-Kanal auf einem Bot mit nur aktiviertem v3-Protokoll.
az bot download	Laden Sie einen vorhandenen Bot herunter.
az bot email	Verwalten des E-Mail-Kanals auf einem Bot.
az bot email create	Erstellen Sie den Email Kanal auf einem Bot.
az bot email delete	Löschen Sie den E-Mail-Kanal auf einem Bot.
az bot email show	Erhalten Sie Details des E-Mail-Kanals auf einem Bot.
az bot facebook	Verwalten Sie den Facebook-Kanal auf einem Bot.
az bot facebook create	Erstellen Sie den Facebook-Kanal auf einem Bot.
az bot facebook delete	Löschen Sie den Facebook-Kanal auf einem Bot.
az bot facebook show	Erhalten Sie Details des Facebook-Kanals auf einem Bot.
az bot kik	Verwalten Sie den Kik-Kanal auf einem Bot.
az bot kik create	Erstellen Sie den Kik-Kanal auf einem Bot.
az bot kik delete	Löschen Sie den Kik-Kanal auf einem Bot.
az bot kik show	Erhalten Sie Details des Kik-Kanals auf einem Bot.
az bot msteams	Verwalten sie den Microsoft Teams-Kanal auf einem Bot.
az bot msteams create	Erstellen Sie den Microsoft Teams-Kanal auf einem Bot.
az bot msteams delete	Löschen Sie den Microsoft Teams-Kanal auf einem Bot.
az bot msteams show	Erhalten Sie Details zum Microsoft Teams-Kanal auf einem Bot.
az bot prepare-deploy	Hinzufügen von Skripts/Konfigurationsdateien für die Veröffentlichung mit az webapp deployment.
az bot prepare-publish	(Wartungsmodus) Fügen Sie Ihrem lokalen Quellcodeverzeichnis Skripts hinzu, um die Verwendung az bot publish von v3 SDK-Bots wieder zu veröffentlichen.
az bot publish	Veröffentlichen Sie den zugeordneten App-Dienst eines Bots.
az bot show	Rufen Sie einen vorhandenen Bot ab.
az bot skype	Verwalten des Skype-Kanals auf einem Bot.
az bot skype create	Erstellen Sie den Skype-Kanal auf einem Bot.
az bot skype delete	Löschen Sie den Skype-Kanal auf einem Bot.
az bot skype show	Erhalten Sie Details des Skype-Kanals auf einem Bot.
az bot slack	Verwalten Sie den Slack-Kanal auf einem Bot.
az bot slack create	Erstellen Sie den Slack-Kanal auf einem Bot.
az bot slack delete	Löschen Sie den Slack-Kanal auf einem Bot.
az bot slack show	Erhalten Sie Details des Slack-Kanals auf einem Bot.
az bot sms	Verwalten Sie den SMS-Kanal auf einem Bot.
az bot sms create	Erstellen Sie den SMS-Kanal auf einem Bot.
az bot sms delete	Löschen Sie den SMS-Kanal auf einem Bot.
az bot sms show	Erhalten Sie Details des SMS-Kanals auf einem Bot.
az bot telegram	Verwalten Sie den Telegram-Kanal auf einem Bot.
az bot telegram create	Erstellen Sie den Telegram-Kanal auf einem Bot.
az bot telegram delete	Löschen Sie den Telegram-Kanal auf einem Bot.
az bot telegram show	Erhalten Sie Details des Telegram-Kanals auf einem Bot.
az bot update	Aktualisieren eines vorhandenen Bots.
az bot webchat	Verwalten des Webchatkanals auf einem Bot.
az bot webchat show	Erhalten Sie Details des Webchatkanals auf einem Bot.

az bot create

Erstellen Sie einen neuen v4 SDK-Bot.

Erstellen Sie einen neuen v4 SDK-Bot.

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

Erforderliche Parameter

--app-type

Microsoft App-Typ für den Bot.

--appid

Die Microsoft-Konto-ID (MSA-ID) für den Bot.

--name -n

Der Ressourcenname des Bots. Der Botname muss 4 bis 42 Zeichen lang sein. Er darf nur Bindestriche (-), Buchstaben (a – z, A – Z), Ziffern (0 – 9) und Unterstriche (_) enthalten.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

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

Die Schlüsseltresorschlüssel-URL, um die Verschlüsselung von vom Kunden verwalteten Schlüsseln zu ermöglichen.

--description -d

Die Beschreibung des Bots.

--display-name

Der Anzeigename des Bots. Wenn nicht angegeben, wird standardmäßig der Name des Bots verwendet.

--endpoint -e

Der Messagingendpunkt des Bots.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

Standardwert: global

--msi-resource-id

Microsoft App Managed Identity Resource ID für den Bot.

--sku

Die Sku des Bots.

Zulässige Werte: F0, S1

Standardwert: F0

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--tenant-id

Microsoft App-Mandanten-ID für den Bot.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az bot delete

Löschen eines vorhandenen Bots.

az bot delete --name
              --resource-group

Erforderliche Parameter

--name -n

Der Ressourcenname des Bots. Der Botname muss 4 bis 42 Zeichen lang sein. Er darf nur Bindestriche (-), Buchstaben (a – z, A – Z), Ziffern (0 – 9) und Unterstriche (_) enthalten.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az bot download

Laden Sie einen vorhandenen Bot herunter.

Der Quellcode wird aus der Web-App heruntergeladen, die dem Bot zugeordnet ist. Anschließend können Sie Änderungen an der App vornehmen und diese wieder in Ihre App veröffentlichen.

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

Erforderliche Parameter

--name -n

Der Ressourcenname des Bots. Der Botname muss 4 bis 42 Zeichen lang sein. Er darf nur Bindestriche (-), Buchstaben (a – z, A – Z), Ziffern (0 – 9) und Unterstriche (_) enthalten.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--save-path

Das Verzeichnis zum Herunterladen von Botcode auf.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az bot prepare-deploy

Hinzufügen von Skripts/Config-Dateien für die Veröffentlichung mit az webapp deployment.

Fügen Sie Skripts oder Konfigurationsdateien zum Stamm Ihres lokalen Quellcodeverzeichniss hinzu, um die Verwendung zu az webapp deploymentveröffentlichen. Wenn Ihr Code für Ihre App Service bereitgestellt wird, sollten die generierten Skripts oder Konfigurationsdateien auf App Service der Kudu-Webseite in D:homesitewwroot angezeigt werden.

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

Beispiele

Bereiten Sie sich darauf vor, "az webapp" zum Bereitstellen eines Javascript-Bots zu verwenden, indem Sie eine Node.js IIS-web.config-Datei abrufen.

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

Bereiten Sie sich darauf vor, "az webapp" zum Bereitstellen eines Csharp-Bots zu verwenden, indem Sie eine Bereitstellungsdatei erstellen.

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

Erforderliche Parameter

--lang

Die Sprache oder Laufzeit des Bots.

Zulässige Werte: Csharp, Javascript, Typescript

Optionale Parameter

--code-dir

Das Verzeichnis zum Platzieren der generierten Bereitstellungsdateien in. Standardeinstellungen für das aktuelle Verzeichnis, aus dem der Befehl aufgerufen wird.

--proj-file-path

Der Pfad zur CSPROj-Datei relativ zu --code-dir.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az bot prepare-publish

(Wartungsmodus) Fügen Sie Skripts zu Ihrem lokalen Quellcodeverzeichnis hinzu, um die Verwendung für v3 SDK-Bots zurückzugeben az bot publish .

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

Erforderliche Parameter

--name -n

Der Ressourcenname des Bots. Der Botname muss 4 bis 42 Zeichen lang sein. Er darf nur Bindestriche (-), Buchstaben (a – z, A – Z), Ziffern (0 – 9) und Unterstriche (_) enthalten.

--proj-file-path

Pfad zum Namen der Projektdatei des Startprojekts. (z. B. "./EchoBotWithCounter.csproj") Nur für C#erforderlich.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sln-name

Name der Startmappendateiname. Nur für C#erforderlich.

Optionale Parameter

--code-dir

Das Verzeichnis zum Herunterladen von Bereitstellungsskripts auf.

--version -v

Die Microsoft Bot Builder SDK-Version, die in der Botvorlage verwendet werden soll, die erstellt wird.

Zulässige Werte: v3, v4

Standardwert: v3

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az bot publish

Veröffentlichen Sie den zugeordneten App-Dienst eines Bots.

Veröffentlichen Sie Ihren Quellcode im zugeordneten App-Dienst Ihres Bots. Dies ist DEPRECATED für v4-Bots und wird nicht mehr für die Veröffentlichung von v4-Bots in Azure empfohlen. Verwenden az bot prepare-deploy Sie stattdessen Ihren v4-Bot und az webapp deployment stellen Sie sie bereit. Weitere Informationen finden Sie unter https://aka.ms/deploy-your-bot.

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

Beispiele

Veröffentlichen von Quellcode in Ihrem Azure-App aus dem Botcodeordner

az bot publish -n botName -g MyResourceGroup

Erforderliche Parameter

--name -n

Der Ressourcenname des Bots. Der Botname muss 4 bis 42 Zeichen lang sein. Er darf nur Bindestriche (-), Buchstaben (a – z, A – Z), Ziffern (0 – 9) und Unterstriche (_) enthalten.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--code-dir

Das Quellverzeichnis zum Hochladen von Botcode.

--keep-node-modules

Behalten Sie node_modules Ordner und führen Sie nicht auf dem App Service ausnpm install. Dies kann die Veröffentlichung von Befehlen für Node.js SDK-Bots erheblich beschleunigen.

Zulässige Werte: false, true

--proj-file-path

Pfad zum Namen der Projektdatei des Startprojekts. (z. B. "./EchoBotWithCounter.csproj").

--timeout -t

Konfigurierbares Timeout in Sekunden zum Überprüfen des Status der Bereitstellung.

--version -v

Die Microsoft Bot Builder SDK-Version des Bots.

Standardwert: v4

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az bot show

Rufen Sie einen vorhandenen Bot ab.

Erhalten Sie Informationen zu einem vorhandenen Bot. Um die Informationen abzurufen, die zum Herstellen einer Verbindung mit dem Bot erforderlich sind, verwenden Sie das --msbot-Flag mit dem Befehl.

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

Beispiele

Abrufen der erforderlichen Informationen zum Herstellen einer Verbindung mit einem vorhandenen Bot in Azure

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

Erforderliche Parameter

--name -n

Der Ressourcenname des Bots. Der Botname muss 4 bis 42 Zeichen lang sein. Er darf nur Bindestriche (-), Buchstaben (a – z, A – Z), Ziffern (0 – 9) und Unterstriche (_) enthalten.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--msbot

Zeigen Sie die Ausgabe als JSON-kompatibel mit einer Botdatei an.

Zulässige Werte: false, true

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az bot update

Aktualisieren eines vorhandenen Bots.

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]

Beispiele

Beschreibung eines Bots aktualisieren

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

Erforderliche Parameter

--name -n

Der Ressourcenname des Bots. Der Botname muss 4 bis 42 Zeichen lang sein. Er darf nur Bindestriche (-), Buchstaben (a – z, A – Z), Ziffern (0 – 9) und Unterstriche (_) enthalten.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

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

Azure-Anwendung Insights-API-Schlüssel, der zum Lesen von Botanalysedaten verwendet wird. Geben Sie einen Schlüssel an, wenn Sie Analysen zu Ihrem Bot im Analytics-Blatt anzeigen möchten.

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

Azure-Anwendung Insights Application ID verwendet, um Botanalysedaten zu lesen. Geben Sie eine ID an, wenn Sie Analysen zu Ihrem Bot im Analytics-Blatt anzeigen möchten.

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

Azure-Anwendung Insights Key, der zum Schreiben von Botanalysedaten verwendet wird. Geben Sie einen Schlüssel an, wenn Sie Botanalyse erhalten möchten.

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

Die URL des Schlüsseltresorschlüssels zum Aktivieren der Verschlüsselung von verwalteten Kundenschlüsseln.

--cmk-off

Legen Sie die Verschlüsselung auf Microsoft-Managed Schlüssel fest.

--description

Die neue Beschreibung des Bots.

--display-name -d

Der neue Anzeigename des Bots.

--endpoint -e

Der neue Endpunkt des Bots. Muss mit "https://" beginnen.

--icon-url

Symbol-URL für Bot-Avatar. Akzeptiert PNG-Dateien mit Dateigrößengrenze von 30 KB.

--sku

Die Sku des Bots.

Zulässige Werte: F0, S1

--tags

Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.