Importare o esportare configurazioni di installazione

È possibile usare i file di configurazione dell'installazione per configurare le installazioni di Visual Studio. A tale scopo, esportare i carichi di lavoro, i componenti e le informazioni sull'estensione del Marketplace in un file .vsconfig usando il programma di installazione di Visual Studio. Dopo aver creato un file vsconfig, è possibile perfezionarlo manualmente e aggiungere o rimuovere altri elementi. La struttura e la sintassi del file vsconfig è descritta nella sezione formato di file vsconfig.

È anche possibile importare il file di configurazione in un'installazione di Visual Studio nuova o esistente, usarlo per creare o modificare un layout o un'installazione offline, inserirlo in una directory della soluzione o in un repository e attivare un'installazione di componenti mancanti e condividerlo con altri utenti.

Esportare una configurazione usando il programma di installazione di Visual Studio

È possibile esportare un file di configurazione dell'installazione da un'istanza installata in precedenza di Visual Studio.

Nota

A partire da Visual Studio 2022 versione 17.10 Preview, è possibile esportare estensioni di Visual Studio Marketplace caricate in un contesto a livello di istanza in un file .vsconfig. Se si vuole che la funzionalità di export sia in grado di esportare altri tipi di estensioni, ad esempio quelle caricate da una condivisione di rete o quelle caricate nel contesto utente, segnalare.

Usare l'interfaccia utente del programma di installazione di Visual Studio

1. Dal menu Start aprire il programma di installazione di Visual Studio.

2. Nella scheda prodotto, scegli il pulsante Altro, quindi seleziona Esporta configurazione.

   

3. Accedi o digita il percorso in cui si vuole salvare il file .vsconfig e quindi scegliere Verifica i dettagli.

   

4. Verificare che le selezioni siano accurate e quindi scegliere Esporta.

   

Esportare un file di configurazione programmaticamente.

È possibile esportare a livello di codice un file di configurazione di una determinata istanza di Visual Studio usando il verbo export. Per altre informazioni, vedere Usare i parametri della riga di comando per installare, aggiornare e gestire Visual Studio.

Importare una configurazione usando il programma di installazione di Visual Studio

È possibile importare un file di configurazione dell'installazione in un'istanza di Visual Studio installata in precedenza oppure usarlo per inizializzare una nuova installazione di Visual Studio. L'importazione di un file di configurazione in Visual Studio installa qualsiasi elemento elencato nel file di configurazione non già installato.

Usare l'interfaccia utente del programma di installazione di Visual Studio

Quando si è pronti per importare un file di configurazione dell'installazione, seguire questa procedura.

1. Aprire il programma di installazione di Visual Studio e chiudere Visual Studio. La maggior parte delle operazioni del programma di installazione richiede che il prodotto Visual Studio stesso sia chiuso.

2. Nella scheda Installato o nella scheda Disponibile, seleziona Altro>Importa configurazione nella scheda del prodotto Visual Studio.

3. Individuare il file vsconfig che si desidera importare, e quindi selezionare Rivedi i dettagli.

4. Verifica che le selezioni siano accurate e quindi scegli Modifica.

Usare un file di configurazione a livello di codice per aggiungere componenti a un'installazione esistente

È possibile usare il parametro --config per inizializzare o modificare un'installazione esistente e aggiungere componenti. Nell'esempio seguente viene usato il programma di installazione nel computer client per modify un'installazione esistente.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\Program Files\Microsoft Visual Studio\2022\Professional" --config "C:\myconfig.vsconfig" --passive --allowUnsignedExtensions

Nota

Per aggiungere componenti a un'installazione esistente usando un file .vsconfig, è necessario usare modify e nonupdate. Il comando update aggiorna solo i componenti installati esistenti alla versione più recente. Per ulteriori informazioni sulle diverse operazioni del programma di installazione, consultare la documentazione di Installare Visual Studio dalla riga di comando.

Usare un file di configurazione per inizializzare il contenuto di un layout

Usando il programma di avvio automatico corretto che corrisponde alla versione e all'edizione di Visual Studio desiderata, aprire un prompt dei comandi dell'amministratore ed eseguire il comando seguente per usare il parametro --config per configurare il contenuto di un layout. Per ulteriori informazioni sull'uso di file .vsconfig per inizializzare e installare dai layout, vedere Usare un file di configurazione per inizializzare i contenuti di un layout.

vs_enterprise.exe --layout "c:\localVSlayout" --config "c:\myconfig.vsconfig" --lang en-US

Usare un file di configurazione per installare automaticamente i componenti mancanti

Se si salva un file vsconfig nella directory radice della soluzione e quindi si apre una soluzione, Visual Studio rileva automaticamente eventuali componenti mancanti e richiede di installarli.

Nota

Se il file di .vsconfig contiene estensioni, attualmente solo le estensioni ospitate nel Visual Studio Marketplace attivare il rilevamento e l'installazione del automatico non sono presenti rilevamento e installazione. Se desideri che questa logica includa le estensioni installate da una fonte esterna al Marketplace, fornire informazioni dettagliate sullo scenario qui.

È possibile generare anche direttamente un file .vsconfig da Solution Explorer.

1. Fare clic con il pulsante destro del mouse sul file della soluzione.

2. Scegliere Aggiungi file di configurazione dell'installazione>.

3. Confermare il percorso in cui salvare il file .vsconfig e quindi scegliere Rivedi i dettagli.

4. Assicurarsi di avere i carichi di lavoro e i componenti desiderati e quindi scegliere Esporta.

È stata anche creata un'utilità open source che individua la configurazione dell'installazione di Visual Studio file con estensione vsconfig in modo ricorsivo e li unisce tutti insieme. Per altre informazioni su questa utilità, vedere VSConfigFinder in GitHub.

Formato di file vsconfig

Il file .vsconfig è un formato di file JSON che contiene una sezione components e facoltativamente una sezione extensions. La sezione dei componenti contiene carichi di lavoro e componenti e ha un aspetto simile al seguente:

{
  "version": "1.0", 
  "components": [ 
    "Microsoft.VisualStudio.Component.CoreEditor", 
    "Microsoft.VisualStudio.Workload.CoreEditor", 
    "Microsoft.VisualStudio.Component.NuGet" 
    ] 
}

Estensioni

A partire da Visual Studio 2022 versione 17.9, è possibile specificare le estensioni nel file .vsconfig e usare il programma di installazione di Visual Studio per caricarle a livello di computer rendendole disponibili per tutti gli utenti. A partire da Visual Studio 2022 versione 17.10 Preview, è possibile usare il programma di installazione di Visual Studio per export estensioni di Visual Studio Marketplace nel file vsconfig caricato in un contesto a livello di istanza, come descritto in precedenza.

Esistono alcune avvertenze note riguardo al supporto delle estensioni nel file di configurazione.

• Poiché le estensioni caricate tramite un file di configurazione vengono installate a livello di istanza, è necessario disporre delle autorizzazioni di amministratore o avere ottenuto il controllo del programma di installazione tramite il criterio AllowStandardUserControl per installarle. Tutte le estensioni installate in precedenza da Gestione estensioni di Visual Studio avevano la funzionalità di essere (e in genere) installate per utente, non a livello di istanza e l'utente non aveva bisogno delle autorizzazioni di amministratore per l'installazione.
• Il programma di installazione di Visual Studio supporta attualmente solo l'importazione di determinati tipi di estensioni, ad esempio quelle contenute in un pacchetto *.vsix o quelle che non sono eccessivamente complicate. Se avete un'estensione che non viene caricata correttamente tramite un file di configurazione, faccelo sapere tramite un nuovo suggerimento Developer Community.
• Solo le estensioni ospitate nel Visual Studio Marketplace attivano il rilevamento e l'installazione automatici mancanti se il file vsconfig si trova in una directory della soluzione. Se si desidera che questa logica includa le estensioni installate da un percorso non Marketplace, si prega di specificare i dettagli sullo scenario qui.
• Se si usa a livello di codice un file .vsconfig per aggiungere estensioni, è necessario usare anche il parametro --allowUnsignedExtensions per consentire il caricamento delle estensioni non firmate nel contesto --passive o --quiet. Se si esegue l'installazione da un layout, è possibile aggiungere la sintassi "allowUnsignedExtensions" : true al file response.json per ottenere un effetto simile.

Tutte le estensioni a livello di istanza vengono aggiornate automaticamente circa una volta al giorno tramite un'attività pianificata. Per altre informazioni, vedere Aggiornamenti automatici delle estensioni.

Il formato di file vsconfig che include estensioni dovrebbe essere simile al seguente.

{
  "version": "1.0", 
  "components": [ 
    // Whatever components you want to install come here, in quotes, separated by commas.
    // You can use the installer to select the components you want to install and then export them,
    // Or you can specify the ones you want according to the [component-id's](https://learn.microsoft.com/en-us/visualstudio/install/workload-and-component-ids).
    // This array should not be null! If you don't want to install any component, just leave the array empty.
  ],
  "extensions": [
    // The extensions you want to install are specified in this section, in quotes, separated by commas.
    // Extensions are optional in .vsconfig, so if you don't want any, you can delete the entire extensions section.
    // The extensions must be in a *.vsix package
    // Make sure that the extensions you specify are designed to work with that version of Visual Studio.
    // examples below
    "https://marketplace.visualstudio.com/items?itemName=MadsKristensen.ImageOptimizer64bit",   //unsigned extension
    "https://marketplace.visualstudio.com/items?itemName=vsext.RegexMatchVisualizer",  //signed extension
    "c:\\mylocaldrive\\someextension.vsix",
    "\\\\server\\share\\myextension.vsix",
    "https://myweb/anotherextension.vsix"
  ]
}

Supporto o risoluzione dei problemi

A volte, le cose possono andare storte. Se l'installazione di Visual Studio non riesce, vedere Risolvere i problemi di installazione e aggiornamento di Visual Studio per indicazioni dettagliate.

Ecco alcune altre opzioni di supporto:

• Usare l'opzione di chat (solo in inglese) di installazione di per i problemi correlati all'installazione.
• Segnala i problemi del prodotto utilizzando lo strumento Segnala un problema, che appare sia nel programma di installazione di Visual Studio che nell'IDE di Visual Studio. Se sei un amministratore IT e non hai Visual Studio installato, puoi inviare feedback per amministratori IT.
• Suggerire una funzionalità, tenere traccia dei problemi del prodotto e trovare le risposte nella Visual Studio Developer Community.

Contenuto correlato

• Configurare Visual Studio nell'organizzazione con .vsconfig
• Creare un'installazione di rete di Visual Studio
• Aggiornare un client di Visual Studio installato da un layout
• Controllare gli aggiornamenti alle distribuzioni di Visual Studio basate sulla rete
• Configurare i criteri per le distribuzioni aziendali