如何将已完成的Powershell脚本部署为Windows Admin Center扩展
把现有PowerShell脚本嵌入Windows Admin Center(WAC)扩展的实现步骤
1. 前期准备
- 安装开发依赖:
Node.js 16.x LTS、Visual Studio Code、WAC官方SDK,同时本地部署一个WAC测试实例用于调试 - 优化已完成的PowerShell脚本:做无交互适配,删除所有需要用户手动输入的逻辑,输出统一为结构化JSON格式,所有虚拟机的CPU、内存、所属节点、所属集群等字段固定键名,可根据需求增加过滤参数(如集群名称、节点名称过滤),方便后续前端解析数据。
2. 扩展项目创建与脚本集成
- 使用WAC SDK的官方模板初始化一个新的扩展项目,类型选择工具扩展,适配集群、服务器两种连接场景
- 将优化后的PowerShell脚本放入项目的
\src\resources\scripts目录,项目打包时会自动处理脚本的权限映射 - 通过WAC SDK内置的
PowerShellRunner接口实现脚本调用,后端调用示例代码如下:
// WAC扩展后端调用自定义PowerShell脚本示例 const psSession = await this.context.powerShell.createSession(targetConnection); const runResult = await psSession.invokeCommand( ".\\Get-AllClusterVMConfig.ps1", // 替换为你的脚本实际文件名 [] // 可传入脚本所需参数,如集群过滤名、是否查询实时运行数据等 ); // 解析脚本返回的JSON结构 const vmConfigList = JSON.parse(runResult.output[0]);
3. 前端展示页面开发
- 采用WAC内置的Fluent UI适配组件库开发结果展示页,通过表格组件渲染所有虚拟机的CPU、内存等配置数据
- 可根据需求增加排序、字段筛选、导出CSV等功能,提升易用性
4. 打包部署与测试
- 执行SDK自带的打包命令,将扩展打包为
.nupkg格式的安装包 - 打开WAC测试实例,进入「设置」-「扩展」-「手动上传」,上传刚才打包的nupkg文件完成安装
- 功能测试:进入已添加的集群连接页,找到你开发的扩展入口,触发查询,确认返回的虚拟机配置数据和直接运行PowerShell脚本的结果完全一致
注意事项
- 权限匹配:WAC用于连接集群的账号必须具备对应集群节点的Hyper-V管理权限、远程PowerShell执行权限,避免脚本执行报错
- 性能优化:如果集群规模较大、虚拟机数量多,可给脚本增加分页查询参数,前端对应做懒加载处理,避免查询超时
- 异常处理:给脚本增加节点连接失败、权限不足等场景的异常捕获逻辑,返回结构化的错误信息,前端对应做提示展示,避免页面直接崩溃
内容的提问来源于stack exchange,提问作者Powershell21
相关产品推荐
相关产品推荐

