Modificare il comportamento di spostamento principale per un'estensione della soluzione

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

Questo articolo fornisce indicazioni su come modificare il comportamento di spostamento principale per la soluzione in modo da avere un comportamento diverso dell'elenco di connessioni. Si apprenderà anche come nascondere o mostrare l'elenco degli strumenti.

Modifica del comportamento di spostamento principale

Aprire il file manifest.json in {extension root}\src e trovare la proprietà "rootNavigationBehavior". Questa proprietà ha due valori validi: "connections" o "path". Il comportamento di "connections" viene descritto più avanti nella documentazione.

Impostazione del percorso come rootNavigationBehavior

Impostare il valore di rootNavigationBehavior su path e quindi eliminare la proprietà requirements e lasciare la proprietà path come stringa vuota. La configurazione minima necessaria per compilare un'estensione della soluzione è stata completata. Salvare il file, eseguire gulp build -> gulp serve come si farebbe con uno strumento e quindi trasferire localmente l'estensione nell'estensione locale di Windows Admin Center.

Una matrice valida di entryPoints del manifesto è simile alla seguente:

    "entryPoints": [
        {
          "entryPointType": "solution",
          "name": "main",
          "urlName": "testsln",
          "displayName": "resources:strings:displayName",
          "description": "resources:strings:description",
          "icon": "sme-icon:icon-win-powerShell",
          "path": "",
          "rootNavigationBehavior": "path"
        }
    ],

Gli strumenti compilati con questo tipo di struttura non richiedono connessioni da caricare, ma non dispongono nemmeno della funzionalità di connettività dei nodi.

Impostazione delle connessioni come rootNavigationBehavior

Quando si imposta la proprietà rootNavigationBehavior su connections, si indica alla shell di Windows Admin Center che è presente un nodo connesso (sempre un server di un tipo) a cui deve connettersi per verificare lo stato della connessione. Per verificare una connessione sono necessari due passaggi.

1. Windows Admin Center tenta di accedere al nodo con le proprie credenziali (per stabilire la sessione remota di PowerShell).
2. Windows Admin Center esegue lo script di PowerShell fornito per verificare se il nodo si trova in uno stato collegabile.

Una definizione di soluzione valida con connections è simile alla seguente:

        {
          "entryPointType": "solution",
          "name": "example",
          "urlName": "solutionexample",
          "displayName": "resources:strings:displayName",
          "description": "resources:strings:description",
          "icon": "sme-icon:icon-win-powerShell",
          "rootNavigationBehavior": "connections",
          "connections": {
            "header": "resources:strings:connectionsListHeader",
            "connectionTypes": [
                "msft.sme.connection-type.example"
                ]
            },
            "tools": {
                "enabled": false,
                "defaultTool": "solution"
            }
        },

Quando rootNavigationBehavior è impostato su "connections", è necessario compilare la definizione delle connessioni nel manifesto. Include la proprietà "header" (visualizzata nell'intestazione della soluzione quando un utente la seleziona dal menu) e una matrice connectionTypes (specifica quali connectionTypes vengono usati nella soluzione). Per altre informazioni, vedere la documentazione di connectionProvider.

Abilitazione e disabilitazione del menu strumenti

Un'altra proprietà disponibile nella definizione della soluzione è la proprietà Tools. La proprietà Tools determina se viene visualizzato il menu Strumenti e quale strumento verrà caricato. Se abilitata, Windows Admin Center esegue il rendering del menu Strumenti a sinistra. Con defaultTool, è necessario aggiungere un punto di ingresso dello strumento al manifesto per caricare le risorse appropriate. Il valore di "defaultTool" deve essere la proprietà "name" dello strumento come definito nel manifesto.