Condividi tramite

az bot

  • Riferimento

Gestire servizio Bot di Microsoft Azure.

Comandi

Nome Descrizione Tipo Status
az bot authsetting

Gestire le impostazioni di connessione OAuth in un bot.

 Core Disponibilità generale
az bot authsetting create

Creare un'impostazione di connessione OAuth in un bot.

 Core Disponibilità generale
az bot authsetting delete

Eliminare un'impostazione di connessione OAuth in un bot.

 Core Disponibilità generale
az bot authsetting list

Mostra tutte le impostazioni di connessione OAuth in un bot.

 Core Disponibilità generale
az bot authsetting list-providers

Elencare i dettagli per tutti i provider di servizi disponibili per la creazione di impostazioni di connessione OAuth.

 Core Disponibilità generale
az bot authsetting show

Visualizzare i dettagli di un'impostazione di connessione OAuth in un bot.

 Core Disponibilità generale
az bot create

Creare un nuovo bot SDK v4.

 Core Disponibilità generale
az bot delete

Eliminare un bot esistente.

 Core Disponibilità generale
az bot directline

Gestire il canale Directline in un bot.

 Core Anteprima
az bot directline create

Creare il canale DirectLine in un bot con solo il protocollo v3 abilitato.

 Core Anteprima
az bot directline delete

Eliminare il canale Directline in un bot.

 Core Anteprima
az bot directline show

Ottenere i dettagli del canale Directline in un bot.

 Core Anteprima
az bot directline update

Aggiornare il canale DirectLine in un bot con solo il protocollo v3 abilitato.

 Core Anteprima
az bot download

Scaricare un bot esistente.

 Core Anteprima
az bot email

Gestire il canale di posta elettronica in un bot.

 Core Anteprima
az bot email create

Creare il canale di posta elettronica in un bot.

 Core Anteprima
az bot email delete

Eliminare il canale di posta elettronica in un bot.

 Core Anteprima
az bot email show

Ottenere i dettagli del canale di posta elettronica in un bot.

 Core Anteprima
az bot facebook

Gestire il canale Facebook in un bot.

 Core Anteprima
az bot facebook create

Creare il canale Facebook in un bot.

 Core Anteprima
az bot facebook delete

Eliminare il canale Facebook in un bot.

 Core Anteprima
az bot facebook show

Ottenere i dettagli del canale Facebook su un bot.

 Core Anteprima
az bot kik

Gestire il canale Kik in un bot.

 Core Anteprima
az bot kik create

Creare il canale Kik in un bot.

 Core Anteprima
az bot kik delete

Eliminare il canale Kik in un bot.

 Core Anteprima
az bot kik show

Ottenere i dettagli del canale Kik in un bot.

 Core Anteprima
az bot msteams

Gestire il canale di Microsoft Teams in un bot.

 Core Anteprima
az bot msteams create

Creare il canale di Microsoft Teams in un bot.

 Core Anteprima
az bot msteams delete

Eliminare il canale di Microsoft Teams in un bot.

 Core Anteprima
az bot msteams show

Ottenere i dettagli del canale di Microsoft Teams in un bot.

 Core Anteprima
az bot prepare-deploy

Aggiungere script/file di configurazione per la pubblicazione con az webapp deployment.

 Core Disponibilità generale
az bot prepare-publish

(modalità manutenzione) Aggiungere script alla directory del codice sorgente locale per poter eseguire la pubblicazione usando az bot publish per i bot dell'SDK v3.

 Core Anteprima
az bot publish

Pubblicare nel servizio app associato a un bot.

 Core Anteprima
az bot show

Ottenere un bot esistente.

 Core Disponibilità generale
az bot skype

Gestire il canale Skype in un bot.

 Core Anteprima
az bot skype create

Creare il canale Skype in un bot.

 Core Anteprima
az bot skype delete

Eliminare il canale Skype in un bot.

 Core Anteprima
az bot skype show

Ottenere i dettagli del canale Skype in un bot.

 Core Anteprima
az bot slack

Gestire il canale Slack in un bot.

 Core Anteprima
az bot slack create

Creare il canale Slack in un bot.

 Core Anteprima
az bot slack delete

Eliminare il canale Slack in un bot.

 Core Anteprima
az bot slack show

Ottenere i dettagli del canale Slack in un bot.

 Core Anteprima
az bot sms

Gestire il canale SMS in un bot.

 Core Anteprima
az bot sms create

Creare il canale SMS in un bot.

 Core Anteprima
az bot sms delete

Eliminare il canale SMS in un bot.

 Core Anteprima
az bot sms show

Ottenere i dettagli del canale SMS in un bot.

 Core Anteprima
az bot telegram

Gestire il canale Telegram su un bot.

 Core Anteprima
az bot telegram create

Creare il canale Telegram su un bot.

 Core Anteprima
az bot telegram delete

Eliminare il canale Telegram su un bot.

 Core Anteprima
az bot telegram show

Ottenere i dettagli del canale Telegram su un bot.

 Core Anteprima
az bot update

Aggiornare un bot esistente.

 Core Disponibilità generale
az bot webchat

Gestire il canale Webchat in un bot.

 Core Disponibilità generale
az bot webchat show

Ottenere i dettagli del canale Webchat in un bot.

 Core Disponibilità generale

az bot create

Modifica

Creare un nuovo bot 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]

Parametri necessari

--app-type

Tipo di app Microsoft per il bot. I valori possibili includono: "UserAssignedMSI", "SingleTenant", "MultiTenant".

--appid

ID dell'account Microsoft (ID dell'account del servizio gestito) da usare con il bot.

--name -n

Nome della risorsa del bot. Il nome del bot deve avere una lunghezza compresa tra 4 e 42 caratteri e può contenere solo i caratteri seguenti: -, a - z, A - Z, 0 - 9 e _.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

URL della chiave dell'insieme di credenziali delle chiavi per abilitare la crittografia delle chiavi gestite dal cliente.

--description -d

Descrizione del bot.

--display-name

Nome visualizzato del bot. Se non specificato, per impostazione predefinita viene impostato il nome del bot.

--endpoint -e

Endpoint di messaggistica del bot.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

Valore predefinito: global
--msi-resource-id

ID risorsa identità gestita dell'app Microsoft per il bot.

--sku

Sku del bot.

Valori accettati: F0, S1
Valore predefinito: F0
--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--tenant-id

ID tenant dell'app Microsoft per il bot.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az bot delete

Modifica

Eliminare un bot esistente.

az bot delete --name
              --resource-group

Parametri necessari

--name -n

Nome della risorsa del bot. Il nome del bot deve avere una lunghezza compresa tra 4 e 42 caratteri e può contenere solo i caratteri seguenti: -, a - z, A - Z, 0 - 9 e _.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az bot download

Modifica
Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Scaricare un bot esistente.

Il codice sorgente viene scaricato dall'app Web associata al bot. È quindi possibile apportare modifiche e pubblicarla nuovamente nell'app.

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

Parametri necessari

--name -n

Nome della risorsa del bot. Il nome del bot deve avere una lunghezza compresa tra 4 e 42 caratteri e può contenere solo i caratteri seguenti: -, a - z, A - Z, 0 - 9 e _.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--save-path

Directory in cui scaricare il codice del bot.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az bot prepare-deploy

Modifica

Aggiungere script/file di configurazione per la pubblicazione con az webapp deployment.

Aggiungere script o file di configurazione alla radice della directory del codice sorgente locale per poter pubblicare tramite az webapp deployment. Quando il codice viene distribuito nel servizio app, gli script generati o i file di configurazione devono essere visualizzati in D:\home\site\wwwroot nella pagina Web Kudu di servizio app.

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

Esempio

Preparare l'uso di 'az webapp' per distribuire un bot Javascript recuperando un file Web.config IIS Node.js.

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

Preparare l'uso di 'az webapp' per distribuire un bot Csharp creando un file con estensione deployment.

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

Parametri necessari

--lang

Linguaggio o runtime del bot.

Valori accettati: Csharp, Javascript, Typescript

Parametri facoltativi

--code-dir

Directory in cui inserire i file di distribuzione generati. Il valore predefinito è la directory corrente da cui viene chiamato il comando .

--proj-file-path

Percorso del file con estensione csproj relativo a --code-dir.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az bot prepare-publish

Modifica
Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

(modalità manutenzione) Aggiungere script alla directory del codice sorgente locale per poter eseguire la pubblicazione usando az bot publish per i bot dell'SDK v3.

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

Parametri necessari

--name -n

Nome della risorsa del bot. Il nome del bot deve avere una lunghezza compresa tra 4 e 42 caratteri e può contenere solo i caratteri seguenti: -, a - z, A - Z, 0 - 9 e _.

--proj-file-path

Percorso del nome del file di progetto di avvio. (ad esempio "./EchoBotWithCounter.csproj") Obbligatorio solo per C#.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--sln-name

Nome del nome del file della soluzione di avvio. Obbligatorio solo per C#.

Parametri facoltativi

--code-dir

Directory in cui scaricare gli script di distribuzione.

--version -v

Versione di Microsoft Bot Builder SDK da usare nel modello di bot che verrà creato.

Valori accettati: v3, v4
Valore predefinito: v3
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az bot publish

Modifica
Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Pubblicare nel servizio app associato a un bot.

Pubblicare il codice sorgente nel servizio app associato al bot. Questa operazione è DEPRECATA per i bot v4 e non è più consigliata per la pubblicazione di bot v4 in Azure. Usare invece az bot prepare-deploy e az webapp deployment per distribuire il bot v4. Per altre informazioni, vedere https://aka.ms/deploy-your-bot.

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

Esempio

Pubblicare il codice sorgente nel app Azure, dall'interno della cartella del codice del bot

az bot publish -n botName -g MyResourceGroup

Parametri necessari

--name -n

Nome della risorsa del bot. Il nome del bot deve avere una lunghezza compresa tra 4 e 42 caratteri e può contenere solo i caratteri seguenti: -, a - z, A - Z, 0 - 9 e _.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--code-dir

Directory da cui caricare il codice del bot.

--keep-node-modules

Mantenere node_modules cartella e non eseguire npm install il servizio app. Ciò può velocizzare notevolmente i comandi di pubblicazione per i bot SDK Node.js.

Valori accettati: false, true
--proj-file-path

Percorso del nome del file di progetto di avvio. (ad esempio "./EchoBotWithCounter.csproj").

--timeout -t

Timeout configurabile in secondi per controllare lo stato della distribuzione.

--version -v

Versione di Microsoft Bot Builder SDK del bot.

Valore predefinito: v4
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az bot show

Modifica

Ottenere un bot esistente.

Ottenere informazioni su un bot esistente. Per ottenere le informazioni necessarie per connettersi al bot, usare il flag --msbot con il comando .

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

Esempio

Ottenere le informazioni necessarie per connettersi a un bot esistente in Azure

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

Parametri necessari

--name -n

Nome della risorsa del bot. Il nome del bot deve avere una lunghezza compresa tra 4 e 42 caratteri e può contenere solo i caratteri seguenti: -, a - z, A - Z, 0 - 9 e _.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--msbot

Visualizzare l'output come JSON compatibile con un file con estensione bot.

Valori accettati: false, true
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az bot update

Modifica

Aggiornare un bot esistente.

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]

Esempio

Aggiornare la descrizione in un bot

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

Parametri necessari

--name -n

Nome della risorsa del bot. Il nome del bot deve avere una lunghezza compresa tra 4 e 42 caratteri e può contenere solo i caratteri seguenti: -, a - z, A - Z, 0 - 9 e _.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

app Azure chiave API di Insights usata per leggere i dati di analisi dei bot. Fornire una chiave se si vuole visualizzare l'analisi del bot nel pannello Analisi.

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

app Azure ID applicazione di Application Insights usato per leggere i dati di analisi dei bot. Specificare un ID se si vuole visualizzare l'analisi del bot nel pannello Analisi.

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

app Azure lication Insights Key usato per scrivere dati di analisi del bot. Specificare una chiave se si vuole ricevere l'analisi del bot.

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

URL della chiave dell'insieme di credenziali delle chiavi per abilitare la crittografia delle chiavi gestite dal cliente.

--cmk-off

Impostare la crittografia su Chiavi gestite da Microsoft.

--description

Nuova descrizione del bot.

--display-name -d

Il nuovo nome visualizzato del bot.

--endpoint -e

Nuovo endpoint del bot. Deve iniziare con "https://".

--icon-url

URL icona per l'avatar del bot. Accetta file PNG con un limite di dimensioni file pari a 30 KB.

--sku

Sku del bot.

Valori accettati: F0, S1
--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.