Compartir a través de

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 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 ejecutar comandos de forma no interactiva, puede usar--passive o --quiet. Para obtener más información sobre estos parámetros, consulte los comandos y la página de parámetros de línea de comandos.

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, en la que no hay solicitudes interactivas 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 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. 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 del 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. 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. 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 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

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í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 de forma programática el comando modify mediante el instalador, pero no se les permite usar las opciones --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 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"

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

  • 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 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 de forma programática el comando modify mediante el instalador, pero no se les permite usar las opciones --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

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:

  • 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.
  • Sugiera una característica, realice el seguimiento de los problemas del producto y encuentre respuestas en la comunidad de desarrolladores de Visual Studio.

Contenido relacionado