Configurare le impostazioni predefinite di installazione usando un file di risposta

Questo articolo illustra come creare un file di risposta che consente di automatizzare l'installazione di Visual Studio. L'uso più comune è quando si installa Visual Studio da un layout .

Il file di risposta di Visual Studio è un file JSON il cui contenuto contiene personalizzazioni usate durante l'installazione iniziale di Visual Studio nel client. Il relativo contenuto rispecchia gli argomenti e i parametri della riga di comando . Usare il file di risposta per le opzioni di configurazione seguenti:

• Configurare i carichi di lavoro, i componenti o le lingue da selezionare per impostazione predefinita durante l'installazione iniziale.
• Fare riferimento al file di configurazione di installazione *.vsconfig su cui il tuo team ha standardizzato.
• Specificare in cui il client deve ricevere gli aggiornamenti da. Gli esempi includono i server predefiniti ospitati da Microsoft su Internet oppure da un layout di rete controllato dall'amministratore.
• Rimozione automatica di componenti non supportati durante gli aggiornamenti.

Creazione del file di risposta

Il file response.json viene in genere creato quando un amministratore crea un layout e si trova nella cartella radice del layout. Tuttavia, è possibile creare un file di risposta personalizzato usando uno degli esempi seguenti.

Specificare il file di risposta

Se un amministratore distribuisce Visual Studio richiamando il programma di avvio automatico da un layout, il file di risposta trovato nella directory radice del layout viene usato automaticamente. Gli amministratori possono anche scegliere di specificare in modo esplicito un file di risposta diverso usando il parametro --in, come nell'esempio seguente:

\\server\share\layoutdirectory\vs_enterprise.exe --in custom_response_file.json

Contenuto del file di risposta

Il file di risposta incapsula i parametri della riga di comando usati dal programma di installazione di Visual Studio e segue queste regole generali:

• Se un parametro della riga di comando non accetta argomenti( ad esempio, --quiet, --passive, includeRecommended, removeOos, useLatestInstaller, allowUnsignedExtensionse così via), il valore nel file di risposta deve essere true/false.
• Se il parametro accetta un argomento (ad esempio, --installPath <dir>, --config <*.vsconfig file>), il valore nel file di risposta deve essere una stringa.
• Se il parametro accetta un argomento e può essere visualizzato più volte nella riga di comando (ad esempio, --add <id>), il valore nel file di risposta deve essere una matrice di stringhe.

I parametri specificati nella riga di comando sostituiscono le impostazioni incluse nel file di risposta, tranne quando i parametri accettano più input , ad esempio --add. Quando sono presenti più input, gli input forniti nella riga di comando vengono uniti con le impostazioni del file di risposta.

Configurare il file di risposta usato durante l'installazione da un layout

Se si crea un layout usando il comando --layout, viene creato un file di response.json predefinito nella radice della cartella di layout. Gli amministratori devono modificare e personalizzare il file di risposta in modo appropriato prima di l'installazione in un computer client. In questo modo, possono controllare le impostazioni di configurazione iniziali del client.

Le impostazioni di configurazione nel file di response.json sono utilizzate solo quando si esegue un bootstrapper di, ad esempio vs_enterprise.exe. I programmatori di avvio automatico vengono in genere usati per eseguire l'installazione iniziale nel client, ma a volte vengono usati anche per aggiornare un client. Il response.json non viene mai usato quando si avvia il programma di installazione in locale nel client.

Se l'amministratore ha creato un layout parziale, il file di response.json predefinito nel layout specifica solo i carichi di lavoro e le lingue inclusi nel layout parziale.

Se il layout viene creato passando un file di --config *.vsconfig, il file *.vsconfig viene copiato nella directory di layout come layout.vsconfig e viene fatto riferimento a questo file di configurazione nel file response.json. In questo modo, è possibile usare i file di configurazione per inizializzare le installazioni client provenienti da un layout.

Assicurati di prestare particolare attenzione all'impostazione channelUri, che configura dove il client cerca gli aggiornamenti. La configurazione predefinita è che il client esamini i server ospitati da Microsoft su Internet per gli aggiornamenti. È necessario modificare il valore di channelUri e impostarlo sul layout se si desidera che i client ottengano gli aggiornamenti dal layout. Esempi di come eseguire questa operazione sono descritti in dettaglio di seguito. È sempre possibile modificare la posizione in cui un client cerca gli aggiornamenti in futuro eseguendo il programma di installazione nel client e richiamando il comando modifySettings.

Se l'installazione client non è eseguita in modalità --quiet o --passive, gli utenti possono eseguire l'override delle impostazioni predefinite specificate nel response.json e potranno ulteriormente selezionare o deselezionare carichi di lavoro e componenti aggiuntivi per l'installazione.

Avvertimento

Prestare molta attenzione durante la modifica delle proprietà nel response.json definito al momento della creazione del layout, in quanto alcuni elementi sono necessari per l'installazione.

Il file di base response.json in un layout dovrebbe essere simile all'esempio seguente, tranne che l'ID del prodotto riflette l'edizione nel tuo layout.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/17/release/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "https://aka.ms/vs/17/release.ltsc.17.0/channel",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release.LTSC.17.0",
  "productId": "Microsoft.VisualStudio.Product.Enterprise"
}

Quando si crea o si aggiorna un layout, viene creato anche un file response.template.json. Questo file contiene tutti gli ID del carico di lavoro, del componente e della lingua che possono essere usati. Questo file viene fornito come modello per tutto ciò che può essere incluso in un'installazione personalizzata. Gli amministratori possono usare questo file come punto di partenza per un file di risposta personalizzato. È sufficiente rimuovere gli ID per gli elementi che non si desidera installare e salvarli nel file di response.json o nel file di risposta. Non personalizzare il file response.template.json o le modifiche andranno perse ogni volta che il layout viene aggiornato.

Esempio di contenuto del file di risposta del layout personalizzato

Nell'esempio di file di response.json seguente viene inizializzata un'installazione client di Visual Studio Enterprise per selezionare diversi carichi di lavoro e componenti comuni, per selezionare le lingue dell'interfaccia utente inglese e francese e per configurare il percorso di aggiornamento per cercare le origini in un layout ospitato in rete. Per informazioni su come configurare questo, fare riferimento a Configurare i criteri per le distribuzioni aziendali di Visual Studio e a Configurare il layout in modo da includere sempre il programma di installazione più recente.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",

  "installPath": "C:\\VS2022",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,
  "useLatestInstaller": true,
  "removeOos": true,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ],

    "add": [
        "Microsoft.VisualStudio.Workload.ManagedDesktop",
        "Microsoft.VisualStudio.Workload.Data",
        "Microsoft.VisualStudio.Workload.NativeDesktop",
        "Microsoft.VisualStudio.Workload.NetWeb",
        "Microsoft.VisualStudio.Workload.Office",
        "Microsoft.VisualStudio.Workload.Universal",
        "Component.GitHub.VisualStudio"
    ]
}

Nell'esempio seguente il file response.json inizializza un'installazione client di Visual Studio Enterprise:

• Usa un file di configurazione *.vsconfig che definisce quali carichi di lavoro, componenti ed estensioni installare
• Seleziona sia l'inglese che la lingua dell'interfaccia utente francese
• Configura il percorso di aggiornamento per cercare le origini in un layout ospitato su http
• Consente il caricamento automatico di estensioni non firmate
• Rimuove i componenti passati a uno stato di supporto non supportato al momento dell'aggiornamento del client. Consulta l'elenco dei componenti non più supportati qui.

{
  "installChannelUri": ".\\ChannelManifest.json",
  "channelUri": "http://MyCompanyIntranetSite/VS2022Enterprise/ChannelManifest.json",
  "installCatalogUri": ".\\Catalog.json",
  "channelId": "VisualStudio.17.Release",
  "productId": "Microsoft.VisualStudio.Product.Enterprise",
  "arch": "x64",
  "config": ".\\Layout.vsconfig"
  "installPath": "C:\\VS2022",
  "quiet": false,
  "passive": false,
  "includeRecommended": true,
  "norestart": false,
  "useLatestInstaller": true,
  "removeOos": true,
  "allowUnsignedExtensions": true,

  "addProductLang": [
    "en-US",
    "fr-FR"
    ]

}

Avvertimento

Se stai utilizzando layout intranet ospitati sul web, non puoi impostare "noWeb": true nel response.json e aspettarti che funzioni. Ciò disabiliterà il protocollo HTTP e impedirà al client di accedere al sito Web.

Risoluzione dei problemi

Se si verifica un problema con il programma di avvio automatico di Visual Studio che genera un errore quando lo si associa a un file response.json, vedere Risolvere gli errori correlati alla rete durante l'installazione o l'uso di Visual Studio pagina per altre informazioni.

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 supporto di installazione (solo inglese) per i problemi correlati all'installazione.
• Segnalare i problemi del prodotto usando lo strumento Segnala un problema presente sia nell'installer Visual Studio che nell'IDE. Se si è un amministratore IT e non è installato Visual Studio, è possibile inviare feedback dell'amministratore IT.
• Suggerire una funzionalità, tenere traccia dei problemi del prodotto e trovare le risposte nella Visual Studio Developer Community.

Contenuto correlato

• Guida agli amministratori di Visual Studio
• Creare e gestire un'installazione di rete di Visual Studio
• Distribuire Visual Studio da un layout in un computer client
• Configurare i criteri per le distribuzioni aziendali
• ID dei carichi di lavoro e dei componenti di Visual Studio
• Risolvere gli errori correlati alla rete durante l'installazione o l'uso di Visual Studio