Поделиться через

Разработка расширения инструмента

  • Применяется к: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Расширение средства — это основной способ взаимодействия пользователей с Windows Admin Center для управления подключением, например сервером или кластером. Щелкнув на подключение на начальном экране Центра администрирования Windows и подключившись, вы увидите список инструментов в области навигации слева. Щелкнув инструмент, расширение инструмента загружается и отображается в правой области.

При загрузке расширения средства он может выполнять вызовы WMI или скрипты PowerShell на целевом сервере или кластере и отображать сведения в пользовательском интерфейсе или выполнять команды на основе ввода пользователем. Расширения инструментов определяют, какие решения должны отображаться для каждого решения, что приводит к разным наборам инструментов для каждого решения.

Замечание

Не знакомы с различными типами расширений? Дополнительные сведения об архитектуре расширяемости и типах расширений.

Подготовьте вашу среду

Если вы еще не сделали этого, подготовьте среду , установив зависимости и глобальные предварительные требования, необходимые для всех проектов.

Создание расширения средства с помощью пакета SDK для Windows Admin Center

После установки всех зависимостей вы будете готовы к созданию расширения нового средства. Создайте или перейдите к папке, содержащей файлы проекта, откройте командную строку и задайте ее в качестве рабочего каталога. Используя ранее установленный пакет SDK Для Windows Admin Center, создайте новое расширение со следующим синтаксисом:

wac create --company "{!Company Name}" --tool "{!Tool Name}" --version latest
Ценность Объяснение Пример
{!Company Name} Название вашей компании (с пробелами) Contoso Inc
{!Tool Name} Название инструмента (с пробелами) Manage Foo Works

Ниже приведен пример использования:

wac create --company "Contoso Inc" --tool "Manage Foo Works" --version latest

При этом создается новая папка в текущем рабочем каталоге с помощью имени, указанного для средства, копирует все необходимые файлы шаблонов в проект и настраивает файлы с именем вашей компании и средства.

Замечание

Флаг --version в этой команде указывает, какая версия пакета SDK Для Windows Admin Center требуется использовать. Узнайте, как нацелиться на другую версию Windows Admin Center SDK, чтобы поддерживать расширение в актуальном состоянии с учётом последних изменений пакета SDK и платформы.

Затем измените каталог в только что созданную папку, а затем установите необходимые локальные зависимости, выполнив следующую команду:

npm install

После завершения настроек, у вас будет все необходимое для загрузки нового расширения в Windows Admin Center.

Добавление содержимого в расширение

Теперь, когда вы создали расширение с помощью пакета SDK Для Windows Admin Center, вы можете настроить содержимое. Примеры того, что можно сделать, см. в следующих руководствах.

Еще больше примеров можно найти в нашем руководстве разработчика. Руководство разработчика — это полностью функциональное расширение решения, которое может быть загружено на стороне в Windows Admin Center и содержит широкий набор примеров функций и примеров инструментов, которые можно просматривать и использовать в собственном расширении.

Включите расширение руководства разработчика на странице "Дополнительно " параметров Центра администрирования Windows.

Настройка значка расширения

Вы можете настроить значок, отображаемый для расширения в списке инструментов. Измените все icon записи в manifest.json для вашего расширения.

"icon": "{!icon-uri}",
Ценность Объяснение Пример URI
{!icon-uri} Расположение ресурса значка assets/foo-icon.svg

ПРИМЕЧАНИЕ. В настоящее время пользовательские значки не отображаются при загрузке расширения в режиме разработки. В качестве обходного решения удалите содержимое target следующим образом:

"target": "",

Эта конфигурация действительна только для загрузки на стороне в режиме разработки, поэтому важно сохранить значение, содержащееся в target , а затем восстановить его перед публикацией расширения.

Сборка и установка расширения вручную

Затем создайте и загрузите расширение в Windows Admin Center. Откройте командное окно, измените каталог на исходный каталог, а затем готовы к сборке.

  • Сборка и запуск с помощью gulp.

    gulp build
gulp serve --port 4201

Обратите внимание, что необходимо выбрать порт, который в настоящее время является бесплатным. Убедитесь, что вы не пытаетесь использовать порт, на котором запущен Центр администрирования Windows.

Проект можно загрузить на локальный экземпляр Центра администрирования Windows для тестирования, подключив локально обслуживаемый проект в Центр администрирования Windows.

  • Запуск Центра администрирования Windows в веб-браузере

  • Открытие отладчика (F12)

  • Откройте консоль и введите следующую команду:

    MsftSme.sideLoad("http://localhost:4201")

  • Обновление веб-браузера

Теперь ваш проект будет отображаться в списке инструментов с пометкой (загружен извне) рядом с названием.