Compartir vía

Ejemplos de parámetros de 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 ejemplo, vs_enterprise.exe, vs_professional.exey vs_community.exe representan la edición correspondiente del iniciador de Visual Studio, que es el archivo pequeño (~ 1MB) 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 workloads y los componentes que puede instalar mediante la línea de comandos, consulte la página de identificadores de carga de trabajo y componentes de Visual Studio .

Instalación mediante --installPath y --add junto con el cargador de arranque

  • Instale una instancia mínima de Visual Studio, sin avisos interactivos, pero se muestra el progreso:

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

  • Instale una instancia de escritorio de Visual Studio de forma silenciosa, con el paquete de idioma francés, devolviendo solo 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 a través de la línea de comandos con el progreso mostrado y sin avisos interactivos. 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. El primer comando actualiza el instalador en el cliente y el segundo comando actualiza el producto de Visual Studio. Debido a que la actualización del instalador requiere permisos de administrador, debe ejecutar estos comandos en un símbolo del sistema con privilegios elevados. 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 en el cliente. Los usuarios estándar, si se les han concedido los permisos adecuados, pueden ejecutar el comando de actualización programáticamente mediante el instalador, pero no pueden usar el modificador --passive o --quiet. Tenga en cuenta que 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" update --passive --norestart --installPath "C:\installPathVS"

Uso de --wait

  • Use --wait en archivos por lotes o scripts para esperar a que se complete el comando inicial antes de ejecutar el comando siguiente. Para los archivos por lotes, una variable de entorno de %ERRORLEVEL% contiene el valor devuelto del comando, tal como se documenta en la página Usar parámetros de línea de comandos para instalar Visual Studio. Algunas utilidades de comandos requieren otros parámetros para esperar la finalización y 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 comando siguiente es un ejemplo de uso de --wait con el comando script de 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()
  • 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 es utilizado por Start-Process para emplear el código de salida del instalador como 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ás mínima de Visual Studio) y el paquete de idioma inglés. Puede encontrar más ejemplos de creación de diseños en la página Crear 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 todas las cargas de trabajo y componentes disponibles en la edición Visual Studio Enterprise:

    vs_enterprise.exe --all

Uso de includeRecommended

  • Instale una segunda instancia de Visual Studio Professional con 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. El --channelUri se conoce 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 vista previa 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 predeterminada de Visual Studio instalada. En este ejemplo se usa el instalador ya instalado en el equipo cliente. Los usuarios estándar con los permisos adecuados pueden ejecutar de forma programática el comando modify mediante el instalador, pero no se les permite usar las opciones --passive o --quiet. Tenga en cuenta que 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" ^
--remove Microsoft.VisualStudio.Component.DiagnosticTools ^
--passive

No puede usar --remove en el mismo comando que --layout. Es decir, no es posible quitar componentes de un diseño.

Uso de --removeOos

Con el instalador más reciente, puede modificar una instalación y quitar todos los componentes de que han pasado a un estado fuera de soporte técnico de la instancia predeterminada de Visual Studio instalada. En este ejemplo se usa el instalador ya instalado en el equipo cliente para configurar la configuración 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 se 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 actualización para quitar de forma persistente todos los componentes pasados a un estado fuera de soporte técnico cada vez que se actualizan los productos:

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

  • Utilice las rutas de acceso de instalación, caché y compartidas.

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

  • Use solo las rutas de acceso de instalación y caché:

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

  • Use solo las rutas de acceso de instalación y compartidas:

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

  • Use solo la ruta de instalación.

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

Cómo usar la función de exportación

  • Use export para guardar la selección de una 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"

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

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

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

  • Use --config para agregar cargas de trabajo y componentes 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 el comando modify mediante programación con el instalador, pero no pueden usar el interruptor de --passive o --quiet. No se 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

Usa el Administrador de paquetes de Windows "winget" para instalar o actualizar Visual Studio de manera programática en las máquinas junto con otros paquetes gestionados por winget. Para personalizar la instalación y especificar otras cargas de trabajo y componentes, puede usar el modificador --override de winget junto con el comando install de winget y pasar 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

A veces, las cosas pueden ir mal. Si se produce un error en la instalación de Visual Studio, consulte Solución de problemas de instalación y actualización de Visual Studio para obtener instrucciones paso a paso.

Estas son algunas opciones de soporte técnico más:

  • Utilice la opción de soporte técnico (solo inglés) de chat de instalación de en para problemas relacionados con la instalación.
  • Puede notificarnos problemas del producto a través de la herramienta Notificar un problema que aparece en el instalador y en el IDE de Visual Studio. Si es administrador de TI y no tiene Visual Studio instalado, puede enviar comentarios del administrador de TI.
  • Sugerir una característica, realizar un seguimiento de los problemas del producto y encontrar respuestas en el Visual Studio Developer Community.

Contenido relacionado