Azure Cloud Shell を使用する
Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。 ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。
Azure Cloud Shell を開始するには:
| オプション |
例とリンク |
| コード ブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードは Cloud Shell に自動的にコピーされません。 |
 |
| https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。 |
 |
| Azure portal の右上にあるメニュー バーの [Cloud Shell] ボタンを選択します。 |
 |
Azure Cloud Shell でこの記事のコードを実行するには:
Cloud Shell を開始します。
[コピー] ボタンを選択して、コード ブロックをコードにコピーします。
Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードを Cloud Shell セッションに貼り付けます。
Enter キーを選択して、コードを実行します。
環境を準備する
Power BI Embedded 容量コマンドでは、バージョン 2.3.1 以降の Azure CLI を必要とします。 az --version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 インストールまたはアップグレードする必要には、「Azure CLI のインストール」をご覧ください。
サインインします。
CLI のローカル インストールを使用する場合は、az login コマンドを使用してサインインします。
az login
ターミナルに表示される手順に従って、認証プロセスを完了します。
Azure CLI 拡張機能をインストールします。
Azure CLI の拡張機能の参照を操作する場合は、最初に拡張機能をインストールする必要があります。 Azure CLI 拡張機能を使用すると、まだコア CLI の一部として出荷されていない実験用とプレリリースのコマンドにアクセスできます。 更新とアンインストールを含む拡張機能の詳細については、「Azure CLI で拡張機能を使用する」を参照してください。
次のコマンドを実行し、Power BI Embedded 容量の拡張機能をインストールします。
az extension add --name powerbidedicated
Azure CLI で容量を作成する
az Power BI embedded-capacity create コマンドを使用し、容量を作成します。
az powerbi embedded-capacity create --location westeurope
--name
--resource-group
--sku-name "A1"
--sku-tier "PBIE_Azure"
Azure CLI で容量を削除する
Azure CLI を使用して容量を削除するには、Azure Power BI embedded-capacity delete コマンドを使用します。
az powerbi embedded-capacity delete --name
--resource-group
Azure CLI で容量を管理する
Azure Power BI ですべての Power BI Embedded Azure CLI コマンドを表示できます。
Resource Manager テンプレートの使用
Resource Manager テンプレートは JavaScript Object Notation (JSON) ファイルであり、プロジェクトのインフラストラクチャと構成が定義されています。 このテンプレートでは、デプロイしようとしているものを、それを作成する一連のプログラミング コマンドを記述しなくても記述できる、宣言型の構文を使用しています。 Resource Manager テンプレートの開発に関する詳細を学ぶには、Resource Manager ドキュメントとテンプレート リファレンスを参照してください。
Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。
テンプレートを確認する
このクイックスタートで使用されるテンプレートは Azure クイックスタート テンプレートからのものです。
Azure リソースがテンプレート Microsoft.PowerBIDedicated/capacities Azで定義されたら、Power BI Embedded 容量を作成します。
このテンプレートを使用して、クラシック Power BI Embedded リソースを作成します。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"name": {
"type": "string",
"metadata": {
"description": "The capacity name, which is displayed in the Azure portal and the Power BI admin portal"
}
},
"location": {
"type": "string",
"defaultValue": "[resourceGroup().location]",
"metadata": {
"description": "The location where Power BI is hosted for your tenant"
}
},
"sku": {
"type": "string",
"allowedValues": [
"A1",
"A2",
"A3",
"A4",
"A5",
"A6"
],
"metadata": {
"description": "The pricing tier, which determines the v-core count and memory size for the capacity"
}
},
"admin": {
"type": "string",
"metadata": {
"description": "A user within your Power BI tenant, who will serve as an admin for this capacity"
}
}
},
"resources": [
{
"type": "Microsoft.PowerBIDedicated/capacities",
"apiVersion": "2021-01-01",
"name": "[parameters('name')]",
"location": "[parameters('location')]",
"sku": {
"name": "[parameters('sku')]"
},
"properties": {
"administration": {
"members": [
"[parameters('admin')]"
]
}
}
}
]
}
テンプレートのデプロイ
Azure にサインインして、テンプレートを開くには、次のリンクを選択します。 テンプレートによって Power BI Embedded 容量が作成されます。
必須情報を入力し、[確認および作成] を選択します。
サブスクリプション - 容量を作成するサブスクリプション。
リソース グループ - この新しい容量が含まれるリソース グループ。 既存のリソース グループから選択するか、新しく作成します。 詳細については、「Azure Resource Manager の概要」を参照してください。
リージョン - 容量が属するリージョン。
名前 - 容量名。
場所 - お使いのテナントの Power BI がホストされている場所。 既定の場所はホーム領域ですが、Multi-Geo オプションを使用して場所を変更できます。
SKU - 必要な A SKU。 詳細については、「SKU のメモリとコンピューティング能力」を参照してください。
管理者 - 容量の管理者。
注意
- 既定では、容量管理者は容量を作成するユーザーです。
- 別のユーザーまたはサービス プリンシパルを容量管理者として選択できます。
- 容量管理者は、容量がプロビジョニングされるテナントに属する必要があります。 企業間 (B2B) ユーザーを容量管理者にすることはできません。
デプロイの検証
デプロイを検証するには、次の手順に従います。
Azure Portal にサインインします。
検索ボックスで Power BI Embedded を検索します。
Power BI Embedded 容量の一覧を見て、作成した新しい容量が一覧に記載されていることを確認します。
リソースをクリーンアップする
作成した容量を削除するには、次の手順を実行します。
Azure Portal にサインインします。
検索ボックスで Power BI Embedded を検索します。
作成した容量のコンテキスト メニューを開き、[削除] をクリックします。
確認ページで、容量の名前を入力し、[削除] を選択します。
