Freigeben über


az bot

Microsoft Azure Bot Service verwalten.

Befehle

Name Beschreibung Typ Status
az bot authsetting

Verwalten von OAuth-Verbindungseinstellungen in einem Bot.

Core GA
az bot authsetting create

Erstellen Sie eine OAuth-Verbindungseinstellung für einen Bot.

Core GA
az bot authsetting delete

Löschen Sie eine OAuth-Verbindungseinstellung für einen Bot.

Core GA
az bot authsetting list

Alle OAuth-Verbindungseinstellungen in einem Bot anzeigen.

Core GA
az bot authsetting list-providers

Listendetails für alle Dienstanbieter auf, die zum Erstellen von OAuth-Verbindungseinstellungen verfügbar sind.

Core GA
az bot authsetting show

Zeigen Sie Details einer OAuth-Verbindungseinstellung für einen Bot an.

Core GA
az bot create

Erstellen Sie einen neuen v4 SDK-Bot.

Core GA
az bot delete

Löschen Eines vorhandenen Bots.

Core GA
az bot directline

Verwalten sie den Directline-Kanal auf einem Bot.

Core Preview
az bot directline create

Erstellen Sie den DirectLine-Kanal auf einem Bot, für den nur das v3-Protokoll aktiviert ist.

Core Preview
az bot directline delete

Löschen Sie den Directline-Kanal auf einem Bot.

Core Preview
az bot directline show

Rufen Sie Details des Directline-Kanals auf einem Bot ab.

Core Preview
az bot directline update

Aktualisieren Sie den DirectLine-Kanal auf einem Bot mit nur aktiviertem v3-Protokoll.

Core Preview
az bot download

Laden Sie einen vorhandenen Bot herunter.

Core Preview
az bot email

Verwalten des E-Mail-Kanals auf einem Bot.

Core Preview
az bot email create

Erstellen Sie den E-Mail-Kanal auf einem Bot.

Core Preview
az bot email delete

Löschen Sie den E-Mail-Kanal auf einem Bot.

Core Preview
az bot email show

Rufen Sie Details des E-Mail-Kanals auf einem Bot ab.

Core Preview
az bot facebook

Verwalten Sie den Facebook-Kanal auf einem Bot.

Core Preview
az bot facebook create

Erstellen Sie den Facebook-Kanal auf einem Bot.

Core Preview
az bot facebook delete

Löschen Sie den Facebook-Kanal auf einem Bot.

Core Preview
az bot facebook show

Rufen Sie Details des Facebook-Kanals auf einem Bot ab.

Core Preview
az bot kik

Verwalten Sie den Kik-Kanal auf einem Bot.

Core Preview
az bot kik create

Erstellen Sie den Kik-Kanal auf einem Bot.

Core Preview
az bot kik delete

Löschen Sie den Kik-Kanal auf einem Bot.

Core Preview
az bot kik show

Rufen Sie Details des Kik-Kanals auf einem Bot ab.

Core Preview
az bot msteams

Verwalten sie den Microsoft Teams-Kanal auf einem Bot.

Core Preview
az bot msteams create

Erstellen Sie den Microsoft Teams-Kanal auf einem Bot.

Core Preview
az bot msteams delete

Löschen Sie den Microsoft Teams-Kanal auf einem Bot.

Core Preview
az bot msteams show

Rufen Sie Details zum Microsoft Teams-Kanal auf einem Bot ab.

Core Preview
az bot prepare-deploy

Fügen Sie Skripts/Konfigurationsdateien für die Veröffentlichung mit az webapp deploymenthinzu.

Core GA
az bot prepare-publish

(Wartungsmodus) Fügen Sie Ihrem lokalen Quellcodeverzeichnis Skripts hinzu, um mit az bot publish für v3 SDK-Bots wieder veröffentlichen zu können.

Core Preview
az bot publish

Veröffentlichen sie im zugeordneten App-Dienst eines Bots.

Core Preview
az bot show

Abrufen eines vorhandenen Bots.

Core GA
az bot skype

Verwalten sie den Skype-Kanal auf einem Bot.

Core Preview
az bot skype create

Erstellen Sie den Skype-Kanal auf einem Bot.

Core Preview
az bot skype delete

Löschen Sie den Skype-Kanal auf einem Bot.

Core Preview
az bot skype show

Rufen Sie Details zum Skype-Kanal auf einem Bot ab.

Core Preview
az bot slack

Verwalten sie den Slack-Kanal auf einem Bot.

Core Preview
az bot slack create

Erstellen Sie den Slack-Kanal auf einem Bot.

Core Preview
az bot slack delete

Löschen Sie den Slack-Kanal auf einem Bot.

Core Preview
az bot slack show

Rufen Sie Details des Slack-Kanals auf einem Bot ab.

Core Preview
az bot sms

Verwalten sie den SMS-Kanal auf einem Bot.

Core Preview
az bot sms create

Erstellen Sie den SMS-Kanal auf einem Bot.

Core Preview
az bot sms delete

Löschen Sie den SMS-Kanal auf einem Bot.

Core Preview
az bot sms show

Rufen Sie Details des SMS-Kanals auf einem Bot ab.

Core Preview
az bot telegram

Verwalten Sie den Telegram-Kanal auf einem Bot.

Core Preview
az bot telegram create

Erstellen Sie den Telegram-Kanal auf einem Bot.

Core Preview
az bot telegram delete

Löschen Sie den Telegram-Kanal auf einem Bot.

Core Preview
az bot telegram show

Rufen Sie Details des Telegram-Kanals auf einem Bot ab.

Core Preview
az bot update

Aktualisieren eines vorhandenen Bots.

Core GA
az bot webchat

Verwalten sie den Webchat-Kanal auf einem Bot.

Core GA
az bot webchat show

Rufen Sie Details des Webchat-Kanals auf einem Bot ab.

Core GA

az bot create

Erstellen Sie einen neuen v4 SDK-Bot.

az bot create --app-type
              --appid
              --name
              --resource-group
              [--cmk --cmk-key-vault-key-url]
              [--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. Mögliche Werte sind: "UserAssignedMSI", "SingleTenant", "MultiTenant".

--appid

Die Microsoft-Konto-ID (MSA-ID), die mit dem Bot verwendet werden soll.

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

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

--description -d

Die Beschreibung des Bots.

Eigenschaft Wert
Parametergruppe: Registration Bot Specific Arguments
--display-name

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

Eigenschaft Wert
Parametergruppe: Registration Bot Specific Arguments
--endpoint -e

Der Messaging-Endpunkt des Bots.

Eigenschaft Wert
Parametergruppe: Registration Bot Specific Arguments
--location -l

Location. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

Eigenschaft Wert
Standardwert: global
--msi-resource-id

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

--sku

Die Sku des Bots.

Eigenschaft Wert
Parametergruppe: Registration Bot Specific Arguments
Standardwert: F0
Zulässige Werte: F0, S1
--tags

Durch Leerzeichen getrennte 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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az bot download

Vorschau

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

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--save-path

Das Verzeichnis, in das Botcode heruntergeladen werden soll.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az bot prepare-deploy

Fügen Sie Skripts/Konfigurationsdateien für die Veröffentlichung mit az webapp deploymenthinzu.

Fügen Sie Skripts oder Konfigurationsdateien zum Stammverzeichnis Ihres lokalen Quellcodeverzeichnisses hinzu, um mit az webapp deploymentverö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 auf die Verwendung von "az webapp" vor, um einen Javascript-Bot bereitzustellen, indem Sie eine Node.js IIS-web.config-Datei 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

--lang

Die Sprache oder Laufzeit des Bots.

Eigenschaft Wert
Zulässige Werte: Csharp, Javascript, Typescript

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--code-dir

Das Verzeichnis, in dem die generierten Bereitstellungsdateien platziert werden sollen. Standardmäßig wird das aktuelle Verzeichnis verwendet, von dem der Befehl aufgerufen wird.

--proj-file-path

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az bot prepare-publish

Vorschau

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 mit az bot publish für v3 SDK-Bots wieder veröffentlichen zu können.

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 Projektstartdatei. (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 des Dateinamens der Startlösung. Nur für C# erforderlich.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--code-dir

Das Verzeichnis, in das Bereitstellungsskripts heruntergeladen werden sollen.

--version -v

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

Eigenschaft Wert
Parametergruppe: Web/Function bot Specific Arguments
Standardwert: v3
Zulässige Werte: v3, v4
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az bot publish

Vorschau

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 Sie stattdessen az bot prepare-deploy und az webapp deployment, um Ihren v4-Bot bereitzustellen. 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 Ihrer Azure-App aus dem Bot-Codeordner

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--code-dir

Das Verzeichnis, aus dem Botcode hochgeladen werden soll.

--keep-node-modules

Behalten Sie node_modules Ordner bei, und führen Sie npm install nicht im App-Dienst aus. Dies kann die Veröffentlichung von Befehlen für Node.js SDK-Bots erheblich beschleunigen.

Eigenschaft Wert
Zulässige Werte: false, true
--proj-file-path

Pfad zum Namen der Projektstartdatei. (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.

Eigenschaft Wert
Standardwert: v4
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--msbot

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

Eigenschaft Wert
Zulässige Werte: false, true
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az bot update

Aktualisieren eines vorhandenen Bots.

az bot update --name
              --resource-group
              [--ai-api-key --app-insights-api-key]
              [--ai-app-id --app-insights-app-id]
              [--ai-key --app-insights-key]
              [--cmk --cmk-key-vault-key-url]
              [--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

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Azure Application Insights-API-Schlüssel zum Lesen von Botanalysedaten. Stellen Sie einen Schlüssel bereit, wenn Sie Analysen zu Ihrem Bot auf dem Blatt "Analyse" anzeigen möchten.

Eigenschaft Wert
Parametergruppe: Bot Analytics/Application Insights Arguments
--ai-app-id --app-insights-app-id

Azure Application 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.

Eigenschaft Wert
Parametergruppe: Bot Analytics/Application Insights Arguments
--ai-key --app-insights-key

Azure Application Insights Key, der zum Schreiben von Botanalysedaten verwendet wird. Geben Sie einen Schlüssel an, wenn Sie Bot-Analysen empfangen möchten.

Eigenschaft Wert
Parametergruppe: Bot Analytics/Application Insights Arguments
--cmk --cmk-key-vault-key-url

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

--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ößenbeschränkung von 30 KB.

--sku

Die Sku des Bots.

Eigenschaft Wert
Zulässige Werte: F0, S1
--tags

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False