Sviluppare un'estensione dello strumento

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

L'estensione di uno strumento è il modo principale con 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 di Windows Admin Center e si effettua la connessione, viene presentato 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 destro.

Quando viene caricata, l'estensione di uno 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 stabiliscono per quali soluzioni devono essere visualizzate, in modo da ottenere un set di strumenti diverso 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.

Predisporre 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 della soluzione. Creare o individuare una cartella che contenga i file di progetto, aprire un prompt dei comandi e impostare tale cartella come directory di lavoro. Usando Windows Admin Center SDK installato in precedenza, creare una nuova estensione con la sintassi seguente:

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

Valore	Spiegazione	Esempio
{!Company Name}	Nome aziendale (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" --version latest

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

Nota

Il flag --version in questo comando specifica la versione di Windows Admin Center SDK da usare. Vedere come puntare a una versione diversa di Windows Admin Center SDK per mantenere aggiornata l'estensione con le ultime modifiche dell'SDK e della piattaforma.

Modificare quindi la directory nella cartella appena creata e installare le dipendenze locali necessarie eseguendo il comando seguente:

npm install

Una volta completata questa operazione, si sarà configurato tutto il necessario per caricare la nuova estensione in Windows Admin Center.

Aggiungere contenuti all'estensione

Dopo aver creato un'estensione con Windows Admin Center SDK, è possibile personalizzare il contenuto. Vedere le guide seguenti per esempi di operazioni che è possibile eseguire:

• Aggiungere un modulo vuoto
• Aggiungere un iFrame

Altri esempi sono disponibili nella Guida per gli sviluppatori. La Guida per gli sviluppatori è un'estensione della soluzione completamente funzionante che può essere trasferita localmente in Windows Admin Center e contiene una raccolta completa di esempi di funzionalità e strumenti che è possibile esplorare e usare nella propria estensione.

Abilitare l'estensione Guida per gli sviluppatori nella pagina Avanzate delle impostazioni di 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 voci icon in manifest.json per l'estensione:

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

Valore	Spiegazione	Esempio di uri
{!icon-uri}	La posizione della risorsa icona	assets/foo-icon.svg

NOTA: attualmente, le icone personalizzate non sono visibili durante il trasferimento locale dell'estensione in modalità sviluppatore. Come soluzione alternativa, rimuovere il contenuto di targetcome indicato di seguito:

"target": "",

Questa configurazione è valida solo per il trasferimento locale in modalità sviluppatore, quindi è importante conservare il valore contenuto in target e quindi ripristinarlo prima di pubblicare l'estensione.

Compilare e trasferire localmente l'estensione

Successivamente, compilare e trasferire localmente l'estensione in Windows Admin Center. Aprire una finestra di comando, passare alla directory di origine e si sarà pronti per la compilazione.

• Compilare e gestire con gulp:

  gulp build
  gulp serve --port 4201
  

Si noti che è necessario scegliere una porta attualmente libera. Assicurarsi di non tentare di usare la porta in cui è in esecuzione Windows Admin Center.

Il progetto può essere trasferito localmente in un'istanza locale di Windows Admin Center per il test, collegando il progetto gestito localmente in Windows Admin Center.

• Avviare Windows Admin Center in un Web browser

• Aprire il debugger (F12)

• Aprire la console e immettere il comando seguente:

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

• Aggiornare il Web browser

Il progetto sarà ora visibile nell'elenco Strumenti con la dicitura "trasferito localmente" accanto al nome.