Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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
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:
- Een lege module toevoegen
- Een iFrame toevoegen
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 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 side-loading in dev-modus, dus het is belangrijk om de waarde in target de dev-modus te behouden en deze vervolgens te herstellen voordat u uw extensie publiceert.
Uw extensie bouwen en sideloaden
Vervolgens kunt u uw extensie in het Windows-beheercentrum bouwen en sideloaden. Open een opdrachtvenster, wijzig de map in uw bronmap en vervolgens bent u klaar om te bouwen.
Met gulp bouwen en serveren.
gulp build gulp serve --port 4201
Houd er rekening mee dat u een poort moet kiezen die momenteel gratis is. Zorg ervoor dat u niet probeert de poort te gebruiken waarop Windows Admin Center wordt uitgevoerd.
Uw project kan worden geladen in een lokaal exemplaar van het Windows-beheercentrum om te testen door het lokaal uitgevoerde project te koppelen aan het Windows-beheercentrum.
Windows Admin Center starten in een webbrowser
Open het foutopsporingsprogramma (F12)
Open de console en typ de volgende opdracht:
MsftSme.sideLoad("http://localhost:4201")De webbrowser vernieuwen
Uw project is nu zichtbaar in de tools lijst met (zijgeladen) naast de naam.