Sdílet prostřednictvím


az bot

Správa služby Microsoft Azure Bot Service

Příkazy

Name Description Typ Stav
az bot authsetting

Správa nastavení připojení OAuth v robotovi

Základ GA
az bot authsetting create

Vytvořte nastavení připojení OAuth v robotovi.

Základ GA
az bot authsetting delete

Odstraňte nastavení připojení OAuth v robotovi.

Základ GA
az bot authsetting list

Zobrazí všechna nastavení připojení OAuth v robotovi.

Základ GA
az bot authsetting list-providers

Seznam podrobností pro všechny poskytovatele služeb, kteří jsou k dispozici pro vytváření nastavení připojení OAuth.

Základ GA
az bot authsetting show

Zobrazení podrobností o nastavení připojení OAuth v robotovi

Základ GA
az bot create

Vytvořte nového robota sady SDK v4.

Základ GA
az bot delete

Odstraňte existujícího robota.

Základ GA
az bot directline

Spravujte kanál Directline v robotovi.

Základ Preview
az bot directline create

Vytvořte kanál DirectLine na robotovi s povoleným protokolem v3.

Základ Preview
az bot directline delete

Odstraňte kanál Directline v robotovi.

Základ Preview
az bot directline show

Získejte podrobnosti o kanálu Directline na robotovi.

Základ Preview
az bot directline update

Aktualizujte kanál DirectLine na robotovi jenom s povoleným protokolem v3.

Základ Preview
az bot download

Stáhněte si existujícího robota.

Základ Preview
az bot email

Správa e-mailového kanálu v robotovi

Základ Preview
az bot email create

Vytvořte e-mailový kanál na robotovi.

Základ Preview
az bot email delete

Odstraňte e-mailový kanál na robotovi.

Základ Preview
az bot email show

Získejte podrobnosti o e-mailovém kanálu robota.

Základ Preview
az bot facebook

Spravujte facebookový kanál na robotovi.

Základ Preview
az bot facebook create

Vytvořte facebookový kanál na robotovi.

Základ Preview
az bot facebook delete

Odstraňte facebookový kanál na robotovi.

Základ Preview
az bot facebook show

Získejte podrobnosti o facebookovém kanálu na robotovi.

Základ Preview
az bot kik

Spravujte kanál Kik na robotovi.

Základ Preview
az bot kik create

Vytvořte kanál Kik na robotovi.

Základ Preview
az bot kik delete

Odstraňte kanál Kik na robotovi.

Základ Preview
az bot kik show

Získejte podrobnosti o kanálu Kik na robotovi.

Základ Preview
az bot msteams

Spravujte kanál Microsoft Teams v robotovi.

Základ Preview
az bot msteams create

Vytvořte kanál Microsoft Teams na robotovi.

Základ Preview
az bot msteams delete

Odstraňte kanál Microsoft Teams na robotovi.

Základ Preview
az bot msteams show

Získejte podrobnosti o kanálu Microsoft Teams na robotovi.

Základ Preview
az bot prepare-deploy

Přidání skriptů/konfiguračních souborů pro publikování pomocí az webapp deploymentnástroje .

Základ GA
az bot prepare-publish

(Režim údržby) Přidejte skripty do místního adresáře zdrojového kódu, abyste mohli publikovat zpět pomocí az bot publish robotů sady SDK v3.

Základ Preview
az bot publish

Publikujte do služby App Service přidruženého k robotovi.

Základ Preview
az bot show

Získejte existujícího robota.

Základ GA
az bot skype

Spravujte kanál Skype na robotovi.

Základ Preview
az bot skype create

Vytvořte kanál Skype na robotovi.

Základ Preview
az bot skype delete

Odstraňte kanál Skype na robotovi.

Základ Preview
az bot skype show

Získejte podrobnosti o kanálu Skype na robotovi.

Základ Preview
az bot slack

Spravujte kanál Slack na robotovi.

Základ Preview
az bot slack create

Vytvořte na robotovi kanál Slack.

Základ Preview
az bot slack delete

Odstraňte kanál Slack na robotovi.

Základ Preview
az bot slack show

Získejte podrobnosti o kanálu Slack na robotovi.

Základ Preview
az bot sms

Spravujte kanál SMS na robotovi.

Základ Preview
az bot sms create

Vytvořte kanál SMS na robotovi.

Základ Preview
az bot sms delete

Odstraňte kanál SMS na robotovi.

Základ Preview
az bot sms show

Získejte podrobnosti o kanálu SMS na robotovi.

Základ Preview
az bot telegram

Spravujte kanál AplikaceGraf na robotovi.

Základ Preview
az bot telegram create

Vytvoření kanáluKanálu AplikaceGraf na robotovi.

Základ Preview
az bot telegram delete

Odstraňte kanál AplikaceGraf na robotovi.

Základ Preview
az bot telegram show

Získejte podrobné informace o kanáluGraf na robotovi.

Základ Preview
az bot update

Aktualizujte existujícího robota.

Základ GA
az bot webchat

Spravujte kanál Webchatu na robotovi.

Základ GA
az bot webchat show

Získejte podrobnosti o kanálu Webchat na robotovi.

Základ GA

az bot create

Vytvořte nového robota sady SDK v4.

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

Povinné parametry

--app-type

Typ aplikace Microsoftu pro robota Mezi možné hodnoty patří: UserAssignedMSI, SingleTenant, MultiTenant.

--appid

ID účtu Microsoft (MSA ID), které se má použít s robotem.

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

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

Adresa URL klíče trezoru klíčů umožňující šifrování klíčů spravovaných zákazníkem.

--description -d

Popis robota.

--display-name

Zobrazovaný název robota. Pokud není zadaný, nastaví se výchozí název robota.

--endpoint -e

Koncový bod zasílání zpráv robota.

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

Default value: global
--msi-resource-id

ID prostředku spravované identity aplikace Microsoftu pro robota

--sku

Skladová položka robota.

Přípustné hodnoty: F0, S1
Default value: F0
--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--tenant-id

ID tenanta aplikace Microsoftu pro robota

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot delete

Odstraňte existujícího robota.

az bot delete --name
              --resource-group

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot download

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Stáhněte si existujícího robota.

Zdrojový kód se stáhne z webové aplikace přidružené k robotovi. Potom můžete provést změny a publikovat ho zpět do aplikace.

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

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--save-path

Adresář pro stažení kódu robota do.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot prepare-deploy

Přidání skriptů/konfiguračních souborů pro publikování pomocí az webapp deploymentnástroje .

Přidejte skripty nebo konfigurační soubory do kořenového adresáře místního zdrojového kódu, aby bylo možné publikovat pomocí az webapp deployment. Po nasazení kódu do vaší služby App Service by se vygenerované skripty nebo konfigurační soubory měly objevit na webové stránce D:\home\site\wwwroot na webové stránce Kudu služby App Service.

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

Příklady

Připravte se na nasazení javascriptového robota pomocí příkazu az webapp načtením souboru Node.js IIS web.config.

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

Připravte se na nasazení robota Csharp pomocí příkazu az webapp vytvořením souboru .deployment.

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

Povinné parametry

--lang

Jazyk nebo modul runtime robota.

Přípustné hodnoty: Csharp, Javascript, Typescript

Volitelné parametry

--code-dir

Adresář pro umístění vygenerovaných souborů nasazení. Ve výchozím nastavení se příkaz volá z aktuálního adresáře.

--proj-file-path

Cesta k souboru .csproj vzhledem k souboru --code-dir.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot prepare-publish

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

(Režim údržby) Přidejte skripty do místního adresáře zdrojového kódu, abyste mohli publikovat zpět pomocí az bot publish robotů sady SDK v3.

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

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--proj-file-path

Cesta k názvu spouštěcího souboru projektu (Např. "./EchoBotWithCounter.csproj") Vyžaduje se pouze pro jazyk C#.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--sln-name

Název spouštěcího souboru řešení Vyžaduje se pouze pro jazyk C#.

Volitelné parametry

--code-dir

Adresář ke stažení skriptů nasazení do.

--version -v

Verze sady MICROSOFT Bot Builder SDK, která se použije v šabloně robota, která se vytvoří.

Přípustné hodnoty: v3, v4
Default value: v3
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot publish

Preview

Tento příkaz je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Publikujte do služby App Service přidruženého k robotovi.

Publikujte zdrojový kód do služby App Service přidruženého k robotovi. Tato možnost je pro roboty v4 zastaralá a už se nedoporučuje publikovat roboty v4 do Azure. Místo toho použijte az bot prepare-deploy a az webapp deployment nasaďte robota v4. Další informace najdete tady: 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říklady

Publikování zdrojového kódu do Aplikace Azure ze složky kódu robota

az bot publish -n botName -g MyResourceGroup

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--code-dir

Adresář pro nahrání kódu robota z.

--keep-node-modules

Ponechte node_modules složku a nespouští npm install se ve službě App Service. To může výrazně urychlit publikování příkazů pro roboty node.js SDK.

Přípustné hodnoty: false, true
--proj-file-path

Cesta k názvu spouštěcího souboru projektu (Např. "./EchoBotWithCounter.csproj").

--timeout -t

Konfigurovatelný časový limit v sekundách pro kontrolu stavu nasazení

--version -v

Verze sady Microsoft Bot Builder SDK robota.

Default value: v4
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot show

Získejte existujícího robota.

Získejte informace o existujícím robotovi. K získání informací potřebných pro připojení k robotovi použijte příznak --msbot s příkazem.

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

Příklady

Získání informací potřebných pro připojení k existujícímu robotovi v Azure

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

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

--msbot

Zobrazte výstup jako JSON kompatibilní se souborem .bot.

Přípustné hodnoty: false, true
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az bot update

Aktualizujte existujícího robota.

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říklady

Aktualizace popisu robota

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

Povinné parametry

--name -n

Název prostředku robota. Název robota musí být dlouhý 4 až 42 znaků. Název robota může obsahovat pouze následující znaky: -, a–z, A–Z, 0–9 a _.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Volitelné parametry

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

Aplikace Azure Přehledy klíč rozhraní API používaný ke čtení analytických dat robota. Pokud chcete zobrazit analýzu robota v okně Analýza, zadejte klíč.

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

Aplikace Azure Přehledy ID aplikace používané ke čtení dat analýzy robota. Pokud chcete zobrazit analýzu robota v okně Analýza, zadejte ID.

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

Aplikace Azure Přehledy Klíč použitý k zápisu analytických dat robota. Pokud chcete přijímat analýzy robota, zadejte klíč.

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

Adresa URL klíče trezoru klíčů umožňující šifrování klíčů spravovaných zákazníkem.

--cmk-off

Nastavte šifrování na klíče spravované Microsoftem.

--description

Nový popis robota.

--display-name -d

Nový zobrazovaný název robota.

--endpoint -e

Nový koncový bod robota. Musí začínat na "https://".

--icon-url

Adresa URL ikony pro avatar robota Přijímá soubory PNG s limitem velikosti souboru 30 kB.

--sku

Skladová položka robota.

Přípustné hodnoty: F0, S1
--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.