Разработка расширения инструмента
Расширение средства — это основной способ взаимодействия пользователей с 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 требуется использовать. Узнайте, как использовать другую версию пакета SDK Для Windows Admin Center, чтобы обновить расширение с помощью последних изменений пакета SDK и платформы.
Затем измените каталог в только что созданную папку, а затем установите необходимые локальные зависимости, выполнив следующую команду:
npm install
После завершения работы вы настроили все, что необходимо загрузить новое расширение в Windows Admin Center.
Добавление содержимого в расширение
Теперь, когда вы создали расширение с помощью пакета SDK Для Windows Admin Center, вы можете настроить содержимое. Примеры того, что можно сделать, см. в следующих руководствах.
- Добавление пустого модуля
- Добавление iFrame
Еще больше примеров можно найти в нашем руководстве разработчика. Руководство разработчика — это полностью функциональное расширение решения, которое может быть загружено на стороне в Windows Admin Center и содержит широкий набор примеров функций и примеров инструментов, которые можно просматривать и использовать в собственном расширении.
Включите расширение руководства разработчика на странице "Дополнительно " параметров Центра администрирования Windows.
Настройка значка расширения
Вы можете настроить значок, отображаемый для расширения в списке инструментов. Для этого измените manifest.json все icon записи для расширения:
"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")Обновление веб-браузера
Теперь проект будет отображаться в списке инструментов с (загруженной на стороне) рядом с именем.