この記事の対象: SDK v4
この記事では、Azure PowerShell を使用してボットを作成し、既存の Microsoft Entra ID アプリケーション登録を使用して Azure に登録する方法について説明します。
Azure Bot リソースを使用してボットをホストします。 ボットをローカルで作成して開発し、Azure または別のプラットフォームでホストします。 Azure にボットを登録する方法に関するページに記載されている手順に従います。 ボットを登録するときに、ボットがホストされている Web アドレスを指定します。 引き続き Azure でホストできます。
これらのコマンドは、Azure PowerShell を使用してローカルで実行することも、Azure portal から Azure CloudShell を使用してリモートで実行することもできます。 Azure Cloud Shell の詳細については、「Azure Cloud Shell の概要」を参照してください。
重要
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 -AllowClobberAzure PowerShell をローカルで使用する場合は、次のようにします。
- Connect-AzAccount コマンドレットを使用して、Azure アカウントに接続します。
サブスクリプションの選択
複数の Azure サブスクリプションをお持ちの場合は、リソースが課金の対象となる適切なサブスクリプションを選択してください。
アクセスできる Azure サブスクリプションのリストを取得するには、Get-AzSubscription コマンドレットを使用します。
Get-AzSubscriptionSet-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>
新しい Bot Service を作成する
ボットの新しいボット サービスを作成するには、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
リソースをクリーンアップする
この記事で作成したリソースが不要であれば、次の例を実行して削除できます。
ボット サービスを削除する
リソース グループからボット サービスを削除するには、Remove-AzBotService コマンドレットを使用します。 次の例では、指定したリソース グループからボット サービスを削除します。
Remove-AzBotService -Name MyEchoBot -ResourceGroupName myResourceGroup
リソース グループを削除します
注意事項
次の例では、指定されたリソース グループとそれに含まれるすべてのリソースを削除します。 指定したリソース グループにこの記事の範囲外のリソースが存在する場合、それらも削除されます。
Remove-AzResourceGroup -Name myResourceGroup
次のステップ
コードをダウンロードしたら、お使いのコンピューターでボットをローカルで引き続き開発できます。 ボットをテストし、ボット コードを Azure portal にアップロードする準備ができたら、継続的デプロイの設定に関するトピックに記載されている手順に従って、変更後にコードを自動更新します。