Ejemplos de parámetros de la línea de comandos para la instalación de Visual Studio

  • Artículo

Para ilustrar el uso de los parámetros de línea de comandos para instalar Visual Studio, incluimos aquí varios ejemplos que puede personalizar para satisfacer sus necesidades.

En cada uno de los ejemplos, vs_enterprise.exevs_professional.exe y vs_community.exe representan la edición correspondiente del cargador de arranque de Visual Studio, que es el archivo pequeño (de aproximadamente 1 MB) que inicia el proceso de descarga. Si usa otra edición, sustitúyalo por el nombre del programa previo adecuado.

Todos los comandos requieren elevación administrativa, y se mostrará un mensaje de Control de cuentas de usuario si el proceso no se inicia desde un símbolo del sistema con privilegios elevados.

Puede usar el carácter ^ al final de una línea de comandos para concatenar varias líneas en un solo comando. Como alternativa, puede colocar estas líneas juntas en una sola fila. En PowerShell, el equivalente es el carácter de comilla simple (`).

Para obtener listas de las cargas de trabajo y los componentes que puede instalar a través de la línea de comandos, consulte la página Identificadores de cargas de trabajo y componentes de Visual Studio.

Instalación mediante --installPath junto con el programa previo

  • Instale una instancia mínima de Visual Studio, en la que no haya solicitudes interactivas, pero se muestre el progreso:

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

  • Instale una instancia de escritorio de Visual Studio en modo silencioso, con el paquete de idioma francés, que solo se devuelve cuando el producto está instalado.

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

Actualizar

  • Actualice una instancia de Visual Studio usando la línea de comandos, en la que no hay solicitudes interactivas pero se muestra el progreso. Puede ejecutar estas series de comandos en dos pasos mediante un archivo de arranque que se encuentre en el cliente o en un diseño. Con el primer comando se actualiza el instalador en el cliente y con el segundo se actualiza el producto de Visual Studio. Debe ejecutar estos comandos en un símbolo del sistema con privilegios elevados, ya que la actualización del instalador requiere permisos de administrador. En el ejemplo siguiente se simula la actualización de un cliente mediante un archivo de arranque permanente en el diseño.

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

Como alternativa, también puede actualizar la instancia de Visual Studio en un paso mediante el instalador del cliente. Los usuarios estándar, si se les han concedido los permisosadecuados, pueden ejecutar mediante programación el comando update mediante el instalador, pero no pueden usar el --passive modificador o interruptor--quiet. Observe que el instalador no se puede iniciar mediante programación desde el mismo directorio en el que el instalador resida.

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

Uso de --wait

  • Utilice --wait en scripts o archivos por lotes para esperar que el comando inicial se complete antes de ejecutar el comando siguiente. En el caso de los archivos por lotes, una variable de entorno %ERRORLEVEL% contiene el valor devuelto del comando, tal y como se indica en la página Usar parámetros de la línea de comandos para instalar Visual Studio. Algunas utilidades de comandos requieren parámetros adicionales para esperar la finalización y para obtener el valor devuelto del instalador.

El parámetro --wait solo es compatible con el archivo de arranque.

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

El siguiente comando es un ejemplo de uso de --wait con el comando Start-Process de script de 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()
  • El primer --wait lo usa el archivo de arranque de Visual Studio y el segundo -Wait lo usa "Start-Process" para esperar la finalización. El parámetro -PassThru lo usa Start-Process para usar el código de salida del instalador por su valor devuelto.

Uso de --layout para crear un diseño de red o una caché local

  • Cree un diseño que incluya solo el editor principal de Visual Studio (la configuración mínima de Visual Studio) y el paquete de idioma inglés. Encontrará más ejemplos de creación de diseños en la página Creación de una instalación de red de Visual Studio .

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

Uso de --all para adquirir todo el producto

  • Inicie una instalación interactiva de todos los componentes y las cargas de trabajo que están disponibles en Visual Studio Enterprise Edition:

    vs_enterprise.exe --all

Uso de includeRecommended

  • Instale una segunda instancia con Visual Studio Professional mediante un alias en un equipo con Visual Studio Community Edition ya instalado, con compatibilidad con el desarrollo de Node.js:

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

Uso de --channelURI

Si usa el instalador más reciente, podrá configurar la ubicación en que Visual Studio busca actualizaciones. --channelUri se conoce también como el canal de actualización o la ubicación de origen de las actualizaciones. En la tabla siguiente se proporcionan valores de ejemplo para channelId y channelUri, y lo que significan.

Nombre del canal --channelUri --channelId
Canal actual de Visual Studio 2022 https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Canal LTSC de Visual Studio 2022 17.0 https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Canal de versión preliminar de Visual Studio 2022 https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Canal de versión de Visual Studio 2019 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Canal de versión de Visual Studio 2017 https://aka.ms/vs/15/release/channel VisualStudio.15.Release
Diseño personalizado: canal privado \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (o cualquiera que sea el diseño en el que se basa)

Si decide usar un diseño personalizado como canal de actualización, tenga en cuenta las siguientes directrices:

Uso de remove

  • Quite el componente Herramientas de generación de perfiles de la instancia de Visual Studio instalada predeterminada. En este ejemplo se usa el instalador ya instalado en el equipo cliente. Los usuarios estándar con los permisos adecuados pueden ejecutar mediante programación el comando modify mediante el instalador, pero no se les permite usar el conmutador --passive o --quiet. Observe que el instalador no se puede iniciar mediante programación desde el mismo directorio en el que el instalador resida.

    "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

No se puede usar --remove en el mismo comando que --layout. En otras palabras, no es posible quitar componentes de un diseño.

Uso de --removeOos

Si utiliza el instalador más reciente, podrá modificar una instalación y quitar todos los componentes que han pasado a un estado de sin soporte técnico de la instancia de Visual Studio instalada predeterminada. En este ejemplo se usa el instalador ya instalado en el equipo cliente para configurar el parámetro removeOos. Los usuarios estándar, si se les han concedido permisosadecuados, pueden ejecutar mediante programación el comando modify mediante el instalador, pero no pueden usar el --passive modificador o interruptor --quiet. No puede iniciar el instalador mediante programación desde el mismo directorio en el que reside el instalador.

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

  • Ajuste la configuración de las actualizaciones para quitar de forma persistente todos los componentes que han pasado a un estado sin soporte técnico cada vez que el producto se actualice:

    "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 de path

En todos estos ejemplos se supone que va a instalar un nuevo producto mediante un programa previo.

  • Uso de las rutas de acceso instalar, caché y uso compartido:

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

  • Uso de solo las rutas de acceso instalar y caché:

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

  • Uso de solo las rutas de acceso instalar y uso compartido:

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

  • Uso de solo la ruta de acceso instalar:

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

Uso de exportación

  • Use la exportación para guardar la selección de la instalación. En este ejemplo se usa el instalador ya instalado en el equipo cliente.

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

  • Uso de la exportación para guardar la selección personalizada desde cero. En este ejemplo se usa el instalador ya instalado en el equipo cliente.

    "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 de --config

  • Uso de --config para instalar los componentes y cargas de trabajo desde un archivo de configuración de instalación guardado anteriormente:

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

  • Uso de --config para agregar componentes y cargas de trabajo a una instalación existente. En este ejemplo se usa el instalador ya instalado en el equipo cliente. Los usuarios estándar con los permisos adecuados pueden ejecutar mediante programación el comando modify mediante el instalador, pero no se les permite usar el conmutador --passive o --quiet. No puede iniciar el instalador mediante programación desde el mismo directorio en el que reside el instalador.

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

  • Use --config para configurar el contenido de un diseño:

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

Uso de winget

Use la herramienta "winget" del Administrador de paquetes de Windows para instalar o actualizar Visual Studio mediante programación en las máquinas junto con otros paquetes que administra winget. Para personalizar la instalación y especificar otras cargas de trabajo y componentes, puede usar el conmutador --override de winget junto con el comando install de winget y transferir un archivo vsconfig exportado como este:

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

También puede usar winget configure y pasar un archivo .yaml para modificar una instalación de Visual Studio existente. Este enfoque usa el proveedor DSC de PowerShell de Visual Studio que se documenta aquí.

Soporte técnico o solución de problemas

En ocasiones, algo no sale según lo previsto. Si se produce un error en la instalación de Visual Studio, vea Solución de problemas de instalación y actualización de Visual Studio para obtener instrucciones paso a paso.

Aquí tiene algunas opciones de soporte técnico más:

Contenido relacionado