PowerBI-Cli 工具使用指南

03/28/2017

本文內容

PowerBI-Cli 命令行工具可以很方便地完成創建 workspace，上傳 report，創建令牌等工作，其主要功能介紹參見 PowerBI-Cli(以下簡稱官網)。本文主要目的是對官網內容進行中文介紹，以及添加一些必要的補充說明。

安裝 PowerBI-Cli 工具

npm 全稱是 Node Packaged Modules，是 nodejs 官方開發的一個 node.js 包管理器，可通過 npm 快速下載安裝 nodejs 的模塊包。在執行 npm install powerbi-cli -g 命令安裝 PowerBI-Cli 工具之前，需要先完成 npm 環境的安裝。

在安裝 npm 環境之前，需確保 nodejs 和 git 均已安裝。

備注

新版本的 nodejs 內置 npm，無需獨立安裝了，若使用的是新版本則無需繼續看以下內容。

npm 安裝步驟：

打開 git 命令行輸入以下命令，在 github 中 clone 下來 npm 的源碼包：

git clone --recursive git://github.com/isaacs/npm.git

下載完成后，打開 nodejs 命令行窗口，進入到 npm 的代碼文件下，使用以下令安裝：

node cli.js install npm -gf

等 npm 安裝完畢之后，便可用管理員身份執行以下命令安裝 PowerBI-Cli 工具了：

npm install powerbi-cli -g

PowerBI-Cli 命令

PowerBI-Cli 命令的格式為 powerbi [command] [options]

只有在執行正確命令中出現內容缺失或錯誤時才會報錯。

config 命令

powerbi config -c -k -w -b -r

config 命令用于獲取并存放需要在其他命令中所用到的配置值，其內容存放在該路徑下的 .powerbirc 文件中。

config 命令可存儲的配置值包括：

-c --collection

工作區集合名

-w --workspace

工作區 ID

-k --accessKey

工作區集合連接密鑰

-b --baseUri

HTTP 請求的 baseURI

備注

Power BI REST API 發送 HTTP 請求的 baseURI 默認值為 powerbi config -b https://api.powerbi.cn 使連接指向 Mooncake Power BI 的 base URI。

此外，為了方便操作，建議在不同的路徑下存儲不同的 .powerbirc 配置文件，如下所示：

get-workspaces 命令

powerbi get-workspaces -c -k

get-workspaces 命令用于獲取當前工作區集合中所有工作區的 ID。

create-workspace 命令

powerbi create-workspace -c -k

create-workspace 命令用于在當前的工作區集合中創建新的工作區。

import 命令

powerbi import -c -k -w -f -n

import 命令用于向當前的工作區上傳新的 .pbix 文件并返回相應的 import ID，其中 -f 后是 .pbix 文件在本機的絕對路徑，-n 后是給該數據集所起的標識名稱，如果此名稱已在該工作區中被使用，可輸入 -o [overwrite] 命令進行覆蓋。

反之則會另外創建一個同名的數據集。

get-datasets 命令

powerbi get-datasets -c -w -k

get-datasets 命令用于獲取當前工作區中所有數據集的基本信息。

get-reports 命令

powerbi get-reports -c -w -k

get-reports 命令用于獲取當前工作區中所有報表的基本信息。

update-connection 命令

powerbi update-connection -c -k -w -d -u [username] -p [password] -s [connectionString]

update-connection 命令用于對數據源連接進行更新。當上傳的數據集需要憑據時(例如用 DirectQuery 方式連接的數據源)，可使用此命令傳輸用戶名和密碼。

值得一提的是 -s 后所跟的連接字符串必須采用以下形式：

Data Source=tcp:MyServer.database.chinacloudapi.cn,1433;Initial Catalog=MyDatabase

而若輸入一般的服務器和數據庫屬性如：

Server=tcp:MyServer.database.chinacloudapi.cn,1433;Database=MyDatabase

在 PowerBI-Cli 工具中會被直接忽略，在其他工具(如通過 Power BI Embedded 在 Azure Web 應用中集成報告)中則會出現報錯。

但是此項參數只是可選項，可以不填。

由下各圖可見，對于用 direct query 連接方式創建的報表，直接上傳到 Power BI Embedded 的工作區后并不能展現，只有更新了數據源憑據后才可以展現出來。

delete-dataset 命令

powerbi delete-dataset -c -w -d -k

delete-dataset 命令用于刪除當前工作區中的數據集。由于 Power BI 報表是基于數據集的，所以當執行 delete-dataset 命令時，基于該數據集的所有報表，包括通過 clone-report 和 rebind-report 所生成的報表，都將被刪除。

create-embed-token 命令

powerbi create-embed-token -c , -w -r -k -u [username] --roles [roles1,roles2,...]

powerbi create-embed-token -c , -w -r -k -s [scopes]

powerbi create-embed-token -c , -w -d -k -s [scopes]

create-embed-token 命令用于創建令牌。令牌用于身份驗證和授權，其創建可基于報表 ID 或數據集 ID，前者支持用 RLS 和 scope 的方式進行用戶憑據設置，而后者則只支持用 scope 方式來實現此功能。

當創建好令牌后，可在 Sample Report 輸入 report ID, 令牌以及 EmbedURL 查看內嵌報表的展示效果：

此外可參考以下鏈接了解更多有關 Power BI Embedded 的身份驗證和授權方面的內容：通過 Power BI Embedded 進行身份驗證和授權。

clone-report 命令

powerbi clone-report -c -w -k -r -n

clone-report 命令用于給報表創建基于同一個數據集的拷貝。

rebind-report 命令

powerbi rebind-report -c -w -k -r -d

rebind-report 命令用于將某個 Power BI 報表綁定在另一個數據集上，但要求兩個數據集具有相同的 schema。

在以下例子中，AzureSQL_top20.pbix 和 AzureSQL_bottom20.pbix 的內容分別是同一張表格的最前 20 行的數據和最后 20 行的數據，通過 rebind-report 命令，AzureSQL_top20.pbix 的 report ID 被綁在 AzureSQL_bottom20.pbix 的 dataset ID 上，相當于用 clone-report 命令將后者的 report ID 進行拷貝。

之后再將 AzureSQL_top20.pbix 的 dataset ID 刪除，report ID 并沒有受到影響。

此命令開發的背景是由于 Power BI Embedded 的資費是基于會話(session)來定價的(詳情參考 Power BI Embedded)，當一個 report ID 或 dataset ID 所生成的令牌被展示網頁調用時，便是一個會話的開始。會話結束可以按用戶關閉報表來算，也可以按啟動會話一個小時后來算，以先發生者為準。

因此若客戶希望瀏覽不同的數據集，且令牌生成是基于 report ID 的情況下，可以通過 rebind-report 命令將同一個 report ID 先后綁定在不同的 dataset ID 上，這樣便可以在無需生成新的會話(一小時內)的前提下瀏覽更多的報表數據。

總結

以上是生活随笔為你收集整理的powerbi使用说明_PowerBI-Cli 工具使用指南的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。