Condividi tramite

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

  • Articolo

Per illustrare come usare i parametri della riga di comando per installare Visual Studio, ecco alcuni esempi che è possibile personalizzare in base alle proprie esigenze.

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 (~ 1 MB) 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.

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

Per eseguire comandi in modo non interattivo, è possibile usare--passive o --quiet. Per altre informazioni su questi parametri, vedere la pagina comandi e parametri della riga di comando.

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 usando --installPath e --add insieme con il bootstrapper

  • 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

  • Installare un'istanza desktop di Visual Studio in modalità silenziosa, con il pacchetto lingua francese, tornando solo quando il prodotto è stato installato.

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

Aggiornare

  • 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 bootstrapper sempre aggiornato 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 sono stati concessi 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 variabile di ambiente %ERRORLEVEL% contiene il valore restituito del comando, come illustrato 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 parametro --wait è 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 dell'uso di --wait con il comando script di PowerShell Start-Process:

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

o

 $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 parametro -PassThru viene utilizzato da Start-Process per ottenere il codice di uscita del programma di installazione come 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

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

    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. Il --channelUri è 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 di rilascio di Visual Studio 2019 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Canale di rilascio 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 in base al layout utilizzato)

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

Usando il programma di installazione più recente, è possibile modificare un'installazione e rimuovere tutti i componenti che hanno eseguito la transizione a uno stato non supportato 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 sono stati concessi 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 condivisione:

    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"

Utilizzare l'esportazione

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

  • Utilizzare l'esportazione per salvare da zero una selezione personalizzata. 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 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:\VS" --config "C:\my.vsconfig"

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

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

Utilizzo di winget

Usare il Gestione Pacchetti di Windows strumento denominato "winget" per installare o aggiornare automaticamente Visual Studio sui computer insieme ad altri pacchetti gestiti da winget. Per personalizzare l'installazione e specificare altri carichi di lavoro e componenti, è possibile usare l'opzione --override winget insieme al comando install winget e passare un file vsconfig esportato simile al seguente:

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

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

Supporto o risoluzione dei problemi

A volte, le cose possono andare storte. Se l'installazione di Visual Studio non riesce, vedere Risolvere i problemi di installazione e aggiornamento di Visual Studio per indicazioni dettagliate.

Ecco alcune altre opzioni di supporto:

Contenuto correlato