若要在 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。 |
| 分隔符號 |
如果資料類型 是 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-0000000000.要将新报告与工作区 ID 相同的工作区关联，请留空。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
執行過程中出現錯誤 |
| 2 |
錯誤 |
驗證 Power BI 時出錯 |
建立資料集
若要在工作區中建立新資料集，請使用Create dataset 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 工作區 ID |
輸入工作區的 ID。 |
| 名稱 |
輸入資料集的名稱。 |
| 表格 |
輸入資料集中的資料表。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
執行過程中出現錯誤 |
| 2 |
錯誤 |
驗證 Power BI 時出錯 |
建立臨時上傳位置
若要建立臨時 blob 儲存空間，例如匯入 1 GB 到 10 GB 之間的 .PBIX 檔案，請使用Create temporary upload location 指令。
若要匯入大型 .PBIX 檔案，請建立臨時上傳位置，使用回應中的共用存取簽章 (SAS) URL 上傳 .PBIX 檔案，並呼叫 Post Import to Group 並指定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 時出錯 |
刪除報告
要從工作區刪除報告，請使用刪除報告 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 工作區 ID |
輸入工作區的 ID。 |
| 報表 ID |
輸入報告的 ID。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 1 |
錯誤 |
執行過程中出現錯誤 |
| 2 |
錯誤 |
驗證 Power BI 時出錯 |
匯出報告
若要從工作區匯出報表到 .PBIX 檔案，請使用Export report 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 工作區 ID |
輸入工作區的 ID。 |
| 報表 ID |
輸入報告的 ID。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 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 檔案在工作區上建立新內容，請使用Import file 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 工作區 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 進行驗證時發生錯誤 |