az bot
Microsoft Azure Bot Service verwalten.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az bot authsetting |
Verwalten von OAuth-Verbindungseinstellungen in einem Bot. |
Core | Allgemein verfügbar |
az bot authsetting create |
Erstellen Sie eine OAuth-Verbindungseinstellung für einen Bot. |
Core | Allgemein verfügbar |
az bot authsetting delete |
Löschen Sie eine OAuth-Verbindungseinstellung für einen Bot. |
Core | Allgemein verfügbar |
az bot authsetting list |
Alle OAuth-Verbindungseinstellungen in einem Bot anzeigen. |
Core | Allgemein verfügbar |
az bot authsetting list-providers |
Listendetails für alle Dienstanbieter auf, die zum Erstellen von OAuth-Verbindungseinstellungen verfügbar sind. |
Core | Allgemein verfügbar |
az bot authsetting show |
Zeigen Sie Details einer OAuth-Verbindungseinstellung für einen Bot an. |
Core | Allgemein verfügbar |
az bot create |
Erstellen Sie einen neuen v4 SDK-Bot. |
Core | Allgemein verfügbar |
az bot delete |
Löschen Eines vorhandenen Bots. |
Core | Allgemein verfügbar |
az bot directline |
Verwalten sie den Directline-Kanal auf einem Bot. |
Core | Vorschau |
az bot directline create |
Erstellen Sie den DirectLine-Kanal auf einem Bot, für den nur das v3-Protokoll aktiviert ist. |
Core | Vorschau |
az bot directline delete |
Löschen Sie den Directline-Kanal auf einem Bot. |
Core | Vorschau |
az bot directline show |
Rufen Sie Details des Directline-Kanals auf einem Bot ab. |
Core | Vorschau |
az bot directline update |
Aktualisieren Sie den DirectLine-Kanal auf einem Bot mit nur aktiviertem v3-Protokoll. |
Core | Vorschau |
az bot download |
Laden Sie einen vorhandenen Bot herunter. |
Core | Vorschau |
az bot email |
Verwalten des E-Mail-Kanals auf einem Bot. |
Core | Vorschau |
az bot email create |
Erstellen Sie den E-Mail-Kanal auf einem Bot. |
Core | Vorschau |
az bot email delete |
Löschen Sie den E-Mail-Kanal auf einem Bot. |
Core | Vorschau |
az bot email show |
Rufen Sie Details des E-Mail-Kanals auf einem Bot ab. |
Core | Vorschau |
az bot facebook |
Verwalten Sie den Facebook-Kanal auf einem Bot. |
Core | Vorschau |
az bot facebook create |
Erstellen Sie den Facebook-Kanal auf einem Bot. |
Core | Vorschau |
az bot facebook delete |
Löschen Sie den Facebook-Kanal auf einem Bot. |
Core | Vorschau |
az bot facebook show |
Rufen Sie Details des Facebook-Kanals auf einem Bot ab. |
Core | Vorschau |
az bot kik |
Verwalten Sie den Kik-Kanal auf einem Bot. |
Core | Vorschau |
az bot kik create |
Erstellen Sie den Kik-Kanal auf einem Bot. |
Core | Vorschau |
az bot kik delete |
Löschen Sie den Kik-Kanal auf einem Bot. |
Core | Vorschau |
az bot kik show |
Rufen Sie Details des Kik-Kanals auf einem Bot ab. |
Core | Vorschau |
az bot msteams |
Verwalten sie den Microsoft Teams-Kanal auf einem Bot. |
Core | Vorschau |
az bot msteams create |
Erstellen Sie den Microsoft Teams-Kanal auf einem Bot. |
Core | Vorschau |
az bot msteams delete |
Löschen Sie den Microsoft Teams-Kanal auf einem Bot. |
Core | Vorschau |
az bot msteams show |
Rufen Sie Details zum Microsoft Teams-Kanal auf einem Bot ab. |
Core | Vorschau |
az bot prepare-deploy |
Hinzufügen von Skripts/Konfigurationsdateien für die Veröffentlichung mit |
Core | Allgemein verfügbar |
az bot prepare-publish |
(Wartungsmodus) Fügen Sie Ihrem lokalen Quellcodeverzeichnis Skripts hinzu, um sie mithilfe von v3 SDK-Bots wieder veröffentlichen |
Core | Vorschau |
az bot publish |
Veröffentlichen sie im zugeordneten App-Dienst eines Bots. |
Core | Vorschau |
az bot show |
Abrufen eines vorhandenen Bots. |
Core | Allgemein verfügbar |
az bot skype |
Verwalten sie den Skype-Kanal auf einem Bot. |
Core | Vorschau |
az bot skype create |
Erstellen Sie den Skype-Kanal auf einem Bot. |
Core | Vorschau |
az bot skype delete |
Löschen Sie den Skype-Kanal auf einem Bot. |
Core | Vorschau |
az bot skype show |
Rufen Sie Details zum Skype-Kanal auf einem Bot ab. |
Core | Vorschau |
az bot slack |
Verwalten sie den Slack-Kanal auf einem Bot. |
Core | Vorschau |
az bot slack create |
Erstellen Sie den Slack-Kanal auf einem Bot. |
Core | Vorschau |
az bot slack delete |
Löschen Sie den Slack-Kanal auf einem Bot. |
Core | Vorschau |
az bot slack show |
Rufen Sie Details des Slack-Kanals auf einem Bot ab. |
Core | Vorschau |
az bot sms |
Verwalten sie den SMS-Kanal auf einem Bot. |
Core | Vorschau |
az bot sms create |
Erstellen Sie den SMS-Kanal auf einem Bot. |
Core | Vorschau |
az bot sms delete |
Löschen Sie den SMS-Kanal auf einem Bot. |
Core | Vorschau |
az bot sms show |
Rufen Sie Details des SMS-Kanals auf einem Bot ab. |
Core | Vorschau |
az bot telegram |
Verwalten Sie den Telegram-Kanal auf einem Bot. |
Core | Vorschau |
az bot telegram create |
Erstellen Sie den Telegram-Kanal auf einem Bot. |
Core | Vorschau |
az bot telegram delete |
Löschen Sie den Telegram-Kanal auf einem Bot. |
Core | Vorschau |
az bot telegram show |
Rufen Sie Details des Telegram-Kanals auf einem Bot ab. |
Core | Vorschau |
az bot update |
Aktualisieren eines vorhandenen Bots. |
Core | Allgemein verfügbar |
az bot webchat |
Verwalten sie den Webchat-Kanal auf einem Bot. |
Core | Allgemein verfügbar |
az bot webchat show |
Rufen Sie Details des Webchat-Kanals auf einem Bot ab. |
Core | Allgemein verfügbar |
az bot create
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
Microsoft App-Typ für den Bot. Mögliche Werte sind: "UserAssignedMSI", "SingleTenant", "MultiTenant".
Die Microsoft-Konto-ID (MSA-ID) für den Bot.
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.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Die Schlüssel-URL des Schlüsseltresors, um die Verschlüsselung von vom Kunden verwalteten Schlüsseln zu ermöglichen.
Die Beschreibung des Bots.
Der Anzeigename des Bots. Wenn nicht angegeben, wird standardmäßig der Name des Bots verwendet.
Der Messaging-Endpunkt des Bots.
Position Werte aus: az account list-locations
. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location>
konfigurieren.
Microsoft App Managed Identity Resource ID für den Bot.
Die Sku des Bots.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Microsoft App-Mandanten-ID für den Bot.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
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.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az bot download
Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
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 daran vornehmen und sie wieder in Ihrer App veröffentlichen.
az bot download --name
--resource-group
[--save-path]
Erforderliche Parameter
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.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Das Verzeichnis, in das Botcode heruntergeladen werden soll.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az bot prepare-deploy
Hinzufügen von Skripts/Konfigurationsdateien für die Veröffentlichung mit az webapp deployment
.
Fügen Sie Skripts oder Konfigurationsdateien zum Stammverzeichnis Ihres lokalen Quellcodeverzeichnisses hinzu, um sie mithilfe az webapp deployment
von . veröffentlichen zu können. Wenn Ihr Code für Ihren App-Dienst bereitgestellt wird, sollten die generierten Skripts oder Konfigurationsdateien auf der Kudu-Webseite des App-Diensts in D:\home\site\wwwroot 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 Datei "Node.js IIS web.config" abrufen.
az bot prepare-deploy --lang Javascript --code-dir "MyBotCode"
Bereiten Sie sich auf die Verwendung von "az webapp" vor, um einen Csharp-Bot bereitzustellen, indem Sie eine Bereitstellungsdatei erstellen.
az bot prepare-deploy --lang Csharp --code-dir "." --proj-file-path "MyBot.csproj"
Erforderliche Parameter
Die Sprache oder Laufzeit des Bots.
Optionale Parameter
Das Verzeichnis, in dem die generierten Bereitstellungsdateien platziert werden sollen. Standardmäßig wird das aktuelle Verzeichnis verwendet, von dem der Befehl aufgerufen wird.
Der Pfad zur CSPROJ-Datei relativ zu --code-dir.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az bot prepare-publish
Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
(Wartungsmodus) Fügen Sie Ihrem lokalen Quellcodeverzeichnis Skripts hinzu, um sie mithilfe von v3 SDK-Bots wieder veröffentlichen az bot publish
zu können.
az bot prepare-publish --name
--proj-file-path
--resource-group
--sln-name
[--code-dir]
[--version {v3, v4}]
Erforderliche Parameter
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.
Pfad zum Namen der Projektstartdatei. (z. B. "./EchoBotWithCounter.csproj") Nur für C# erforderlich.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Name des Dateinamens der Startlösung. Nur für C# erforderlich.
Optionale Parameter
Das Verzeichnis, in das Bereitstellungsskripts heruntergeladen werden sollen.
Die Microsoft Bot Builder SDK-Version, die in der bot-Vorlage verwendet werden soll, die erstellt wird.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az bot publish
Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Veröffentlichen sie im zugeordneten App-Dienst eines Bots.
Veröffentlichen Sie Ihren Quellcode im zugeordneten App-Dienst Ihres Bots. Dies ist veraltet für v4-Bots und wird nicht mehr für die Veröffentlichung von v4-Bots in Azure empfohlen. Verwenden az bot prepare-deploy
Und az webapp deployment
stellen Sie stattdessen Ihren v4-Bot bereit. Weitere Informationen findest du 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 Bot-Codeordner
az bot publish -n botName -g MyResourceGroup
Erforderliche Parameter
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.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Das Quellverzeichnis zum Hochladen von Botcode.
Behalten Sie node_modules Ordner bei, und führen Sie den App-Dienst nicht aus npm install
. Dies kann die Veröffentlichung von Befehlen für Node.js SDK-Bots erheblich beschleunigen.
Pfad zum Namen der Projektstartdatei. (z. B. "./EchoBotWithCounter.csproj").
Konfigurierbares Timeout in Sekunden zum Überprüfen des Status der Bereitstellung.
Die Microsoft Bot Builder SDK-Version des Bots.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az bot show
Abrufen eines vorhandenen Bots.
Abrufen von Informationen zu einem vorhandenen Bot. Um die informationen abzurufen, die zum Herstellen einer Verbindung mit dem Bot erforderlich sind, verwenden Sie das Flag "-msbot" 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
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.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Zeigen Sie die Ausgabe als JSON-kompatibel mit einer BOT-Datei an.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
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
Aktualisieren der Beschreibung für einen Bot
az bot update -n botName -g MyResourceGroup --endpoint "https://bing.com/api/messages" --display-name "Hello World"
Erforderliche Parameter
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.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Azure-App lication Insights API Key, der zum Lesen von Botanalysedaten verwendet wird. Stellen Sie einen Schlüssel bereit, wenn Sie Analysen zu Ihrem Bot auf dem Blatt "Analyse" anzeigen möchten.
Azure-App lication Insights-Anwendungs-ID, die zum Lesen von Botanalysedaten verwendet wird. Geben Sie eine ID an, wenn Sie Analysen zu Ihrem Bot auf dem Blatt "Analyse" anzeigen möchten.
Azure-App lication Insights Key, der zum Schreiben von Botanalysedaten verwendet wird. Geben Sie einen Schlüssel an, wenn Sie Bot-Analysen empfangen möchten.
Die Schlüssel-URL des Schlüsseltresors, um die Verschlüsselung von vom Kunden verwalteten Schlüsseln zu ermöglichen.
Legen Sie die Verschlüsselung auf von Microsoft verwaltete Schlüssel fest.
Die neue Beschreibung des Bots.
Der neue Anzeigename des Bots.
Der neue Endpunkt des Bots. Muss mit "https://" beginnen.
Symbol-URL für Bot-Avatar. Akzeptiert PNG-Dateien mit Dateigrößenbeschränkung von 30 KB.
Die Sku des Bots.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.