Creare e gestire un'installazione di rete di Visual Studio

📣 Ci farebbe piacere ricevere i vostri commenti!Vi preghiamo di dedicare un momento per completare questo sondaggio e farci sapere come possiamo migliorare l'esperienza di layout. Grazie per il vostro supporto!

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, oppure modificare il contenuto del prodotto, le impostazioni del canale, la versione dell'installatore e le dimensioni della cartella.
• guida e supporto tecnico: dove richiedere assistenza

Creare il layout

Preparare il percorso di archiviazione per la condivisione di 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 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 programmi di avvio automatico seguenti installano sempre la versione più recente e sicura di Visual Studio 2022 sul canale Current, indipendentemente da quando vengono eseguiti. In alternativa, se si desidera creare o aggiornare un layout a una versione specifica o a un canale specifico di Visual Studio 2022, scaricare il bootstrap evergreen e la versione fissa per la release 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.

Edizione	Inizializzatore
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, apri Esplora file, fai clic con il pulsante destro del mouse sul file bootstrapper, scegli Proprietà e quindi scegli la scheda Dettagli. Il campo versione prodotto descrive il canale e versione che saranno installati dal bootstrapper. 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 bootstrapper con una versione del prodotto che indica 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, è necessario disporre di una connessione Internet.

Aprire un prompt dei comandi con privilegi elevati, passare alla directory in cui è stato scaricato il bootstrapper e usare i parametri del bootstrapper come definiti nella pagina usare i parametri della riga di comando per installare Visual Studio per creare e gestire la configurazione di rete. Gli esempi seguenti illustrano i modi comuni per creare layout iniziali. Altri esempi possono essere trovati nella pagina degli esempi del parametro della riga di comando per l'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 aggiuntive richiedono circa mezzo GB ciascuna.

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 aggiornamenti dell'amministratore, se distribuiti in tutta l'organizzazione, usare 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 programmi bootstrap 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 delle 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 creare un layout parziale contenente solo un set specifico di impostazioni locali della lingua , carichi di lavoro, componenti e le 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 tipici della riga di comando per la personalizzazione del layout includono:

• --add per specificare gli ID del carico di lavoro o dei componenti, .
  Se si usa --add, vengono scaricati solo i carichi di lavoro e i componenti specificati con --add. Se --add non viene usato, vengono scaricati tutti i componenti e i carichi di lavoro.
• --includeRecommended 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 usare un file di *.vsconfig per specificare i carichi di lavoro , i componenti o le estensioni che devono essere inclusi o a cui si fa riferimento dal layout. Assicurarsi di specificare il percorso completo del file di configurazione.
• --lang specificare le impostazioni locali della lingua .

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 parametro --config per passare un file *.vsconfig. Assicurarsi di specificare il percorso completo del file di configurazione. L'uso di un file *.vsconfig 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 file *.vsconfig non vengono copiate direttamente nel layout. Il file di response.json del layout contiene invece un riferimento al file layout.vsconfig appena creato, definendo il percorso di installazione per le estensioni del client. Se si installano estensioni non firmate digitalmente, assicurarsi di modificare il response.json per aggiungere "allowUnsignedExtensions": true. Consulta 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 usato xcopy. È anche possibile usare robocopy, se necessario. Esempio:

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

Configurare le impostazioni predefinite per l'installazione iniziale del client 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 dovrebbe ricevere aggiornamenti il cliente
• Se i componenti non supportati devono essere rimossi durante un aggiornamento
• Se le estensioni non firmate possono essere caricate silenziosamente & automaticamente

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 il programma di installazione di Visual Studio più recente. 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. Ricorda inoltre di configurare il valore channelUri nel response.json del layout se si desidera che i clienti ottengano i loro 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 del file	Tipo MIME
   .cab	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 il programma di installazione di Visual Studio più recente 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 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

Manutenzione del tuo 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). Se non lo fai, gli utenti che eventualmente eseguono il programma di installazione durante l'aggiornamento del layout potrebbero trovare una discrepanza nei contenuti del 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 solo ricevere 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 di configurazione del layout layout.json. 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.

Supponi 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 bootstrap esistente nel layout ed eseguire il comando --layout da 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 parametro --passive 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 è possibile 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 eseguire questa operazione:

È possibile andare alla pagina Cronologia delle versioni di Visual Studio 2022, scaricare un bootstrapper di una versione fissa, copiarlo nel layout e utilizzarlo per aggiornare il layout alla versione esatta specificata nel bootstrapper. Si userebbe la stessa sintassi di quanto sopra.

È possibile usare un aggiornamento amministratore per aggiornare il layout a una versione specifica del prodotto. Per ottenere l'aggiornamento dell'amministratore , accedere al Catalogo di Microsoft Updatee cercare l'aggiornamento desiderato per aggiornare il layout. Scaricare il update.exe nel 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 i vari canali di Visual Studio 2022 sono consultabili qui.

Per modificare il canale da cui si basa il layout, acquisire il programma di avvio automatico del canale desiderato dal 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 carichi di lavoro, componenti o lingue aggiuntivi. 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 comando --layout causerà anche l'aggiornamento del layout alla versione specificata dal programma di avvio automatico. Quindi, se si utilizza il bootstrapper evergreen, il layout risultante avrà il nuovo componente, la nuova lingua e tutto il contenuto del layout verrà aggiornato all'ultima versione nel canale del bootstrapper.

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 file *.vsconfig che contiene i componenti aggiuntivi desiderati nel layout. In questo caso, il nuovo contenuto *.vsconfig sovrascriverà il contenuto layout.vsconfig esistente. 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 file di configurazione layout.json nella cartella di layout e aggiornare la sezione "add" di questo file per 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 file response.json 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 e eventualmente modificare la sezione "add" nel file response.json in modo che corrisponda in modo più appropriato al contenuto nella sezione "add" del file di layout.json appena modificato.

Configurare il layout per rimuovere i componenti non supportati sul 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 affinché esso includa l'versione più recente del programma di installazione, come descritto di seguito. In secondo luogo, è necessario aggiungere la riga "removeOos": true al file di response.json. 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 questi file di metadati non sono presenti, "--verify" non può essere eseguito 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 sempreverdi, 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

Usare --fix per eseguire la stessa verifica di --verify e provare anche a risolvere i problemi identificati. Il processo di --fix richiede una connessione Internet, quindi assicurarsi 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, sono necessari i percorsi del file per catalogare i manifesti che contengono tali pacchetti obsoleti. È possibile trovare i manifesti del catalogo in una cartella "Archivio" nella cache del layout di rete. Vengono salvati quando si aggiorna un layout. Nella cartella "Archivio" sono presenti una o più cartelle denominate "GUID", ognuna delle quali contiene un manifesto del catalogo obsoleto. Il numero di cartelle "GUID" deve corrispondere al numero di aggiornamenti apportati ai layout.

Alcuni file vengono salvati all'interno di ogni cartella "GUID". I due file di maggiore interesse sono un file "catalog.json" e un file "version.txt". Il file "catalog.json" è il manifesto del catalogo obsoleto che sarà necessario passare all'opzione --clean. L'altro file version.txt contiene la versione di questo manifest del catalogo obsoleto. In base al numero di versione, è possibile decidere se rimuovere i pacchetti obsoleti da questo manifesto del catalogo. È possibile eseguire le stesse operazioni eseguite nelle altre cartelle "GUID". Dopo aver deciso i cataloghi da pulire, eseguire il comando --clean specificando i percorsi dei file a questi 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. Sarà quindi possibile esaminare i file che verranno eliminati e confermare le eliminazioni.

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 per sempre includere 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 realizzata a partire da giugno 2023.

• È possibile passare il parametro --useLatestInstaller al bootstrapper durante la creazione o l'aggiornamento del layout. In questo modo verrà impostata un'impostazione nel file layout.json, 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 file layout.json 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 file di layout.json, quindi se si vuole che il layout interrompere usando 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 file layout.json e rimuovere l'impostazione di "UseLatestInstaller": true.

Si noti che potresti trovare questa impostazione "UseLatestInstaller": true anche nel file response.json del layout, ma lì viene intenzionalmente 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 impostazione "useLatestInstaller": true nel file di layout.json 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	Operazione completata correttamente
740	Elevazione richiesta
1001	Il processo di installazione di Visual Studio è in esecuzione
1003	Visual Studio è in uso
1602	Operazione annullata
1618	Un'altra installazione in esecuzione
1641	Operazione completata correttamente e il riavvio è stato avviato
3010	Operazione completata correttamente, ma l'installazione richiede il riavvio prima di poter essere usata
5003	Il bootstrapper non è riuscito a scaricare il programma di installazione
5004	Operazione annullata
5005	Errore di analisi della riga di comando del bootstrapper
5007	Operazione bloccata: il computer non soddisfa i requisiti
8001	Errore di controllo macchina Arm
8002	Errore di controllo preliminare del download in background
8003	Condizione di guasto selezionabile non più supportata
8004	Errore della directory di destinazione
8005	Verifica dei guasti 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 connettività
-1073741510	Il programma di installazione di Microsoft Visual Studio è stato terminato (dall'utente o dal processo esterno)
Altro (ad esempio: -1, 1, 1603)	Condizione di guasto - controllare i registri per ulteriori informazioni

Ottenere supporto per il layout di rete

Se si verifica un problema con il tuo layout di rete, vogliamo saperlo. Il modo migliore per indicare è l'uso dello strumento Segnala un problema visualizzato sia nel programma di installazione di Visual Studio che nell'IDE di Visual Studio. Se si è un amministratore IT e non è installato Visual Studio, è possibile inviare feedback dell'amministratore IT qui. Quando si usa questo strumento, sarebbe molto utile inviare i log tramite lo strumento Collect Visual Studio che può essere utile per diagnosticare e risolvere il problema.

È disponibile anche un'opzione di supporto (solo in inglese) per i problemi relativi all'installazione, tramite la chat installazione .

Sono disponibili anche altre opzioni di supporto. Scopri la Visual Studio Developer Community.

Contenuto correlato

• guida dell'amministratore di Visual Studio
• Distribuire Visual Studio da un layout in un computer client
• Aggiornare un'installazione basata sulla 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 e manutenzione del prodotto 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