Opracowywanie rozszerzenia narzędzia

Rozszerzenie narzędzia jest podstawowym sposobem interakcji użytkowników z centrum administracyjnym systemu Windows w celu zarządzania połączeniem, takim jak serwer lub klaster. Gdy klikniesz połączenie na ekranie głównym programu Windows Admin Center i się połączysz, zostanie wyświetlona lista narzędzi w okienku nawigacji po lewej stronie. Po kliknięciu narzędzia rozszerzenie narzędzia zostanie załadowane i wyświetlone w okienku po prawej stronie.

Po załadowaniu rozszerzenia narzędzia może wykonywać wywołania usługi WMI lub skrypty programu PowerShell na serwerze docelowym lub klastrze i wyświetlać informacje w interfejsie użytkownika lub wykonywać polecenia na podstawie danych wejściowych użytkownika. Rozszerzenia narzędzi definiują, dla których rozwiązań powinny być wyświetlane, co powoduje utworzenie innego zestawu narzędzi dla każdego rozwiązania.

Note

Nie znasz różnych typów rozszerzeń? Dowiedz się więcej o architekturze rozszerzalności i typach rozszerzeń.

Przygotowywanie środowiska

Jeśli jeszcze tego nie zrobiłeś, przygotuj swoje środowisko, instalując zależności i globalne wymagania potrzebne dla wszystkich projektów.

Tworzenie nowego rozszerzenia narzędzia za pomocą zestawu WINDOWS Admin Center SDK

Po zainstalowaniu wszystkich zależności możesz przystąpić do tworzenia nowego rozszerzenia narzędzia. Utwórz lub przejdź do folderu, który zawiera pliki projektu, otwórz wiersz poleceń i ustaw ten folder jako katalog roboczy. Korzystając z pakietu SDK dla Windows Admin Center, który został wcześniej zainstalowany, utwórz nowe rozszerzenie przy użyciu następującej składni:

wac create --company "{!Company Name}" --tool "{!Tool Name}" --version latest

Value	Explanation	Example
{!Company Name}	Nazwa twojej firmy (z odstępami)	Contoso Inc
{!Tool Name}	Nazwa narzędzia (ze spacjami)	Manage Foo Works

Oto przykładowe użycie:

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

Korzystając z Windows Admin Center SDK w wersjach 6.0.0 i wyższych, możesz także tworzyć rozszerzenia narzędzi oparte na React. Stwórz nowe rozszerzenie narzędzia oparte na React, używając następującej składni:

wac create-react --company "{!Company Name}" --tool "{!Tool Name}" --version latest

Value	Explanation	Example
{!Company Name}	Nazwa twojej firmy (z odstępami)	Contoso Inc
{!Tool Name}	Nazwa narzędzia (ze spacjami)	Manage Foo Works

Oto przykład:

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

Spowoduje to utworzenie nowego folderu w bieżącym katalogu roboczym przy użyciu nazwy określonej dla narzędzia, skopiowania wszystkich niezbędnych plików szablonów do projektu i skonfigurowania plików z nazwą firmy i narzędzia.

Note

Flaga --version w tym poleceniu określa, którą wersję zestawu SDK Windows Admin Center chcesz użyć. Przeczytaj o tym, jak docelowo wskazać inną wersję Windows Admin Center SDK, aby utrzymać swoją rozszerzenie na bieżąco z najnowszymi zmianami w SDK i platformie.

Następnie przejdź do katalogu, który właśnie został utworzony, a następnie zainstaluj wymagane lokalne zależności, uruchamiając następującą komendę:

npm install

Gdy to się zakończy, skonfigurowałeś wszystko, co potrzebne do załadowania nowego rozszerzenia w Windows Admin Center.

Dodaj treść do swojej rozszerzenia

Teraz, gdy utworzyłeś rozszerzenie za pomocą zestawu SDK Windows Admin Center, jesteś gotowy dostosować zawartość. Zobacz te przewodniki, aby uzyskać przykłady tego, co możesz zrobić:

• Dodawanie pustego modułu
• Dodawanie elementu iFrame

Jeszcze więcej przykładów można znaleźć w naszym Przewodniku dla deweloperów. Przewodnik dla deweloperów to w pełni funkcjonalne rozszerzenie rozwiązań, które można załadować do Windows Admin Center i zawiera bogaty zbiór przykładów funkcjonalności oraz narzędzi, które można przeglądać i używać we własnym rozszerzeniu.

Włącz rozszerzenie Przewodnik dla deweloperów na stronie Zaawansowane ustawień centrum administracyjnego systemu Windows.

Dostosowywanie ikony rozszerzenia

Możesz dostosować ikonę wyświetlaną dla rozszerzenia na liście narzędzi. W tym celu zmodyfikuj wszystkie icon wpisy w manifest.json dla swojego rozszerzenia.

"icon": "{!icon-uri}",

Value	Explanation	Przykładowy identyfikator URI
{!icon-uri}	Lokalizacja zasobu ikony	assets/foo-icon.svg

UWAGA: Obecnie ikony niestandardowe nie są widoczne podczas ręcznej instalacji rozszerzenia w trybie dewelopera. Aby obejść ten problem, usuń zawartość target w następujący sposób.

"target": "",

Ta konfiguracja jest prawidłowa tylko w przypadku ładowania bezpośredniego w trybie deweloperskim, dlatego ważne jest, aby zachować wartość zawartą w target pliku, a następnie przywrócić ją przed opublikowaniem rozszerzenia.

Budowanie i ładowanie rozszerzenia zewnętrznego

Następnie zbuduj i załadowaj swoje rozszerzenie do Windows Admin Center. Otwórz okno poleceń i zmień katalog na swój katalog źródłowy.

• Aby zbudować i obsłużyć rozszerzenie, wykonaj następujące polecenie:

  npm run build
  npm start
  

Utrzymuj ten terminal w ruchu.

Domyślnie rozszerzenie jest ładowane bocznie na porcie 4200. Aby zmienić port, zmodyfikuj pliki package.json i appsettings.json swojego rozszerzenia. Upewnij się, że nie używasz portu, na którym działa Windows Admin Center.

Aby zainstalować projekt na lokalnej instancji Windows Admin Center do testów, dołącz lokalnie obsługiwany projekt.

• Uruchom Centrum Administracyjnego Windows w przeglądarce internetowej

• Otwórz debuger (F12)

• Otwórz konsolę i wpisz następujące polecenie, aby przeprowadzić sideloading przy użyciu localhost:

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

  Jeśli postępowałeś zgodnie z instrukcjami sideloadu za pomocą FQDN, otwórz konsolę i wpisz następujące polecenie:

  MsftSme.sideLoad("http://<FQDN>:4200")
  

• Odśwież przeglądarkę internetową.

Twój projekt pojawia się teraz na liście narzędzi z (sideloaded) obok nazwy.