az bot

Riferimento

Gestire servizio Bot di Microsoft Azure.

Comandi

Nome	Descrizione	Tipo	Stato
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.

az bot

Comandi

az bot create

Parametri necessari

Parametri facoltativi

az bot delete

Parametri necessari

az bot download

Parametri necessari

Parametri facoltativi

az bot prepare-deploy

Esempio

Parametri necessari

Parametri facoltativi

az bot prepare-publish

Parametri necessari

Parametri facoltativi

az bot publish

Esempio

Parametri necessari

Parametri facoltativi

az bot show

Esempio

Parametri necessari

Parametri facoltativi

az bot update

Esempio

Parametri necessari

Parametri facoltativi

Commenti e suggerimenti

Risorse aggiuntive