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

Решения в основном определяют уникальный тип объекта, который вы хотите управлять с помощью Windows Admin Center. Эти решения и типы подключений включены в Windows Admin Center по умолчанию:

  • Подключения Windows Server
  • Подключения Windows-компьютеров
  • Подключения отказоустойчивого кластера
  • Подключения гиперконвергентного кластера

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

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

Note

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

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

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

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

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

wac create --company "{!Company Name}" --solution "{!Solution Name}" --tool "{!Tool Name}" --version latest
Value Explanation Example
{!Company Name} Название вашей компании (с пробелами) Contoso Inc
{!Solution Name} Имя решения (с пробелами) Contoso Foo Works Suite
{!Tool Name} Название инструмента (с пробелами) Manage Foo Works

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

wac create --company "Contoso Inc" --solution "Contoso Foo Works Suite" --tool "Manage Foo Works"

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

Note

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

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

npm install

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

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

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

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

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

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

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

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

    gulp build
    gulp serve --port 4201
    

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

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

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

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

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

    MsftSme.sideLoad("http://localhost:4201")
    
  • Обновление веб-браузера

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