Een hulpprogramma-extensie ontwikkelen

  • Van toepassing op: ✅ Windows Admin Center, ✅ Windows Admin Center Preview

Een hulpprogramma-extensie is de primaire manier waarop gebruikers communiceren met Windows Admin Center om een verbinding, zoals een server of cluster, te beheren. Wanneer u op een verbinding klikt in het startscherm van het Windows-beheercentrum en verbinding maakt, krijgt u een lijst met hulpprogramma's te zien in het linkernavigatievenster. Wanneer u op een tool klikt, wordt de toolextensie geladen en weergegeven in het rechterdeelvenster.

Wanneer een hulpprogramma-extensie wordt geladen, kan deze WMI-aanroepen of PowerShell-scripts uitvoeren op een doelserver of cluster en informatie weergeven in de gebruikersinterface of opdrachten uitvoeren op basis van gebruikersinvoer. Toolextensies definiëren voor welke oplossingen het moet worden weergegeven, wat resulteert in een andere set tools voor elke oplossing.

Note

Kent u de verschillende extensietypen niet? Meer informatie over de uitbreidbaarheidsarchitectuur en extensietypen.

Uw omgeving voorbereiden

Als u dat nog niet hebt gedaan, bereid uw omgeving voor door afhankelijkheden en algemene vereisten te installeren die vereist zijn voor alle projecten.

Een nieuwe hulpprogramma-extensie maken met de Windows Admin Center SDK

Zodra u alle afhankelijkheden hebt geïnstalleerd, bent u klaar om uw nieuwe toolextensie te maken. Maak of blader naar een map die uw projectbestanden bevat, open een opdrachtprompt en stel die map in als de werkmap. Maak met behulp van de Windows Admin Center SDK die eerder is geïnstalleerd een nieuwe extensie met de volgende syntaxis:

wac create --company "{!Company Name}" --tool "{!Tool Name}" --version latest
Value Explanation Example
{!Company Name} De bedrijfsnaam (met spaties) Contoso Inc
{!Tool Name} De naam van het hulpprogramma (met spaties) Manage Foo Works

Hier volgt een voorbeeld van het gebruik:

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

Door gebruik te maken van Windows Admin Center SDK versies 6.0.0 en hoger, kun je ook React-gebaseerde toolextensies maken. Maak een nieuwe React-gebaseerde toolextensie aan met de volgende syntaxis:

wac create-react --company "{!Company Name}" --tool "{!Tool Name}" --version latest
Value Explanation Example
{!Company Name} De bedrijfsnaam (met spaties) Contoso Inc
{!Tool Name} De naam van het hulpprogramma (met spaties) Manage Foo Works

Hier is een voorbeeld:

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

Hiermee wordt een nieuwe map gemaakt in de huidige werkmap met de naam die u voor uw tool hebt opgegeven, worden alle benodigde sjabloonbestanden naar uw project gekopieerd en worden de bestanden geconfigureerd met de naam van uw bedrijf en tool.

Note

De vlag --version in deze opdracht geeft aan welke versie van de Windows Admin Center SDK u wilt targeten. Lees hoe u zich richt op een andere versie van de Windows Admin Center SDK om uw extensie up-to-date te houden met de nieuwste SDK- en platformwijzigingen.

Navigeer naar de map die u zojuist hebt gemaakt en installeer de vereiste lokale afhankelijkheden door de volgende opdracht uit te voeren:

npm install

Zodra dit is voltooid, hebt u alles ingesteld wat u nodig hebt om uw nieuwe extensie in het Windows-beheercentrum te laden.

Inhoud toevoegen aan uw extensie

Nu u een extensie hebt gemaakt met de Windows Admin Center SDK, kunt u inhoud aanpassen. Zie deze handleidingen voor voorbeelden van wat u kunt doen:

Nog meer voorbeelden vindt u in onze ontwikkelaarshandleiding. De ontwikkelaarshandleiding is een volledig functionerende oplossingsextensie die naast elkaar kan worden geladen in het Windows-beheercentrum en bevat een uitgebreide verzameling voorbeeldfunctionaliteit en hulpprogrammavoorbeelden die u in uw eigen extensie kunt bekijken en gebruiken.

Schakel de extensie Ontwikkelaarshandleiding in op de pagina Geavanceerd van de instellingen van het Windows-beheercentrum.

Het pictogram van uw extensie aanpassen

U kunt het pictogram aanpassen dat voor uw extensie in de gereedschapslijst wordt weergegeven. Om dit te doen, wijzigt u alle icon-vermeldingen in manifest.json voor uw extensie:

"icon": "{!icon-uri}",
Value Explanation Voorbeeld-URI
{!icon-uri} De locatie van uw pictogrambron assets/foo-icon.svg

OPMERKING: Op dit moment zijn aangepaste pictogrammen niet zichtbaar bij het zijwaarts laden van uw extensie in de dev-modus. Verwijder als tijdelijke oplossing de inhoud van target als volgt:

"target": "",

Deze configuratie is alleen geldig voor sideloading in ontwikkelmodus, dus het is belangrijk om de waarde in target te behouden en deze vervolgens te herstellen voordat u uw extensie publiceert.

Uw extensie bouwen en sideloaden

Bouw vervolgens uw extensie en laad deze via sideloading in Windows Admin Center. Open een commandovenster en verander de map naar je bronmap.

  • Om de uitbreiding te bouwen en te bedienen, voer je het volgende commando uit:

    npm run build
npm start

Houd deze terminal draaiende.

Standaard sideloadt de extensie op poort 4200. Om de port te wijzigen, pas je extensies package.json en appsettings.json bestanden aan. Zorg ervoor dat je de poort waarop Windows Admin Center draait niet gebruikt.

Om je project te sideloaden in een lokale instantie van Windows Admin Center voor testen, koppel je het lokaal bediende project.

  • Windows Admin Center starten in een webbrowser

  • Open het foutopsporingsprogramma (F12)

  • Open de console en typ het volgende commando voor sideloading met localhost:

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

    Als je de instructies om te sideloaden hebt gevolgd met een FQDN, open dan de console en typ het volgende commando:

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

  • Vernieuw de webbrowser.

Je project verschijnt nu in de Tools-lijst met (side loaded) naast de naam.

  • Last updated on