Sviluppare un'estensione della soluzione

  • Articolo

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

Le soluzioni definiscono principalmente un tipo univoco di oggetto da gestire tramite Windows Admin Center. Per impostazione predefinita, in Windows Admin Center sono incluse queste soluzioni/tipi di connessione:

  • Connessioni a Windows Server
  • Connessioni a PC Windows
  • Connessioni al cluster di failover
  • Connessioni a cluster iperconvergenti

Quando si seleziona una connessione dalla pagina delle connessioni di Windows Admin Center, viene caricata l'estensione della soluzione per tale tipo di connessione e Windows Admin Center tenterà di connettersi al nodo di destinazione. Se la connessione ha esito positivo, verrà caricata l'interfaccia utente dell'estensione della soluzione e Windows Admin Center visualizzerà gli strumenti per tale soluzione nel riquadro di spostamento a sinistra.

Se si vuole creare un'interfaccia utente grafica di gestione per i servizi non definiti dai tipi di connessione predefiniti precedenti, ad esempio un commutatore di rete o altro hardware non individuabile in base al nome del computer, è possibile creare una propria estensione della 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 della soluzione 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}" --solution "{!Solution Name}" --tool "{!Tool Name}" --version latest
Valore Spiegazione Esempio
{!Company Name} Nome della società (con spazi) Contoso Inc
{!Solution Name} Nome della soluzione (con spazi) Contoso Foo Works Suite
{!Tool Name} Nome dello strumento (con spazi) Manage Foo Works

Di seguito è riportato un esempio di utilizzo:

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

Verrà creata una nuova cartella all'interno della directory di lavoro corrente usando il nome specificato per la soluzione, verranno copiati tutti i file modello necessari nel progetto e verranno configurati i file con il nome della società, della soluzione 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:

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.

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.