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

  • Articolo

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 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

Aggiornamento

  • 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.

Nome canale --channelUri --channelId
Canale corrente di Visual Studio 2022 https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Canale LTSC di Visual Studio 2022 17.0 https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Canale di Visual Studio 2022 Preview https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Canale versione di Visual Studio 2019 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Canale versione di Visual Studio 2017 https://aka.ms/vs/15/release/channel VisualStudio.15.Release
Layout personalizzato - Canale privato \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (o qualsiasi altro layout basato su)

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

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 providerDSC 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:

Contenuto correlato