用途:在 PBIR 报表中管理页面与书签,无需连接 Power BI Desktop。页面是 definition/pages/ 下的文件夹,包含 page.json 与 visuals/ 目录。
主要能力:list-pages 列出页面显示名、顺序与可见性;get-page 返回名称、显示名、序号、画布宽高、显示选项、视觉对象数量、是否隐藏、页面类型及筛选与交互配置。add-page 可指定显示名、文件夹名与画布尺寸,默认 1280x720。delete-page 删除整个页面文件夹及其视觉对象。set-background 设置纯色背景,set-visibility 控制导航栏隐藏或显示。书签存于 definition/bookmarks/,支持列出、查看、添加、删除与切换可见性。
使用方式:在 pbi report 命令组下运行,如 pbi report add-page --display-name "Executive Overview"、pbi report set-visibility page_abc123 --hidden。路径可由 --path 显式指定,或从当前目录向上自动检测 *.Report/definition/,也可从 .pbip 找到同级 .Report 文件夹。写操作默认自动同步 Desktop,可用 --no-sync 批量抑制后调用 pbi report reload 一次性重载。加 --json 可输出 JSON。
限制:delete-page 不可恢复且会移除整个文件夹与视觉对象,删除前应导出 TMDL 或提交 git。set-visibility --hidden 不是安全边界,知道深层链接者仍可访问。get-page 可读取 drillthrough 页的 pageBinding,但 CLI 尚不支持创建 drillthrough 绑定,需在 Desktop 配置。add-page 序号按现有最高值递增,删除页面后可能产生视觉顺序错位。书签按视觉对象 ID 而非名称记录,重命名视觉对象后需重建书签。Drillthrough 配置经 Desktop 往返可能改写无关页面设置,提交前应对比差异。