Creare e gestire un'installazione di rete di Visual Studio

A volte un amministratore dell'organizzazione vuole creare una cache di installazione privata (nota anche come "layout") che contiene file di Visual Studio che possono essere distribuiti nei computer client all'interno di un'organizzazione.

La creazione di un layout è utile nelle situazioni seguenti:

• Un utente dispone di autorizzazioni limitate
• I computer client hanno accesso limitato a Internet
• Un'organizzazione vuole standardizzare in una determinata versione del set di strumenti di sviluppo

Visual Studio è stato progettato in modo che un amministratore possa creare e gestire un layout e archiviarlo in una condivisione di rete interna e, facoltativamente, renderlo disponibile nella intranet di un'organizzazione. Il layout funge da percorso di origine per tutti i file di Visual Studio necessari sia per l'installazione client iniziale che per gli aggiornamenti successivi.

Le informazioni in questa pagina sono raggruppate in tre sezioni principali:

• Creare il layout: descrive come creare il layout con il contenuto del prodotto corretto, configurare le impostazioni predefinite, archiviarlo in una condivisione file di rete e renderlo disponibile nella intranet.
• Mantenere il layout: informazioni su come aggiornare al meglio la versione del prodotto del layout o modificare il contenuto del layout, le impostazioni del canale, la versione del programma di installazione e le dimensioni della cartella.
• Guida e supporto tecnico: dove richiedere assistenza

Creare il layout

Preparare il percorso di archiviazione della condivisione file di rete

Prima di tutto, è necessario determinare dove archiviare i pacchetti di Visual Studio scaricati. Se sono presenti più edizioni di Visual Studio in uso all'interno dell'azienda (ad esempio, Visual Studio 2022 Professional e Visual Studio 2022 Enterprise), è necessario creare un layout separato per ogni edizione. La creazione di un layout separato per ogni edizione può utilizzare molto spazio su disco, soprattutto quando si considera che gli aggiornamenti del layout consumano troppo spazio su disco.

Il percorso del layout deve contenere meno di 80 caratteri; alcune organizzazioni usano correttamente i collegamenti simbolici per aggirare la limitazione di 80 caratteri.

Scaricare il programma di avvio automatico di Visual Studio per creare il layout

Scaricare il programma di avvio automatico corretto per l'edizione di Visual Studio desiderata e copiarlo nella directory che si vuole usare come repository del layout. Dopo aver creato il layout, è possibile usarlo per installare Visual Studio in qualsiasi computer client. Il programma di avvio automatico è l'eseguibile usato per creare, aggiornare ed eseguire altre operazioni di layout. Per completare questo passaggio, è necessario disporre di una connessione Internet e delle autorizzazioni di amministratore.

I programma di avvio automatico seguenti installano sempre la versione più recente sicura di Visual Studio 2022 nel canale corrente, indipendentemente dal momento in cui vengono eseguite. In alternativa, se si vuole creare o aggiornare un layout a una versione specifica o a un canale specifico di Visual Studio 2022, scaricare il programma di avvio automatico delle versioni sempreverdi e fisse per la versione di manutenzione per il canale desiderato dalla cronologia delle versioni di Visual Studio 2022. Copiarlo nella directory che si vuole usare come percorso di origine del layout.

Edition	Programma di avvio automatico
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Strumenti di compilazione di Visual Studio 2022	vs_buildtools.exe

Suggerimento

Se in precedenza è stato scaricato un file del programma di avvio automatico e si vuole verificare quale versione verrà installata, ecco come. In Windows aprire Esplora file, fare clic con il pulsante destro del mouse sul file del programma di avvio automatico, scegliere Proprietà e quindi scegliere la scheda Dettagli. Il campo Versione prodotto descrive il canale e la versione che verrà installato dal programma di avvio automatico. Il numero di versione deve essere sempre letto come "versione di manutenzione più recente di ciò che viene specificato" e si presuppone che il canale sia Current, a meno che non sia specificato in modo esplicito. Quindi, un programma di avvio automatico con una versione Product di LTSC 17.0 installa la versione di manutenzione 17.0.x più recente disponibile nel canale 17.0 LTSC. Un programma di avvio automatico con una versione del prodotto che indica che Visual Studio 2022 installa la versione di manutenzione più recente di Visual Studio 2022 nel canale corrente.

Scaricare i pacchetti di Visual Studio

Per completare questo passaggio è necessaria una connessione Internet.

Aprire un prompt dei comandi con privilegi elevati, passare alla directory in cui è stato scaricato il programma di avvio automatico e usare i parametri del programma di avvio automatico come definito nella pagina usare i parametri della riga di comando per installare Visual Studio per creare e gestire il layout di rete. Gli esempi seguenti illustrano i modi comuni per creare layout iniziali. Altri esempi sono disponibili negli esempi di parametri della riga di comando per una pagina di installazione di Visual Studio.

Un layout iniziale completo per una singola lingua richiede circa 40 GB di spazio su disco per Visual Studio Community e circa 50 GB per Visual Studio Enterprise. Le impostazioni locali della lingua aggiuntiva richiedono circa mezzo GB ciascuno.

L'approccio consigliato consiste nel creare un layout iniziale di Visual Studio con tutti i carichi di lavoro e le lingue appropriate e archiviare i pacchetti nella directory di layout nel server di rete. In questo modo, qualsiasi installazione client ha accesso all'intera offerta di prodotto Visual Studio e la possibilità di installare qualsiasi subset. Per creare un layout completo di Visual Studio, eseguire il comando seguente dalla directory in cui si prevede di ospitare il layout di rete:

vs_enterprise.exe --layout c:\VSLayout

Verificare che il layout sia basato sul canale corretto

È importante assicurarsi che il layout di rete sia basato sul canale corretto, perché è uno dei criteri che gli amministratori aggiornano, se distribuiti in tutta l'organizzazione, usano per identificare le istanze client da aggiornare. Ad esempio, se il layout è basato sul canale VisualStudio.17.Release.LTSC.17.0 e se i client sono configurati per ricevere aggiornamenti dai server ospitati da Microsoft, eventuali aggiornamenti della sicurezza resi disponibili nel canale 17.0 LTSC sono disponibili per i client installati o aggiornati da tale layout.

I programma di avvio automatico elencati in precedenza sono basati sul canale Corrente. Per creare un layout basato su uno dei canali LTSC, acquisire il programma di avvio automatico del canale corretto dalla pagina Cronologia versioni di Visual Studio 2022, copiarlo nella cartella di layout e usarlo per creare o aggiornare il layout.

Configurare il contenuto di un layout

Sono disponibili diverse opzioni che è possibile usare per personalizzare il contenuto del layout di rete. È possibile, ad esempio, creare un layout parziale che contenga solo un set specifico di impostazioni locali delle lingue, carichi di lavoro, componenti e relative dipendenze consigliate o facoltative. Un layout parziale è utile se si sa che si intende distribuire solo un subset di carichi di lavoro nelle workstation client. I parametri della riga di comando tipici per la personalizzazione del layout includono:

• --add per specificare ID di carico di lavoro o di componente.
  Se si usa --add, verranno scaricati solo i carichi di lavoro e i componenti specificati con --add. Se non si usa --add, verranno scaricati tutti i carichi di lavoro e i componenti.
• --includeRecommended per includere tutti i componenti consigliati per gli ID del carico di lavoro specificati.
• --includeOptional per includere tutti i componenti facoltativi per gli ID del carico di lavoro specificati.
• --config per usare un *.vsconfig file per specificare i carichi di lavoro, i componenti o le estensioni che devono essere inclusi o a cui fa riferimento il layout. Assicurarsi di specificare il percorso completo del file di configurazione.
• --lang per specificare le impostazioni locali delle lingue.

Ecco alcuni esempi di come creare un layout di rete personalizzato.

• Per creare un layout con i componenti necessari per tutti i carichi di lavoro in una sola lingua, eseguire:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US
  

• Per creare un layout con i componenti necessari per tutti i carichi di lavoro in più lingue, eseguire:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
  

• Per creare un layout con un carico di lavoro e tutti i componenti necessari e consigliati per tale carico di lavoro in tutte le lingue, eseguire:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
  

• Per creare un layout con due carichi di lavoro e un componente facoltativo in tre lingue, eseguire:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP
  

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

È possibile usare il --config parametro per passare un *.vsconfig file. Assicurarsi di specificare il percorso completo del file di configurazione. L'uso di un *.vsconfig file durante la creazione del layout consente di personalizzare e limitare il contenuto di un layout di rete a quello specificato nel file di configurazione. Il file di configurazione viene copiato nella directory di layout e rinominato in layout.vsconfig.

Le estensioni specificate nel *.vsconfig file non vengono copiate direttamente nel layout. Il file del response.json layout contiene invece un riferimento al file appena creato layout.vsconfig , definendo il percorso di installazione per le estensioni del client. Se si installano estensioni non firmate digitalmente, assicurarsi di modificare per response.json aggiungere "allowUnsignedExtensions": true. Vedere response.json esempi di contenuto.

vs_enterprise.exe --layout "C:\VSLayout" --config "C:\myconfig.vsconfig" 

Copiare il layout in una condivisione di rete

È necessario ospitare il layout in una condivisione di rete in modo che sia accessibile dai computer client. Se il layout è stato creato in un computer locale, è necessario copiarlo in un percorso di file di rete. Nell'esempio seguente viene utilizzato xcopy: È anche possibile usare robocopy, se necessario. Esempio:

xcopy /e c:\VSLayout \\server\share\layoutdirectory

Configurare le impostazioni predefinite per l'installazione client iniziale per questo layout

Viene creato un file denominato response.json nella cartella radice del layout. Questo file personalizzabile fornisce le impostazioni predefinite iniziali da configurare nel client, quando il client viene inizialmente installato dal layout. Le opzioni di configurazione comuni includono la possibilità di configurare:

• Quali carichi di lavoro, componenti o lingue devono essere installati per impostazione predefinita nel client
• Se devono essere installati anche i componenti consigliati
• Se il client deve rispettare un file di installazione *.vsconfig
• Dove deve ricevere gli aggiornamenti dal client
• Se i componenti non supportati devono essere rimossi durante un aggiornamento
• Se le estensioni non firmate possono essere caricate tranquillamente e a livello di codice

Altre informazioni sono disponibili nella pagina Automatizzare l'installazione di Visual Studio con un file di risposta.

Rendere il layout accessibile tramite un sito Intranet

A partire da giugno 2023, è possibile rendere disponibili i layout in un sito Intranet interno, che consente di sfruttare le funzionalità di memorizzazione nella cache dei file del server Web e prestazioni di replica geografica. Per usare questa nuova funzionalità, è necessario usare i programma di avvio automatico di Visual Studio più recenti e le Programma di installazione di Visual Studio più recenti. Gli amministratori IT devono eseguire le operazioni seguenti per sfruttare questa funzionalità di hosting Web Intranet:

1. Prima di tutto, creare e gestire un layout di rete e assicurarsi che i bit siano presenti e aggiornati regolarmente nella condivisione di rete. Ricordarsi inoltre di configurare il valore channelUri nel response.json del layout se si desidera che i client ottengano gli aggiornamenti dal percorso del layout Intranet.

2. Successivamente, un amministratore dovrà preparare un sito Web interno e associare l'origine del sito Web al percorso del file di rete del layout. Devono anche assicurarsi che il server Web rispetti i tipi MIME seguenti:

   Estensione file	Tipo MIME
   .Taxi	application/vnd.ms-cab-compressed
   .exe	application/octet-stream
   .json	application/json
   .Msi	application/octet-stream
   .Msu	application/octet-stream
   .nupkg	application/octet-stream
   .Opc	application/octet-stream
   .ps1	application/postscript
   .vsix	application/octet-stream
   .Xml	text/xml
   .zip	application/x-zip-compressed

3. Infine, per distribuire questo layout nel client, eseguire uno script di PowerShell nel client per eseguire l'installazione iniziale. Dopo che Visual Studio è stato installato correttamente nel client da un layout ospitato sul Web, gli aggiornamenti client per i layout webhosted possono essere aggiornati tramite metodi standard.

Verificare che il layout usi il programma di installazione più recente

Nota

A partire da giugno 2023, il programma di installazione più recente viene fornito per impostazione predefinita con ogni aggiornamento a tutte le versioni supportate di Visual Studio 2017, Visual Studio 2019 e Visual Studio 2022. Pertanto, se usi una di queste versioni del prodotto, non dovrai eseguire alcuna operazione in modo esplicito per ottenere la versione più recente del programma di installazione con le funzionalità e le correzioni di bug più recenti.

Se si usa una versione di Visual Studio fornita prima di giugno 2023, è consigliabile usare sempre le Programma di installazione di Visual Studio più recenti nel layout e distribuirlo ai client. Ad esempio, se si distribuisce il programma di installazione di Visual Studio 2022 nel layout di Visual Studio 2019, i client di Visual Studio 2019 basati su tale layout hanno la possibilità di modificare il percorso di origine per gli aggiornamenti o rimuovere facilmente i componenti non supportati. Altri dettagli sono descritti nella sezione seguente.

La funzionalità per garantire a livello di codice che si stia usando il programma di installazione più recente è disponibile solo per i programmatori di avvio automatico di Visual Studio 2019 compilati dopo la distribuzione originale di Visual Studio 2022. Pertanto, il vs_enterprise.exe nell'esempio seguente deve essere una versione fornita dopo il 10 novembre 2021.

Per creare un layout dell'intero prodotto che usa il programma di installazione più recente e più grande disponibile, eseguire

vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller

Gestione del layout

È consigliabile aggiornare periodicamente il layout di Visual Studio alla versione sicura più recente del prodotto. In questo modo il layout può essere usato sia come punto di installazione che come origine di aggiornamento per le installazioni client. Nella sezione seguente vengono descritte le operazioni di manutenzione del layout più comuni o utili.

Se si ospita un layout in una condivisione file di rete, è possibile scaricare un layout aggiornato in una condivisione locale privata (ad esempio, c:\VSLayoutUpdate) e quindi, dopo il download di tutto il contenuto aggiornato, copiarlo nella condivisione file di rete di layout (ad esempio, \server\products\VS). In caso contrario, gli utenti che eseguono il programma di installazione durante l'aggiornamento del layout potrebbero ottenere una mancata corrispondenza del contenuto dal layout perché non è stato ancora completamente aggiornato.

Aggiornare il layout alla versione più recente del prodotto

Microsoft rilascia spesso versioni aggiornate del prodotto per risolvere i problemi di sicurezza o funzionalità. È consigliabile mantenere aggiornato il layout con la versione più recente del prodotto in modo che i client abbiano sempre accesso alla versione più recente del prodotto. Ciò è particolarmente importante se i client non hanno accesso a Internet e possono ricevere solo gli aggiornamenti del prodotto dal layout. Visual Studio rilascia in genere gli aggiornamenti della sicurezza il secondo martedì del mese, noto come "patch tuesday", quindi una buona strategia consiste nell'aggiornare tutti i layout nei pomeriggi di martedì patch.

Quando si crea il layout iniziale, le opzioni specificate, ad esempio i carichi di lavoro e le lingue da includere nel layout, vengono salvate nel file layout.jsondi configurazione del layout . In seguito, quando si aggiorna il layout a una versione più recente del prodotto, non è necessario specificare nuovamente i componenti del prodotto desiderato nel layout. Un aggiornamento del layout aggiorna semplicemente i componenti esistenti nel layout alla versione più recente.

Si supponga di aver già creato questo layout parziale usando uno dei bootstrapper sempreverdi nella tabella precedente.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US

L'aggiornamento di questo layout alla versione più recente del prodotto offerto da Microsoft e ospitato nei server Microsoft è semplice. È sufficiente usare il programma di avvio automatico sempreverdi esistente nel layout ed eseguire il --layout comando in un prompt con privilegi elevati per scaricare i pacchetti più recenti nel layout, come indicato di seguito:

vs_enterprise.exe --layout c:\VSLayout

È anche possibile aggiornare il layout a una versione aggiornata in modo automatico. L'operazione di layout esegue il processo di installazione in una nuova finestra della console. La finestra viene lasciata aperta in modo che gli amministratori possano visualizzare il risultato dell'aggiornamento del layout finale e un riepilogo di eventuali errori che potrebbero essersi verificati. Se si vuole eseguire un'operazione di aggiornamento del layout in modo automatico (ad esempio, si dispone di uno script che viene eseguito regolarmente per aggiornare il layout alla versione più recente), usare il --passive parametro e il processo chiuderà automaticamente la finestra.

vs_enterprise.exe --layout c:\VSLayout --passive

Aggiornare il layout a una versione specifica del prodotto

A volte può essere necessario aggiornare il layout a una versione specifica del prodotto. Ad esempio, è possibile che il layout corrisponda alla versione sicura più recente della baseline di manutenzione su cui è stata standardizzata l'organizzazione. Ecco come fare:

È possibile passare alla pagina Cronologia versioni di Visual Studio 2022 e scaricare un particolare programma di avvio automatico della versione fissa, copiarlo nel layout e usarlo per aggiornare il layout a quella versione esatta specificata nel programma di avvio automatico. Si userebbe la stessa sintassi di quanto sopra.

È possibile usare un aggiornamento dell'amministratore per aggiornare il layout a una versione specifica del prodotto. Per ottenere l'aggiornamento dell'amministratore, passare al Catalogo di Microsoft Update e cercare l'aggiornamento a cui si vuole aggiornare il layout. Scaricare nel update.exe computer che ospita il layout, aprire un prompt dei comandi con privilegi elevati nel computer ed eseguire un comando simile al seguente:

visualstudioupdate-17.0.0to17.4.4.exe layout --layoutPath c:\VSLayout

Si noti che un aggiornamento dell'amministratore non avvierà la creazione di un nuovo layout; aggiornerà solo un layout esistente. È necessario usare un programma di avvio automatico per creare il layout iniziale.

Verifica che il layout di rete sia basato su una versione supportata

In alcuni casi, quando i canali escono dal supporto, è necessario assicurarsi che il layout di rete continui a essere basato su un canale supportato in modo che i client possano continuare a ricevere notifiche degli aggiornamenti della sicurezza. Se il layout è basato sul canale VisualStudio.17.Release.LTSC.17.0, dopo che il canale LTSC 17.0 esce dal supporto a luglio 2023, non verranno rilasciati altri aggiornamenti della sicurezza e il layout e i client non saranno più sicuri. Le date di supporto per vari canali di Visual Studio 2022 sono disponibili qui.

Per modificare il canale su cui si basa il layout, acquisire il programma di avvio automatico del canale desiderato dalla pagina Cronologia versioni di Visual Studio 2022, copiarlo nella cartella di layout ed eseguire un normale aggiornamento. I client devono quindi ricevere una notifica appropriata di un aggiornamento in modo che possano rimanere sicuri.

Modificare il contenuto di un layout

È possibile modificare un layout parziale e aggiungere altri carichi di lavoro, componenti o lingue. Non è possibile rimuovere in modo affidabile i componenti da un layout.

Nell'esempio seguente si aggiungeranno il carico di lavoro di Azure e una lingua localizzata al layout creato in precedenza con solo il carico di lavoro Desktop gestito e la lingua inglese. Dopo aver apportato la modifica, entrambi i carichi di lavoro di Desktop gestito e Azure e le risorse in inglese e tedesco verranno incluse in questo layout. Oltre ad aggiungere componenti, il --layout comando causerà anche l'aggiornamento del layout alla versione specificata dal programma di avvio automatico. Quindi, se si usa il programma di avvio automatico sempreverdi, il layout risultante avrà il nuovo componente, la nuova lingua e tutto il contenuto del layout verrà aggiornato alla versione più recente nel canale del programma di avvio automatico.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE

Se si desidera modificare un layout parziale esistente in modo che diventi un layout completo, usare l'opzione --all, come illustrato nell'esempio seguente. Anche in questo caso, questo comando causerà l'aggiornamento del contenuto del layout alla versione specificata dal programma di avvio automatico.

vs_enterprise.exe --layout c:\VSLayout --all

È possibile aggiungere componenti a un layout passando un *.vsconfig file contenente i componenti aggiuntivi desiderati nel layout. In questo caso, il nuovo *.vsconfig contenuto sovrascriverà il contenuto esistente layout.vsconfig . Per altre informazioni, vedere la sezione precedente Uso di un file di configurazione per inizializzare il contenuto di un layout.

vs_enterprise.exe --layout C:\VSLayout --config "C:\myupdatedconfig.vsconfig"

Infine, è possibile modificare direttamente il layout.json file di configurazione nella cartella di layout e aggiornare la sezione "add" di questo file in modo da includere i componenti aggiuntivi che si desidera includere nel layout. Sarà quindi necessario aggiornare il layout usando --layout come descritto in precedenza per scaricare i componenti più recenti.

Nota

Il modo più semplice per installare i componenti di layout appena aggiunti in un computer client consiste nell'eseguire il programma di avvio automatico nel layout dal computer client. La sezione 'add' del response.json file nel layout determinerà quali componenti sono selezionati per impostazione predefinita nell'interfaccia utente del programma di installazione del client. Se il layout è stato modificato usando uno dei metodi precedenti, è consigliabile controllare manualmente ed eventualmente modificare la sezione "add" nel response.json file in modo che corrisponda in modo più appropriato al contenuto nella sezione "add" del file appena modificato layout.json .

Configurare il layout per rimuovere i componenti out-of-support nel computer client.

Alcune aziende vogliono sfruttare la funzionalità introdotta in Visual Studio 2022 versione 17.4 che rimuove i componenti che hanno eseguito la transizione a uno stato non supportato. Questa operazione è relativamente semplice da configurare se si gestisce un layout e se i client ricevono aggiornamenti di amministratore. Prima di tutto, è necessario configurare il layout per avere la versione più recente del programma di installazione, come descritto di seguito. In secondo luogo, sarà necessario aggiungere la riga "removeOos": true al response.json file. Se il layout ha questi due dettagli impostati correttamente, gli aggiornamenti dell'amministratore successivi rispetteranno questa impostazione e rimuoveranno i componenti non supportati dai computer client.

Verificare un layout

Usare --verify per eseguire la verifica nel layout di rete che controlla se i file dei pacchetti sono mancanti o non validi. Al termine della verifica, stampa l'elenco dei file mancanti e non validi.

La verifica funziona solo per la versione più recente di una versione secondaria specifica di Visual Studio. Non appena viene rilasciata una nuova versione, la verifica non funzionerà per i layout che contengono versioni precedenti.

vs_enterprise.exe --layout <layoutDir> --verify

Nota

Alcuni file di metadati importanti necessari per l'opzione --verify devono trovarsi nella cartella di layout. Se tali file di metadati non sono presenti, non è possibile eseguire "--verify" e il programma di installazione restituisce un errore. Se si verifica questo errore, provare ad aggiornare di nuovo il layout o ricreare un nuovo layout di rete in una cartella diversa.

Tenere presente che Microsoft invia periodicamente gli aggiornamenti a Visual Studio, quindi, se si usa un programma di avvio automatico sempre più recente, un layout più recente potrebbe non contenere la stessa versione del layout iniziale. Tuttavia, se si usa un programma di avvio automatico dei collegamenti fissi, si otterrà (quasi) sempre un set di file deterministico.

Correzione di un layout

Utilizzare --fix per eseguire la stessa verifica come --verify e inoltre tentare di risolvere i problemi identificati. Il processo --fix richiede una connessione a Internet, quindi verificare che il computer sia connesso a Internet prima di richiamare --fix.

vs_enterprise.exe --layout <layoutDir> --fix

Rimuovere le versioni precedenti da un layout

Dopo aver eseguito gli aggiornamenti del layout a una cache di rete, la cartella di layout potrebbe avere alcuni pacchetti obsoleti che non sono più necessari per l'installazione più recente di Visual Studio. È possibile usare l'opzione --clean per rimuovere i pacchetti obsoleti dalla cartella del layout di rete.

A tale scopo, è necessario utilizzare i percorsi file per i manifesti dei cataloghi che contengono tali pacchetti obsoleti. È possibile trovare i manifesti del catalogo in una cartella "Archivio" nella cache del layout di rete. Vengono salvati presente quando si aggiorna un layout. Nella cartella "Archive", sono presenti una o più cartelle denominate "GUID", ciascuna delle quali contiene un manifesto di catalogo obsoleto. Il numero di cartelle "GUID" deve corrispondere al numero di aggiornamenti apportati ai layout.

Alcuni file vengono salvati all'interno di ciascuna cartella "GUID". I due file di maggior interesse sono un file "catalog.json" e un file "version.txt". Il file "catalog.json" è il manifesto di catalogo obsoleto è necessario passare all’opzione --clean. Il file version.txt dell’altra versione contiene la versione di questo manifesto del catalogo obsoleto. In base al numero di versione, è possibile decidere se si desidera rimuovere pacchetti obsoleti da questo manifesto del catalogo. È possibile eseguire la stessa operazione procedendo con le altre cartelle "GUID". Dopo deciso in merito a cataloghi di cui eseguire la pulizia, eseguire il --clean comando specificando i percorsi file per tali cataloghi.

Di seguito è riportato un esempio di come usare l'opzione --clean:

c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VSLayout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

Quando si esegue questo comando, il programma di installazione analizza la cartella del layout di rete per trovare l'elenco dei file che verranno rimossi. Quindi, si avrà la possibilità di esaminare i file che verranno eliminati e confermarne l'eliminazione.

Configurare il layout in modo che includa sempre e fornisca il programma di installazione più recente

Nota

A partire da giugno 2023, il programma di installazione più recente è disponibile per impostazione predefinita con ogni aggiornamento alle versioni supportate di Visual Studio 2017, Visual Studio 2019 e Visual Studio 2022. Non è quindi necessario eseguire alcuna operazione in modo esplicito per ottenere la versione più recente del programma di installazione con le funzionalità e le correzioni di bug più recenti nel layout e nei client.

Tuttavia, se si usa un layout creato prima di giugno 2023, è anche possibile configurare in modo esplicito il layout in modo da includere sempre e fornire il programma di installazione più recente ai client, anche se il programma di installazione è considerato parte di una versione più recente di Visual Studio. Pertanto, quando il client viene aggiornato da questo layout, il client acquisirà il programma di installazione più recente incluso e fornito da questo layout. Il vantaggio è che una volta che il programma di installazione più recente è sul client, le installazioni client saranno in grado di sfruttare le correzioni di bug e le nuove funzionalità che continuiamo ad aggiungere al programma di installazione.

Esistono diversi modi per consentire al layout di includere e fornire il programma di installazione più recente:

• È possibile usare una versione di Visual Studio basata su o dopo giugno 2023.

• È possibile passare il --useLatestInstaller parametro al programma di avvio automatico durante la creazione o l'aggiornamento del layout. In questo modo, un'impostazione verrà impostata nel layout.json file, disponibile nella directory radice del layout. Ecco un esempio di come aggiornare il layout e configurarlo per usare il programma di installazione più recente e più grande disponibile.

  vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
  

• È possibile modificare il layout.json file direttamente per aggiungere questa impostazione.

  {
     "installChannelUri": ".\\ChannelManifest.json",
     "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
     "installCatalogUri": ".\\Catalog.json",
     "channelId": "VisualStudio.16.Release",
     "productId": "Microsoft.VisualStudio.Product.Enterprise",
  
     "useLatestInstaller": true,
     "removeOos": true
  
  }
  

Non è possibile rimuovere questa impostazione a livello di codice nel layout.json file, quindi se si vuole interrompere l'uso del layout con il programma di installazione più recente reso disponibile da Microsoft e usare invece la versione del programma di installazione corrispondente al programma di avvio automatico (che è probabilmente precedente al programma di installazione più recente), modificare il layout.json file e rimuovere l'impostazione"UseLatestInstaller": true.

Si noti che questa "UseLatestInstaller": true impostazione può essere presente anche nel file del response.json layout, ma viene ignorata per garantire che il layout abbia sempre il programma di installazione più recente. Il file response.json viene usato per impostare le opzioni di configurazione predefinite nel client quando il client installa o aggiorna da un layout. Questa particolare "useLatestInstaller": true impostazione nel layout.json file viene usata per garantire che il contenuto del layout contenga il programma di installazione più recente, in modo che i computer client possano quindi acquisire il programma di installazione più recente dal layout.

Codici di errore

Se è stato usato il parametro --wait, a seconda del risultato dell'operazione, la variabile di ambiente %ERRORLEVEL% viene impostata su uno dei valori seguenti:

valore	Risultato
0	L'operazione è riuscita
740	Elevazione obbligatoria
1001	Il processo di installazione di Visual Studio è in esecuzione
1003	Visual Studio è in uso
1602	L'operazione è stata annullata
1618	Un'altra installazione in esecuzione
1641	L'operazione è stata completata ed è stato avviato il riavvio
3010	L'operazione è riuscita, ma è necessario riavviare per poter usare l'installazione
5003	Il programma di avvio automatico non è riuscito a scaricare il programma di installazione
5004	L'operazione è stata annullata
5005	Errore di analisi della riga di comando del programma di avvio automatico
5007	L'operazione è stata bloccata. Il computer non soddisfa i requisiti
8001	Errore di controllo del computer Arm
8002	Errore di controllo preliminare del download in background
8003	Errore selezionabile non supportato
8004	Errore della directory di destinazione
8005	Verifica degli errori dei payload di origine
8006	Processi di Visual Studio in esecuzione
8010	Sistema operativo non supportato. Fare riferimento ai requisiti di sistema
-1073720687	errore di Connessione ivity
-1073741510	Il programma di installazione di Microsoft Visual Studio è stato terminato (dall'utente o da un processo esterno)
Altro (ad esempio: -1, 1, 1603)	Si è verificata una condizione di errore. Per altre informazioni, vedere i log

Ottenere supporto per il layout di rete

Se si verifica un problema con il layout di rete, è opportuno conoscerlo. Il modo migliore per indicare è l'uso dello strumento Segnala un problema visualizzato sia nella Programma di installazione di Visual Studio che nell'IDE di Visual Studio. Se si è un Amministrazione istrator IT e non si dispone di Visual Studio installato, è possibile inviare commenti e suggerimenti sul Amministrazione IT qui. Quando si usa questo strumento, sarebbe molto utile inviare i log tramite lo strumento Di raccolta di Visual Studio che consente di diagnosticare e risolvere il problema.

Per i problemi correlati all'installazione è disponibile anche un'opzione di supporto che offre una chat per l'installazione (solo in lingua inglese).

Sono disponibili anche altre opzioni per il supporto. Vedere la community per sviluppatori di Visual Studio.

Contenuto correlato

• Guida dell'amministratore di Visual Studio
• Distribuire Visual Studio da un layout in un computer client
• Aggiornare un'installazione di rete di Visual Studio
• Risolvere gli errori correlati alla rete durante l'installazione o l'uso di Visual Studio
• Configurare i criteri per le distribuzioni aziendali di Visual Studio
• Ciclo di vita del prodotto e manutenzione di Visual Studio
• Use command-line parameters to install Visual Studio (Usare i parametri della riga di comando per installare Visual Studio)
• ID dei carichi di lavoro e dei componenti di Visual Studio
• Installare i certificati necessari per l'installazione offline di Visual Studio