用途:引导用户把传统(原生)Power Pages 站点从 Bootstrap 3 迁移到 Bootstrap 5。仅适用于传统站点(Liquid 模板、.webtemplate.source.html、.html/.aspx/.ascx、*.css、sitesetting.yml),不适用于 React/Vue/Angular/Astro 代码站点。
主要能力:先校验 PAC CLI 与登录状态、确认目标环境;下载并备份站点;评估 Bootstrap 3 使用范围;运行 pac pages bootstrap-migrate 引擎生成 <folder>V5 副本(不修改源目录);审阅 logs.txt 变更报告;对引擎只能标记的残留项(网格层级、navbar 结构、panel/page-header/pager 样式、btn-block、Liquid 边界情况)按类别征得同意后应用修复;上传并自动启用运行时标志;最后验证。
必要用法:需安装 PAC CLI(dotnet tool install --global Microsoft.PowerApps.CLI.Tool),执行 pac auth who、pac pages list、pac pages download --path "<SITE_FOLDER>" --webSiteId "<WEBSITE_ID>"、pac pages bootstrap-migrate --path "<SITE_FOLDER>"、pac pages upload --path "<MIGRATED_FOLDER>"。上传前需确认 website.yml 含有效 adx_websiteid、sitesetting.yml 含 Site/BootstrapV5Enabled=true。标志翻转结果须查 pac-log.txt(grep BootstrapV5UploadPostProcessor),不能仅凭上传退出码。
限制:迁移为辅助式而非一键完成,视觉一致性不保证,需人工 QA;站点必须已激活(有已预配门户),否则标志翻转会跳过;残留修复可能破坏布局,模糊情况应标记而非猜测。