大网数据广告活动
Windows Server 管理

开发工具扩展

· 52CE 我爱测

工具扩展是用户与 Windows 管理中心交互以管理连接(如服务器或群集)的主要方式。 当你在 Windows 管理中心主页屏幕上单击连接并连接时,会在左侧导航窗格中显示工具列表。 单击工具时,将加载该工具扩展并将其显示在右窗格中。

适用于: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,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Windows Server 中文文档历史快照
适用范围
历史中文快照 2021-03-23;详见原文产品版本;文档日期 09/18/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。