Skapa och publicera en robot med Azure PowerShell

Artikel
10/27/2023

GÄLLER FÖR: SDK v4

Den här artikeln visar hur du använder Azure PowerShell för att skapa en robot och registrera den med Azure med hjälp av en befintlig Registrering av Microsoft Entra-ID-program.

Använd en Azure Bot-resurs som värd för din robot. Du skapar och utvecklar din robot lokalt och är värd för den på Azure eller en annan plattform. Följ stegen som beskrivs i hur du registrerar en robot med Azure. När du registrerar din robot anger du webbadressen där roboten finns. Du kan fortfarande vara värd för den i Azure.

Du kan köra dessa kommandon lokalt, med Hjälp av Azure PowerShell eller via en fjärranslutning via Azure-portalen med hjälp av Azure CloudShell. Mer information om Azure CloudShell finns i Översikt över Azure Cloud Shell.

Viktigt!

Även om Az.BotService PowerShell-modulen är i förhandsversion måste du installera den separat med hjälp av cmdletenInstall-Module.

Att skapa en robot med Azure AI Bot Service och skapa en robot lokalt är oberoende, parallella sätt att skapa en robot.

Förutsättningar

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.
En befintlig Microsoft Entra ID-programregistrering som kan användas från valfri Microsoft Entra-ID-klientorganisation.
- För att slutföra den här snabbstarten behöver du app-ID:t och hemligheten för programregistreringen.
Installera Az PowerShell-modulen. Detta krävs eftersom Az.BotService-modulen är i förhandsversion.
```
Install-Module -Name Az.BotService -AllowClobber
```
Om du väljer att använda Azure PowerShell lokalt:
- Anslut till ditt Azure-konto med cmdleten Anslut-AzAccount.

Välj din prenumeration

Om du har flera Azure-prenumerationer väljer du den prenumeration där resurserna ska faktureras.

Om du vill visa en lista över de prenumerationer som du kan komma åt använder du cmdleten Get-AzSubscription .
```
Get-AzSubscription
```
Ange den specifika prenumerationen med hjälp av cmdleten Set-AzContext .

Du bör använda samma prenumeration för din robot som för programregistreringen.
```
Set-AzContext -SubscriptionId "<your-subscription-name-or-id>"
```

Skapa en resursgrupp

Om du inte redan har en Azure-resursgrupp som du vill använda för din robot skapar du en ny med cmdleten New-AzResourceGroup .

En resursgrupp är en logisk container där Azure-resurser distribueras och hanteras som en grupp.

I följande exempel skapas en resursgrupp med det angivna namnet och på den angivna platsen.

New-AzResourceGroup -Name <your-resource-group-name> -Location <your-resource-group-location>

Skapa en ny robottjänst

Om du vill skapa en ny robottjänst för din robot använder du cmdleten New-AzBotService . I följande exempel skapas en ny robottjänst med de angivna värdena.

New-AzBotService -ResourceGroupName <your-resource-group-name> -Name <your-bot-handle> -ApplicationId <your-app-registration-id> -Location <your-bot-service-location> -Sku S1 -Description "<your-bot-description>" -Webapp

Om du vill hämta status för en robottjänst använder du cmdleten Get-AzBotService . I följande exempel hämtas en lista över alla resurser i den angivna resursgruppen.

Get-AzBotService -ResourceGroupName <your-resource-group-name>

Initiera projektmapp

Om du vill initiera projektfilmappen använder du cmdleten Initialize-AzBotServicePrepareDeploy . I följande exempel initieras den angivna filen i den angivna mappen.

Initialize-AzBotServicePrepareDeploy -CodeDir C:\tmp\MyEchoBot -ProjFileName MyEchoBot.csproj

Publicera robottjänsten till Azure

Om du vill publicera din robottjänst till Azure använder du cmdleten Publish-AzBotServiceApp . I följande exempel publiceras den angivna robottjänsten till Azure.

Publish-AzBotServiceApp -ResourceGroupName myResourceGroup -CodeDir D:\tmp\MyEchoBot -Name MyEchoBot

Ladda ned kod

Om du vill ladda ned koden för att fungera lokalt använder du cmdleten Export-AzBotServiceApp . I följande exempel hämtas koden för den angivna robottjänstappen i den angivna resursgruppen.

Export-AzBotServiceApp -ResourceGroupName myResourceGroup -Name MyEchoBot

Rensa resurser

Om resurserna som skapas i den här artikeln inte behövs kan du ta bort dem genom att köra följande exempel.

Ta bort robottjänsten

Om du vill ta bort bottjänsten från resursgruppen använder du cmdleten Remove-AzBotService . I följande exempel tas robottjänsten bort från den angivna resursgruppen.

Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup

Ta bort resursgruppen

Varning

I följande exempel tas den angivna resursgruppen och alla resurser som ingår i den bort. Om det finns resurser utanför omfånget för den här artikeln i den angivna resursgruppen tas de också bort.

Remove-AzResourceGroup -Name myResourceGroup

Nästa steg

När du har laddat ned koden kan du fortsätta att utveckla roboten lokalt på datorn. När du har testat roboten och är redo att ladda upp robotkoden till Azure-portalen följer du anvisningarna i avsnittet Konfigurera kontinuerlig distribution för att automatiskt uppdatera kod när du har ändrat.

Dela via