Microsoft Power BI® でデータをエクスポートおよびインポートし、Power BI 導入を構成するさまざまなオブジェクトをチェーンの一部として管理するには、Microsoft Power BI 接続コマンドを含むステップを追加します。
これらのコマンドを有効にするには、IT 管理者がまずPower BI コネクタ を作成します。
注： コネクタは、多要素認証（MFA）が有効な Power BI には接続できません。
データセットに行を追加する
ワークスペースのデータセット内のテーブルに新しいデータ行を追加するには、Add rows to dataset コマンドを使用します。
注： このコマンドは、Power BI で無視されても重複行が追加されたと見なします。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| データセットID |
データセットのIDを入力してください。 |
| テーブル名 |
行を追加するテーブルの名前を入力する。 |
| データ |
テーブルに追加するデータを含むファイルを入力します。 |
| データ型 |
データ が JSON か CSV かを選択します。 |
| 区切り記号 |
Data Type が CSV の場合、ファイルで使用されている区切り記号を入力します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
データセットをゲートウェイにバインドする
ワークスペースのデータセットをゲートウェイにバインドするには、Bind dataset to gateway コマンドを使用します。オンプレミスデータゲートウェイからのみサポート。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| データセットID |
データセットのIDを入力してください。 |
| ゲートウェイ |
ゲートウェイのIDを入力する。 |
出力
なし
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
クローン報告
ワークスペースからレポートをクローンするには、Clone report コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| レポートID |
レポートのIDを入力します。 |
| 名称 |
作成された新しいレポートの名前を入力します。 |
| 対象データセットID |
新しいレポートのデータセットのIDを入力してください。新しいレポートをレポート ID と同じデータセットに関連付けるには、空白のままにします。 |
| 対象ワークスペースID |
新しいレポートのワークスペースの ID を入力します。マイ・ワークスペース」には、空の GUID00000000-0000-0000-0000-00000000 を入力します。新しいレポートをと同じワークスペースに関連付けるには、ワークスペース ID を空白にします。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
データセットの作成
ワークスペースに新しいデータセットを作成するには、Create dataset コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| 名称 |
データセットの名前を入力してください。 |
| テーブル |
データセットのテーブルを入力する。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
一時的なアップロード場所を作成する
1GB～10GBの.PBIXファイルをインポートするなど、一時的なブロブストレージを作成するには、一時的なアップロード場所を作成する コマンドを使用します。
大きな.PBIXファイルをインポートするには、一時的なアップロード場所を作成し、レスポンスから共有アクセス署名（SAS）URLを使用して.PBIXファイルをアップロードし、グループへのポストインポートを呼び出して、fileUrl をリクエスト本文のSAS URLに指定します。
注： 大容量の.PBIXファイルのインポートは、プレミアム容量のワークスペースおよび1 GB～10 GBの.PBIXファイルでのみ利用できます。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
テーブルのすべての行を削除する
ワークスペースのデータセット内のテーブルからすべての行を削除するには、Delete all rows in table コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| データセットID |
データセットのIDを入力してください。 |
| テーブル名 |
行を削除するテーブル名を入力する。 |
出力
なし
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
データセットの削除
ワークスペースからデータセットを削除するには、Delete dataset コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| データセットID |
データセットのIDを入力してください。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
レポート削除
ワークスペースからレポートを削除するには、Delete report コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| レポートID |
レポートのIDを入力します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
輸出レポート
ワークスペースから .PBIX ファイルにレポートをエクスポートするには、Export report コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| レポートID |
レポートのIDを入力します。 |
出力
| 出力 |
出力タイプ |
| レポートのエクスポート (.PBIX) |
ファイル |
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
データセットの取得
ワークスペースからデータセットを取得するには、Get dataset コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| データセットID |
データセットのIDを入力してください。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
データセット・データソースの取得
ワークスペースのデータセットのデータソースのリストを取得するには、Get dataset datasources コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| データセットID |
データセットのIDを入力してください。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
データセットのテーブルを取得する
ワークスペースのデータセット内のテーブルのリストを取得するには、Get dataset tables コマンドを使用します。
注： このコマンドはPushデータセットのみをサポートする。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| データセットID |
データセットのIDを入力してください。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
レポートを入手する
ワークスペースからレポートを取得するには、Get report コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| レポートID |
レポートのIDを入力します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
ファイルをインポート
.PBIX ファイルからワークスペースに新しいコンテンツを作成するには、ファイルをインポート コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| データセット名 |
ファイル拡張子を含むデータの表示名を入力します。 |
| 名前の衝突について |
同じ名前のデータセットがすでに存在する場合の処理を選択します。デフォルトでは、Ignore 。 |
| .PBIXファイル |
.PBIXファイルをインポートする場合は、インポートするファイルを入力します。ファイルは1GB以下でなければならない。 |
| 輸入情報 |
大きな.PBIXファイルをインポートする場合は、その詳細を入力します。 |
| 非同期実行 |
インポートの完了を待たないようにするには、このボックスにチェックを入れます。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
ダッシュボード一覧
ワークスペースに存在し、ユーザーがアクセスできるダッシュボードを一覧表示するには、List dashboards コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
データセット一覧
ワークスペースに存在し、ユーザーがアクセスできるデータセットを一覧表示するには、List datasets コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
ゲートウェイのデータソース一覧
ゲートウェイのデータソースを一覧表示するには、List gateway datasources コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ゲートウェイID |
ゲートウェイのIDを入力する。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
ゲートウェイ一覧
ユーザーが管理者であるゲートウェイをリストするには、List gateways コマンドを使用する。
プロパティ
なし
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
レポート一覧
ワークスペースからレポートを一覧表示するには、List reports コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
レポートをデータセットにバインドする
ワークスペースからデータセットにレポートをバインドし直すには、Rebind reports to dataset コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| レポートID |
レポートのIDを入力します。 |
| データセットID |
リバウンド・レポートの新しいデータセットのIDを入力してください。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
データセットを更新
ワークスペースのデータセットを更新するには、Refresh dataset コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| データセットID |
データセットのIDを入力してください。 |
| 通知タイプ |
更新完了時に送信する通知の種類を選択します。 |
出力
なし
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
レポート内容の更新
ワークスペースのレポートを別のレポートと同じ内容に更新するには、レポートの内容を更新する コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| レポートID |
レポートのIDを入力します。 |
| ソースレポートID |
ソース・レポートのIDを入力します。 |
| ソース・ワークスペースID |
ソース・レポートのあるワークスペースの ID を入力します。 |
出力
終了コード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |