Sviluppare un'estensione dello strumento

Si applica a: Windows Admin Center, Windows Admin Center Preview

Un'estensione dello strumento è il modo principale in cui gli utenti interagiscono con Windows admin center per gestire una connessione, ad esempio un server o un cluster. Quando si fa clic su una connessione nella schermata iniziale dell'interfaccia di amministrazione di Windows e ci si connette, viene visualizzato un elenco di strumenti nel riquadro di spostamento a sinistra. Quando si fa clic su uno strumento, l'estensione dello strumento viene caricata e visualizzata nel riquadro di destra.

Quando viene caricata, un'estensione dello strumento può eseguire chiamate WMI o script di PowerShell in un server o cluster di destinazione e visualizzare informazioni nell'interfaccia utente o eseguire comandi in base all'input dell'utente. Le estensioni degli strumenti definiscono le soluzioni per cui devono essere visualizzate, determinando un set diverso di strumenti per ogni soluzione.

Nota

Non si ha familiarità con i diversi tipi di estensione? Altre informazioni sull'architettura di estendibilità e sui tipi di estensione.

Preparare l'ambiente

Se non è già stato fatto, preparare l'ambiente installando le dipendenze e i prerequisiti globali necessari per tutti i progetti.

Creare una nuova estensione dello strumento con Windows Admin Center SDK

Dopo aver installato tutte le dipendenze, è possibile creare la nuova estensione dello strumento. Creare o passare a una cartella che contiene i file di progetto, aprire un prompt dei comandi e impostare tale cartella come directory di lavoro. Usando l Windows Admin Center SDK installato in precedenza, creare una nuova estensione con la sintassi seguente:

wac create --company "{!Company Name}" --tool "{!Tool Name}"
valore Spiegazione Esempio
{!Company Name} Nome della società (con spazi) Contoso Inc
{!Tool Name} Nome dello strumento (con spazi) Manage Foo Works

Ecco un esempio di utilizzo:

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

Verrà creata una nuova cartella all'interno della directory di lavoro corrente usando il nome specificato per lo strumento, copia tutti i file modello necessari nel progetto e configura i file con il nome della società e dello strumento.

Passare quindi alla cartella appena creata, quindi installare le dipendenze locali necessarie eseguendo il comando seguente:

npm install

Al termine, hai configurato tutti gli elementi necessari per caricare la nuova estensione nell'Windows admin center.

Aggiungere contenuto all'estensione

Ora che è stata creata un'estensione con Windows Admin Center SDK, è possibile personalizzare il contenuto. Per esempi di operazioni che è possibile eseguire, vedere queste guide:

Altri esempi sono disponibili nella Guida per gli sviluppatori. La Guida per gli sviluppatori è un'estensione di soluzione completamente funzionante che può essere caricata in locale nell'interfaccia di amministrazione di Windows e contiene una raccolta completa di esempi di funzionalità ed strumenti di esempio che è possibile esplorare e usare nella propria estensione.

Abilitare l'estensione Guida per gli sviluppatori nella pagina Avanzate delle impostazioni dell Windows admin center.

Personalizzare l'icona dell'estensione

È possibile personalizzare l'icona visualizzata per l'estensione nell'elenco degli strumenti. A tale scopo, modificare tutte le icon voci in manifest.json per l'estensione:

"icon": "{!icon-uri}",
valore Spiegazione URI di esempio
{!icon-uri} Percorso della risorsa icona assets/foo-icon.svg

NOTA: attualmente le icone personalizzate non sono visibili quando si esegue il side loading dell'estensione in modalità sviluppo. Come soluzione alternativa, rimuovere il contenuto di come target indicato di seguito:

"target": "",

Questa configurazione è valida solo per il side loading in modalità dev, quindi è importante mantenere il valore contenuto in target e quindi ripristinarlo prima di pubblicare l'estensione.

Compilare e caricare in side load l'estensione

Successivamente, compilare e caricare l'estensione in Windows admin center. Aprire una finestra di comando, passare alla directory di origine e quindi si è pronti per la compilazione.

  • Compilare e gestire con gulp:

    gulp build
    gulp serve --port 4201
    

Si noti che è necessario scegliere una porta attualmente gratuita. Assicurarsi di non provare a usare la porta su cui è Windows'interfaccia di amministrazione.

Il progetto può essere caricato localmente in un'istanza locale dell'interfaccia di amministrazione di Windows per il test collegando il progetto servito localmente Windows'interfaccia di amministrazione.

  • Avviare Windows'interfaccia di amministrazione in un Web browser

  • Aprire il debugger (F12)

  • Aprire la console e digitare il comando seguente:

    MsftSme.sideLoad("http://localhost:4201")
    
  • Aggiornare il Web browser

Il progetto sarà ora visibile nell'elenco Strumenti con (sideloaded) accanto al nome.

Selezionare come destinazione una versione diversa di Windows Admin Center SDK

Mantenere l'estensione aggiornata con le modifiche dell'SDK e le modifiche della piattaforma è facile. Informazioni su come impostare come destinazione una versione diversa di Windows Admin Center SDK.