Microsoft Power BI® でデータをエクスポートおよびインポートし、パワーバイオ導入を構成するさまざまなオブジェクトをチェーンの一部として管理するには、Microsoft Power BI 接続コマンドを含むステップを追加します。
これらのコマンドを有効にするには、IT 管理者がまずPower BI コネクター を作成します。
メモ： コネクターは、多要素認証（MFA）が有効な Power BI には接続できません。
データセットに行を追加する
ワークスペースのデータセット内のテーブルに新規データ行を追加するには、データセットに行を追加 コマンドを使用します。
メモ： このコマンドは、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-00000000 を入力します。新規レポートをと同じワークスペースに関連付けるには、ワークスペース ID を空白のままにします。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
データセット作成
ワークスペースに新規データセットを作成するには、データセットの作成 コマンドを使う。
プロパティ
| プロパティ |
詳細 |
| ワークスペースID |
ワークスペースのIDを入力します。 |
| 名称 |
データセットの名称を入力する。 |
| テーブル |
データセットのテーブルを入力する。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 1 |
エラー |
実行中にエラーが発生しました。 |
| 2 |
エラー |
Power BI で認証エラーが発生しました。 |
一時アップロード先の作成
1GB～10GBの.PBIXファイルをインポートするなど、一時的なブロブストレージを作成するには、一時的なアップロード場所を作成 コマンドを使用します。
大きな.PBIXファイルをインポートするには、一時的なアップロード場所を作成し、レスポンスから共有アクセス署名（SAS）URLを使用して.PBIXファイルをアップロードし、グループへの投稿インポートを呼び出し、fileUrl をリクエスト本文のSAS URLに指定します。
メモ： 大容量の.PBIXファイルのインポートは、プレミアム容量のワークスペース、および1GB～10GBの.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 ファイルにレポートをエクスポートするには、レポートをエクスポートコマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ワークスペース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を入力します。 |
| データセット名 |
拡張機能を含むデータの表示名称を入力します。 |
| 名称の対立について |
同じ名称のデータセットがすでに存在する場合の処理を選択します。デフォルトでは、無視 。 |
| .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 で認証エラーが発生しました。 |