适用于:Windows Admin Center、Windows Admin Center 预览版
工具扩展是用户与 Windows 管理中心交互以管理连接(如服务器或群集)的主要方式。 当你在 Windows 管理中心主页屏幕上单击连接并连接时,会在左侧导航窗格中显示工具列表。 单击工具时,将加载该工具扩展并将其显示在右窗格中。
加载某个工具扩展后,它可以在目标服务器或群集上执行 WMI 调用或 PowerShell 脚本,并在 UI 中显示信息或根据用户输入执行命令。 工具扩展定义应该为其显示的解决方案,从而为每个解决方案提供一组不同的工具。
Note: 不熟悉不同的扩展类型? 了解有关 扩展性体系结构和扩展类型的详细信息。
准备环境
如果尚未准备好,请通过安装所有项目所需的依赖项和全局必备组件来 准备环境 。
使用 Windows 管理中心 CLI 创建新的工具扩展
所有依赖项安装完成后,即可创建新的工具扩展。 创建或浏览到包含项目文件的文件夹,打开命令提示符,然后将该文件夹设置为工作目录。 使用之前安装的 Windows 管理中心 CLI 创建新扩展,并使用以下语法:
wac create --company "{!Company Name}" --tool "{!Tool Name}"
| 值 | 说明 | 示例 |
|---|---|---|
{!Company Name} |
你的公司名称 (带有空格) | Contoso Inc |
{!Tool Name} |
你的工具名称 (带有空格) | Manage Foo Works |
下面是一个示例用法:
wac create --company "Contoso Inc" --tool "Manage Foo Works"
这将使用为工具指定的名称在当前工作目录中创建一个新文件夹,将所有必需的模板文件复制到你的项目中,并使用你的公司和工具名称配置文件。
接下来,将目录更改为刚创建的文件夹,然后通过运行以下命令安装所需的本地依赖项:
npm install
完成此操作后,已设置将新扩展加载到 Windows 管理中心所需的一切。
向扩展添加内容
现在,已使用 Windows 管理中心 CLI 创建了扩展,接下来可以自定义内容。 有关可执行的操作的示例,请参阅以下指南:
开发人员指南中提供了更多示例。 开发人员指南是一个功能齐全的解决方案扩展,可将其置于 Windows 管理中心,其中包含一系列丰富的示例功能和工具示例,你可以在自己的扩展中浏览和使用它们。
在 Windows 管理中心设置的 " 高级 " 页上启用开发人员指南扩展。
自定义扩展的图标
你可以在工具列表中自定义为你的扩展显示的图标。 为此,请修改 icon 扩展中的所有条目 manifest.json :
"icon": "{!icon-uri}",
| 值 | 说明 | 示例 uri |
|---|---|---|
{!icon-uri} |
图标资源的位置 | assets/foo-icon.svg |
注意:目前,在开发模式下加载扩展时,不会显示自定义图标。 解决方法是删除的内容,如下所示 target :
"target": "",
此配置仅适用于在开发模式下进行的端加载,因此,保留中包含的值 target 并在发布扩展之前还原它很重要。
生成和加载扩展
接下来,构建扩展并将其加载到 Windows 管理中心。 打开一个命令窗口,将目录更改为你的源目录,然后你就可以生成了。
-
用 gulp 构建并提供服务:
gulp build gulp serve --port 4201
请注意:你需要选择当前可用的端口。 请确保不要尝试使用正运行着 Windows Admin Center 的端口。
通过将本地服务项目附加到 Windows Admin Center,可使项目旁加载到 Windows Admin Center 的本地实例以进行测试。
-
在 Web 浏览器中启动 Windows Admin Center
-
打开调试程序 (F12)
-
打开控制台,并键入以下命令:
MsftSme.sideLoad("http://localhost:4201") -
刷新 Web 浏览器
项目现在将显示在工具列表中,名称旁边标有(旁加载)。
面向不同版本的 Windows 管理中心 SDK
通过 SDK 更改和平台更改,使扩展保持最新状态非常简单。 阅读有关如何以 不同版本 的 WINDOWS 管理中心 SDK 为目标的信息。
历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 nwashburn-ms)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
