你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 Azure PowerShell 创建和发布机器人

适用于:SDK v4

本文介绍如何使用 Azure PowerShell 创建机器人,以及使用现有的 Microsoft Entra ID 应用程序注册将其注册到 Azure。

使用 Azure 机器人资源托管机器人。 将在本地创建和开发机器人,并将其托管于 Azure 或其他平台上。 按照如何将机器人注册到 Azure 中所述的步骤进行操作。 注册机器人时,提供托管机器人的 Web 地址。 仍然可以在 Azure 中进行托管。

可以使用 Azure PowerShell 在本地运行这些命令,也可以使用 Azure CloudShell 通过 Azure 门户远程运行这些命令。 有关 Azure CloudShell 的详细信息,请参阅 Azure Cloud Shell 概述

重要

尽管 Az.BotService PowerShell 模块为预览版,但需要使用 Install-Module cmdlet 单独安装它。

通过 Azure AI 机器人服务创建机器人和在本地创建机器人是创建机器人时使用的两种独立的并行方式。

先决条件

  • 如果没有 Azure 订阅,请在开始之前创建一个免费帐户

  • 现有 Microsoft Entra ID 应用程序注册,可通过任一 Microsoft Entra ID 租户使用。

    • 如要完成快速启动,需要应用程序注册的应用 ID 和机密。
  • 安装 Az PowerShell 模块。 这是必要步骤,因为 Az.BotService 模块为预览版。

    Install-Module -Name Az.BotService -AllowClobber
    
  • 如果选择在本地使用 Azure PowerShell:

选择自己的订阅

如果有多个 Azure 订阅,请选择应当计费的资源所在的相应订阅。

  1. 使用 Get-AzSubscription cmdlet 获取你有权访问的订阅的列表。

    Get-AzSubscription
    
  2. 使用 Set-AzContext cmdlet 选择特定订阅。

    应为机器人使用与应用程序注册相同的订阅。

    Set-AzContext -SubscriptionId "<your-subscription-name-or-id>"
    

创建资源组

如果没有想为机器人采用的 Azure 资源组,可以使用 New-AzResourceGroup cmdlet 新建一个。

  • 资源组是在其中以组的形式部署和管理 Azure 资源的逻辑容器。

以下示例在指定位置创建具有指定名称的资源组。

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

创建新的机器人服务

如要为机器人新建机器人服务,请使用 New-AzBotService cmdlet。 以下示例新建了一个具有指定值的机器人服务。

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

如要检索机器人服务的状态,请使用 Get-AzBotService cmdlet。 以下示例获取了指定资源组包含的所有资源的列表。

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

初始化项目文件夹

如要初始化项目文件夹,请使用 Initialize-AzBotServicePrepareDeploy cmdlet。 以下示例初始化了指定文件夹中的指定文件。

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

将机器人服务发布到 Azure

如要将机器人服务发布到 Azure,请使用 Publish-AzBotServiceApp cmdlet。 以下示例将指定的机器人服务发布到了 Azure。

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

下载代码

如要下载代码在本地运行,请使用 Export-AzBotServiceApp cmdlet。 以下示例下载了指定资源组中指定机器人服务应用的代码。

Export-AzBotServiceApp -ResourceGroupName myResourceGroup -Name MyEchoBot

清理资源

如果不再需要使用本文中创建的资源,可以运行以下示例将其删除。

删除机器人服务

如要从资源组中删除机器人服务,请使用 Remove-AzBotService cmdlet。 以下示例删除了指定资源组中的机器人服务。

Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup

删除资源组

注意

以下示例删除指定的资源组及其包含的所有资源。 如果指定的资源组中存在本文范围外的资源,这些资源也会被删除。

Remove-AzResourceGroup -Name myResourceGroup

后续步骤

下载代码后,可以继续在本地计算机上开发机器人。 测试了机器人并已准备好将机器人代码上传到 Azure 门户后,请按照设置持续部署主题下列出的说明执行操作,在进行更改后自动更新代码。