Azure PowerShell を使用してボットを作成して発行する

適用対象: SDK v4

この記事では、Azure PowerShell を使用してボットを作成し、既存の Microsoft Entra ID アプリケーション登録を使用して Azure に登録する方法について説明します。

Azure Bot リソースを使用してボットをホストします。 ボットをローカルで作成して開発し、Azure または別のプラットフォームでホストします。 Azure にボットを登録する方法に関するページで説明されている手順に従います。 ボットを登録するときに、ボットがホストされている Web アドレスを指定します。 引き続き Azure でホストできます。

これらのコマンドは、Azure PowerShell を使用してローカルで実行することも、Azure Portal から Azure CloudShell を使用してリモートで実行することもできます。 Azure CloudShell の詳細については、「 Azure Cloud Shell の概要」を参照してください。

Important

Az.BotService PowerShell モジュールはプレビュー段階ですが、Install-Module コマンドレットを使用して個別にインストールする必要があります。

Azure AI Bot Service を使用してボットを作成し、ボットをローカルに作成することは、ボットを作成する独立した並列の方法です。

[前提条件]

  • Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

  • 任意の Microsoft Entra ID テナントから使用できる既存の Microsoft Entra ID アプリケーション登録。

    • このクイック スタートを完了するには、アプリケーション登録のアプリ ID とシークレットが必要です。

  • Az PowerShell モジュールをインストールします。 これは、Az.BotService モジュールがプレビュー段階であるために必要です。

    Install-Module -Name Az.BotService -AllowClobber

  • Azure PowerShell をローカルで使用する場合:

    • Connect-AzAccount コマンドレットを使用して、Azure アカウントに接続します。

サブスクリプションを選択する

複数の Azure サブスクリプションをお持ちの場合は、リソースが課金の対象となる適切なサブスクリプションを選択してください。

  1. アクセスできるサブスクリプションを一覧表示するには、 Get-AzSubscription コマンドレットを 使用します。

    Get-AzSubscription

  2. Set-AzContext コマンドレットを使用して特定のサブスクリプションを設定します。

    アプリケーションの登録と同じサブスクリプションをボットに使用する必要があります。

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

リソース グループを作成する

ボットに使用する Azure リソース グループ がまだない場合は、 New-AzResourceGroup コマンドレットを使用して新しいリソース グループを作成します。

  • リソース グループは、Azure リソースがグループとしてデプロイおよび管理される論理コンテナーです。

次の例では、指定した名前と指定した場所にリソース グループを作成します。

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

新しいボット サービスを作成する

ボットの新しいボット サービスを作成するには、 New-AzBotService コマンドレットを使用します。 次の例では、指定した値を使用して新しいボット サービスを作成します。

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 コマンドレットを使用します。 次の例では、指定したリソース グループ内のすべてのリソースの一覧を取得します。

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

プロジェクト フォルダーを初期化する

プロジェクト ファイル フォルダーを初期化するには、 Initialize-AzBotServicePrepareDeploy コマンドレットを 使用します。 次の例では、指定したフォルダー内の指定したファイルを初期化します。

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

ボット サービスを Azure に発行する

ボット サービスを Azure に発行するには、 Publish-AzBotServiceApp コマンドレットを使用します。 次の例では、指定したボット サービスを Azure に発行します。

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

コードをダウンロード

ローカルで動作するコードをダウンロードするには、 Export-AzBotServiceApp コマンドレットを使用します。 次の例では、指定したリソース グループ内の指定したボット サービス アプリのコードをダウンロードします。

Export-AzBotServiceApp -ResourceGroupName myResourceGroup -Name MyEchoBot

リソースをクリーンアップする

この記事で作成したリソースが必要ない場合は、次の例を実行して削除できます。

Bot Service を削除する

リソース グループから Bot Service を削除するには、 Remove-AzBotService コマンドレットを使用します。 次の例では、指定したリソース グループからボット サービスを削除します。

Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup

リソース グループを削除します

注意事項

次の例では、指定したリソース グループとその中に含まれるすべてのリソースを削除します。 指定したリソース グループにこの記事の範囲外のリソースが存在する場合、それらも削除されます。

Remove-AzResourceGroup -Name myResourceGroup

次のステップ

コードをダウンロードした後は、引き続きコンピューター上でローカルにボットを開発できます。 ボットをテストし、ボット コードを Azure portal にアップロードする準備ができたら、 継続的デプロイの設定 に関するトピックに記載されている手順に従って、変更後にコードを自動的に更新します。

  • Last updated on