Esempi di parametri della riga di comando per l'installazione di Visual Studio

Questo articolo include numerosi esempi personalizzabili che illustrano come usare i parametri della riga di comando per installare Visual Studio.

In ogni esempio, vs_enterprise.exe, vs_professional.exee vs_community.exe rappresentano la rispettiva edizione del programma di avvio automatico di Visual Studio, ovvero il file piccolo (~ 1MB) che avvia il processo di download. Se si usa un'edizione diversa, sostituire il nome del programma di avvio automatico appropriato.

Tutti i comandi richiedono l'elevazione dei privilegi amministrativi e verrà visualizzato un prompt di controllo dell'account utente se il processo non viene avviato da un prompt con privilegi elevati.

Per concatenare più righe in un unico comando, è possibile usare il carattere ^ alla fine di una riga di comando. In alternativa, è possibile posizionare queste righe in un'unica riga. In PowerShell, l'equivalente è il carattere apice inverso (`).

Per gli elenchi dei carichi di lavoro e dei componenti che è possibile installare tramite la riga di comando, vedere la pagina ID dei carichi di lavoro e dei componenti di Visual Studio.

Installare con --installPath e --add insieme al programma di avvio automatico

• Installare un'istanza minima di Visual Studio, senza prompt interattivi, ma viene visualizzato lo stato di avanzamento:

  vs_enterprise.exe --installPath C:\minVS ^
  --add Microsoft.VisualStudio.Workload.CoreEditor ^
  --passive --norestart
  

• Per installare automaticamente un'istanza desktop di Visual Studio, unitamente al Language Pack per la lingua francese, senza indicazione dello stato di avanzamento dell'operazione fino al completamento dell'installazione del prodotto.

  vs_enterprise.exe --installPath C:\desktopVS ^
  --addProductLang fr-FR ^
  --add Microsoft.VisualStudio.Workload.ManagedDesktop ^
  --includeRecommended --quiet --wait
  

Update

• Aggiornare un'istanza di Visual Studio tramite la riga di comando con lo stato visualizzato e senza prompt interattivi. È possibile eseguire queste serie di comandi in due passaggi usando un programma di avvio automatico disponibile nel client o in un layout. Il primo comando aggiorna il programma di installazione nel client e il secondo comando aggiorna il prodotto Visual Studio. È necessario eseguire questi comandi in un prompt dei comandi con privilegi elevati, perché l'aggiornamento del programma di installazione richiede autorizzazioni di amministratore. L'esempio seguente simula l'aggiornamento di un client usando un programma di avvio automatico sempreverdi nel layout.

  \\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait
  \\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"
  

In alternativa, è anche possibile aggiornare l'istanza di Visual Studio in un unico passaggio usando il programma di installazione nel client. Gli utenti standard, se hanno ottenuto le autorizzazioni appropriate, possono eseguire il comando di aggiornamento a livello di codice usando il programma di installazione, ma non sono autorizzati a usare l'opzione --passive o --quiet . Si noti che non è possibile avviare il programma di installazione a livello di codice dalla stessa directory in cui risiede il programma di installazione.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"

Uso di -- wait

• Usare --wait nei file batch o negli script per attendere il completamento del comando iniziale prima dell'esecuzione del comando successivo. Per i file batch, una %ERRORLEVEL% variabile di ambiente contiene il valore restituito del comando, come documentato nella pagina Usare i parametri della riga di comando per installare Visual Studio . Alcune utilità di comando richiedono altri parametri per attendere il completamento e ottenere il valore restituito del programma di installazione.

Il --wait parametro è supportato solo dal programma di avvio automatico.

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

Il comando seguente è un esempio di utilizzo --wait con il comando Start-Processscript di PowerShell :

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode 

or

 $startInfo = New-Object System.Diagnostics.ProcessStartInfo
 $startInfo.FileName = "vs_enterprise.exe"
 $startInfo.Arguments = "--all --quiet --wait"
 $process = New-Object System.Diagnostics.Process
 $process.StartInfo = $startInfo
 $process.Start()
 $process.WaitForExit()

• Il primo --wait viene usato dal programma di avvio automatico di Visual Studio e il secondo -Wait viene usato da 'Start-Process' per attendere il completamento. Il -PassThru parametro viene usato da Start-Process per usare il codice di uscita del programma di installazione per il relativo valore restituito.

Uso di --layout per creare un layout di rete o una cache locale

• Creare un layout che includa solo l'editor principale di Visual Studio (la configurazione minima di Visual Studio) e il Language Pack in inglese. Altri esempi di creazione del layout sono disponibili nella pagina Creare un'installazione di rete di Visual Studio .

  vs_professional.exe --layout "C:\VS" ^
  --lang en-US ^
  --add Microsoft.VisualStudio.Workload.CoreEditor ^
  

Uso di --all per acquisire l'intero prodotto

• Per avviare un'installazione interattiva di tutti i carichi di lavoro e di tutti i componenti disponibili in Visual Studio Enterprise:

  vs_enterprise.exe --all
  

Uso di --includeRecommended

• Installare una seconda istanza di Visual Studio Professional usando un nome alternativo in un computer con Visual Studio Community Edition già installato, con il supporto per lo sviluppo di Node.js:

  vs_professional.exe --installPath C:\VSforNode ^
  --add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode
  

Uso di --channelURI

Usando il programma di installazione più recente, è possibile configurare la posizione in cui Visual Studio cerca gli aggiornamenti. è --channelUri altrimenti noto come canale di aggiornamento o percorso di origine degli aggiornamenti. La tabella seguente fornisce valori di esempio per channelId e channelUri e il significato.

Se si sceglie di usare un layout personalizzato come canale di aggiornamento, tenere presente le linee guida seguenti:

• --channelUri deve puntare al file "channelmanifest.json" nel layout personalizzato.
• Gli amministratori possono configurare la modalità di visualizzazione del layout personalizzato "Canale privato" nell'interfaccia utente delle impostazioni di aggiornamento configurando le impostazioni del Registro di sistema del client.

Uso di --remove

• Rimuovere il componente Strumenti di profilatura dall'istanza predefinita di Visual Studio installata. In questo esempio viene usato il programma di installazione già installato nel computer client. Gli utenti standard con autorizzazioni appropriate possono eseguire il comando modify a livello di codice usando il programma di installazione, ma non possono usare l'opzione --passive o --quiet . Si noti che non è possibile avviare il programma di installazione a livello di codice dalla stessa directory in cui risiede il programma di installazione.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
  --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
  --remove Microsoft.VisualStudio.Component.DiagnosticTools ^
  --passive
  

Non è possibile usare --remove nello stesso comando di --layout. In altre parole, non è possibile rimuovere componenti da un layout.

Uso di --removeOs

Usando il programma di installazione più recente, è possibile modificare un'installazione e rimuovere tutti i componenti che hanno eseguito la transizione a uno stato out-of-support dall'istanza predefinita di Visual Studio installata. Questo esempio usa il programma di installazione già installato nel computer client per configurare l'impostazione removeOs. Gli utenti standard, se hanno ottenuto le autorizzazioni appropriate, possono eseguire il comando modify a livello di codice usando il programma di installazione, ma non sono autorizzati a usare l'opzione --passive o --quiet . Non è possibile avviare il programma di installazione a livello di codice dalla stessa directory in cui risiede il programma di installazione.

 "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
 --removeOos true ^
 --passive

• Modificare le impostazioni di aggiornamento per rimuovere in modo permanente tutti i componenti passati a uno stato out-of-support ogni volta che il prodotto viene aggiornato:

  "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
  --channelURI https://aka.ms/vs/17/release.LTSC.17.0/channel ^
  --productID Microsoft.VisualStudio.Product.Enterprise ^
  --newChannelURI \\layoutserver\share\path\channelmanifest.json ^
  --removeOos true ^
  --quiet  
  

Uso di --path

Tutti questi esempi presuppongono che si stia installando un nuovo prodotto usando un programma di avvio automatico.

• Usare i percorsi di installazione, cache e condivisi:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"

• Usare solo i percorsi di installazione e cache:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"

• Usare solo i percorsi di installazione e condivisi:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"

• Usare solo il percorso di installazione:

  vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

Uso di export

• Usare l'esportazione per salvare la selezione da un'installazione. In questo esempio viene usato il programma di installazione già installato nel computer client.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"
  

• Usare l'esportazione per salvare la selezione personalizzata da zero. In questo esempio viene usato il programma di installazione già installato nel computer client.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"
  

Uso di --config

• Usare --config per installare i carichi di lavoro e i componenti da un file di configurazione dell'installazione salvato in precedenza:

  vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"
  

• Usare --config per aggiungere carichi di lavoro e componenti a un'installazione esistente. In questo esempio viene usato il programma di installazione già installato nel computer client. Gli utenti standard con autorizzazioni appropriate possono eseguire il comando modify a livello di codice usando il programma di installazione, ma non possono usare l'opzione --passive o --quiet . Non è possibile avviare il programma di installazione a livello di codice dalla stessa directory in cui risiede il programma di installazione.

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"
  

• Usare --config per configurare il contenuto di un layout:

  vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig" 
  

Uso di winget

Usare lo strumento Gestione pacchetti Windows "winget" per installare o aggiornare Visual Studio a livello di codice nei computer insieme ad altri pacchetti gestiti da winget. Per personalizzare l'installazione e specificare altri carichi di lavoro e componenti, è possibile usare l'opzione winget --override insieme al comando di install winget e passare un file vsconfig esportato come segue:

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config C:\my.vsconfig"

È anche possibile usare winget configure e passare un .yaml file per modificare un'installazione di Visual Studio esistente. Questo approccio usa il provider DSC di Visual Studio PowerShell documentato qui.

Supporto o risoluzione dei problemi

Non sempre tutto funziona correttamente. Se l'installazione di Visual Studio non riesce, vedere Risolvere i problemi di installazione e aggiornamento di Visual Studio per istruzioni dettagliate.

Ecco alcune altre opzioni di supporto:

• È disponibile un'opzione di supporto di chat di installazione (solo inglese) per i problemi correlati all'installazione.
• Segnalare i problemi del prodotto a Microsoft tramite lo strumento Segnala un problema che viene visualizzato sia nel programma di installazione di Visual Studio che nell'IDE di Visual Studio. Se si è un amministratore IT e non si dispone di Visual Studio installato, è possibile inviare commenti e suggerimenti per l'amministratore IT qui.
• Suggerire una funzionalità, tenere traccia dei problemi del prodotto e trovare risposte in Visual Studio Developer Community.

Contenuto correlato

• Guida dell'amministratore di Visual Studio
• Use command-line parameters to install Visual Studio (Usare i parametri della riga di comando per installare Visual Studio)
• Creare un'installazione di rete di Visual Studio
• ID dei carichi di lavoro e dei componenti di Visual Studio