Use parámetros de línea de comandos para instalar, actualizar y administrar Visual Studio

Al instalar Visual Studio mediante programación o desde un símbolo del sistema, puede usar diversos parámetros de la línea de comandos para controlar o personalizar la instalación a fin de hacer lo siguiente:

  • Iniciar la instalación en el cliente con determinadas opciones y comportamientos preseleccionados.
  • Automatizar el proceso de instalación o actualización.
  • Crear o mantener un diseño de red de los archivos de producto para instalar o actualizar máquinas cliente.

Los siguientes verbos y parámetros de la línea de comandos se pueden utilizar con los siguientes ejecutables o programas:

  • El programa previo de instalación, que es el archivo pequeño que inicia el proceso de descarga y la instalación inicial. Es un archivo pequeño (aproximadamente 1 MB), como vs_enterprise.exe.
  • Con el instalador de Visual Studio que puede que ya esté instalado en el equipo y que está en la carpeta C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Debe iniciar el instalador mediante programación desde un directorio diferente a donde reside el instalador. El instalador se usa normalmente para los comandos de actualización o modificación.
  • Con un comando winget mediante el modificador --override de winget.
  • Con un paquete de actualización del administrador, que está disponible para su descarga desde el Catálogo de Microsoft Update, para actualizar el diseño de red mediante programación. Puede encontrar más información en el artículo Actualizar o modificar el diseño.

No todos los comandos o parámetros funcionan en cada una de estas situaciones. De hecho, se han documentado advertencias o excepciones especiales. Además, en algunos escenarios, es posible que no tenga acceso a todos estos ejecutables descritos anteriormente. Por ejemplo, los equipos cliente solo pueden tener el instalador disponible para la ejecución mediante programación si Visual Studio se ha instalado a través de un diseño.

Puede obtener los programas de arranque de Visual Studio 2019 de la tabla siguiente. Como alternativa, si desea una versión específica de Visual Studio 2019, consulte la página Versiones de Visual Studio 2019. En esta página se incluyen vínculos a los cargadores de arranque de versión fija para la versión y edición elegidas de Visual Studio.

Edición Archivos de arranque
Visual Studio 2019 Enterprise, versión 16.11 vs_enterprise.exe
Visual Studio 2019 Professional, versión 16.11 vs_professional.exe
Visual Studio 2019 Build Tools, versión 16.11 vs_buildtools.exe

Para obtener los archivos de arranque más recientes para Visual Studio 2022 que instalarán siempre la versión más reciente del canal actual, descargue uno de los archivos de la tabla siguiente. Como alternativa, para instalar una versión o canal específicos de Visual Studio 2022, consulte la página Historial de versiones de Visual Studio 2022. En esta página se incluyen vínculos a los cargadores de arranque de versión fija para cada versión de mantenimiento.

Edición Archivos de arranque
Visual Studio 2022 Enterprise vs_enterprise.exe
Visual Studio 2022 Professional vs_professional.exe
Visual Studio 2022 Community vs_community.exe
Visual Studio 2022 Build Tools vs_buildtools.exe

Sugerencia

Si previamente descargó un archivo de programa previo y desea comprobar su versión, aquí se muestra cómo hacerlo. En Windows, abra el Explorador de archivos, haga clic con el botón derecho en el archivo de programa previo, elija Propiedades, seleccione la pestaña Detalles y, luego, fíjese en el número de versión del producto. Para hacer coincidir ese número con una versión de Visual Studio, consulte la tabla que hay en la parte inferior de Versiones de Visual Studio 2019.

Sugerencia

Si previamente descargó un archivo de programa previo y quiere comprobar qué versión instalará, aquí se muestra cómo hacerlo. En Windows, abra el Explorador de archivos, haga clic con el botón derecho en el archivo de arranque, elija Propiedades y, después, la pestaña Detalles. El campo Versión del producto describirá el canal y la versión que el archivo de arranque instalará. El número de versión debe leerse siempre como la "versión de servicio más reciente de lo que se especifica", y el canal será Current a menos que se especifique de forma explícita. Por lo tanto, un archivo de arranque que tenga la versión de producto LTSC 17.0 instalará la versión de servicio más reciente 17.0.x que esté disponible en el canal de LTSC 17.0. Un archivo de arranque que tenga una versión de producto que solo indique Visual Studio 2022 instalará la versión más reciente de Visual Studio 2022 en el canal Current.

Comandos de instalación, actualización, modificación, reparación, desinstalación y exportación y parámetros de línea de comandos

Al invocar el cargador de arranque o el instalador mediante programación para instalar el producto o mantener un diseño:

  • El primer parámetro es el comando (el verbo) que describe la operación que se va a realizar.
  • Los parámetros de línea de comandos opcionales siguientes, que tienen como prefijo dos guiones (--), definen aún más cómo se supone que se va a realizar esa operación.

Ningún parámetro de línea de comandos de Visual Studio distingue entre mayúsculas y minúsculas. En la página Ejemplos de parámetros de la línea de comandos encontrará ejemplos adicionales.

Ejemplo de sintaxis: vs_enterprise.exe [command] <optional parameters>...

Comando Descripción
(en blanco) El comando predeterminado instala el producto y se usa para todas las operaciones de mantenimiento de diseño.
modify Modifica un producto instalado.
update Actualiza un producto instalado.
updateall Actualiza todos los productos instalados en orden secuencial. Funciona con los parámetros --quiet y --passive.
repair Repara un producto instalado.
uninstall Desinstala un producto instalado.
export Exporta la configuración de instalación a un archivo *.vsconfig.

Importante

Al especificar varias cargas de trabajo, componentes o lenguajes, debe repetir el modificador de la línea de comandos --add o --remove para cada elemento.

Parámetros Descripción
--installPath <dir> Para el comando de instalación predeterminado, este parámetro es Opcional y describe dónde se instalará la instancia en la máquina cliente. Para otros comandos, como los de actualización o modificación, este parámetro es Obligatorio e indica el directorio de instalación sobre el que debe actuar la instancia.
--productId <id> Opcional: el ID de la instancia de producto que se modifica y se utiliza con --channelId. El productID es algo parecido a "Microsoft.VisualStudio.Product.Enterprise".
--channelUri Opcional: durante un comando de actualización, puede transferir un nuevo --channelUri para cambiar la ubicación de la configuración de actualización. Se recomienda emparejar con el parámetro --installPath para definir de forma muy explícita qué instancia de Visual Studio se está configurando. Consulte Ejemplos de sintaxis de --channelUri.
--channelId <id> ID del canal, por ejemplo, VisualStudio.17.Release. Consulte Ejemplos de sintaxis de --channelId. channelId es necesario para las operaciones de modificación, junto con --productID o --installPath.
--add <one or more workload or component IDs> Opcional: durante un comando de instalación o modificación, este parámetro repetible especifica uno o varios id. de componente o carga de trabajo que se van a agregar. Se instalan los componentes necesarios del artefacto, pero no los componentes recomendados ni opcionales. Puede controlar otros componentes de forma global mediante los parámetros --includeRecommended o --includeOptional. Para incluir varias cargas de trabajo o componentes, repita el comando --add (por ejemplo, --add Workload1 --add Workload2). Para un control más preciso, puede anexar ;includeRecommended o ;includeOptional al identificador (por ejemplo, --add Workload1;includeRecommended o --add Workload2;includeRecommended;includeOptional). Para obtener más información, consulte la página Identificadores de componente y carga de trabajo.
--all Opcional: durante un comando de instalación o modificación, este parámetro hace que se instalen todas las cargas de trabajo y componentes del producto.
--allWorkloads Opcional: durante un comando de instalación o modificación, este parámetro instala todas las cargas de trabajo y todos los componentes, pero no los componentes opcionales o recomendados.
--includeRecommended Opcional: durante un comando de instalación o modificación, este parámetro incluye los componentes recomendados para las cargas de trabajo instaladas. No incluye los componentes opcionales. Las cargas de trabajo se especifican con --allWorkloads o --add.
--includeOptional Opcional: durante un comando de instalación o modificación, este parámetro incluye los componentes opcionales para las cargas de trabajo instaladas. No incluye los componentes recomendados. Las cargas de trabajo se especifican con --allWorkloads o --add.
--addProductLang <language-locale> Opcional: durante un comando de instalación o modificación, este parámetro repetible especifica los paquetes de idioma de la interfaz de usuario que se deben instalar con el producto. Si no está presente, la instalación usa el paquete de idioma correspondiente a la configuración regional de la máquina. Para obtener más información, consulte la [Lista de configuraciones regionales de idioma]
--remove <one or more workload or component IDs> Opcional: durante un comando de modificación, este parámetro repetible especifica uno o varios id. de componente o carga de trabajo que se van a agregar. Complementa y se comporta de forma similar al parámetro --add.
Sección (#list-of-language-locales) de esta página.
--removeProductLang <language-locale> Opcional: durante un comando de instalación o modificación, este parámetro repetible determina los paquetes de idioma de la interfaz de usuario que se deben quitar del producto. Complementa y se comporta de forma similar al parámetro --addProductLang.
--in <path> Opcional: URI o ruta de acceso a un archivo de respuesta que puede contener valores de configuración.
--quiet Opcional: este parámetro, al usarlo con cualquier comando, impide que se muestre una interfaz de usuario mientras se ejecuta el comando. No está disponible para usar mediante programación por los usuarios estándar, independientemente de cómo se establezca la directiva AllowStandardUserControl.
--passive, -p Opcional: este parámetro hace que la interfaz de usuario se muestre de forma no interactiva. Este parámetro es mutuamente excluyente del parámetro --quiet (y, de hecho, lo invalida). Tampoco está disponible para usar mediante programación por los usuarios estándar, independientemente de cómo se establezca la directiva AllowStandardUserControl.
--norestart Opcional: este parámetro se debe emparejar con los parámetros --passive o --quiet. Durante un comando de instalación, actualización o modificación, agregar el parámetro --norestart retrasa cualquier reinicio necesario.
--force Opcional: este parámetro fuerza el cierre de Visual Studio, incluso si hay algún proceso de Visual Studio en uso. Forzar el cierre de Visual Studio puede provocar la pérdida de trabajo, por lo que debe usarse con precaución.
--installWhileDownloading Opcional: durante un comando de instalación, actualización o modificación, este parámetro permite que Visual Studio descargue e instale el producto en paralelo. Es la experiencia predeterminada.
--downloadThenInstall Opcional: durante un comando de instalación, actualización o modificación, este parámetro obliga a Visual Studio a descargar todos los archivos antes de instalarlos. Es mutuamente excluyente del parámetro --installWhileDownloading.
--nickname <name> Opcional: durante un comando de instalación, este parámetro define el alias que se va a asignar a un producto instalado. El alias no puede tener más de diez caracteres.
--productKey Opcional: durante un comando de instalación, este parámetro define la clave del producto que se va a usar para un producto instalado. La clave de producto se compone de 25 caracteres alfanuméricos en formato xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true Opcional: durante un comando de instalación, actualización o modificación, este parámetro, seguido de true o false, indica al Instalador de Visual Studio si debe quitar todos los componentes instalados que han pasado a un estado no compatible. Este comportamiento es aplicable a un único evento. Si desea que este comportamiento sea persistente, aplique este parámetro al comando modifySettings, que se describe más adelante, o configure la directiva global removeOOS. Es útil para ayudar a mantener la máquina protegida.
--config <path to *.vsconfig file> Opcional: durante una operación de instalación o modificación, puede transferir un archivo de configuración mediante el parámetro --config para especificar las cargas de trabajo, los componentes o las extensiones que se van a agregar en función de un archivo de configuración de instalación guardado anteriormente. Esta operación solo añade; no quita nada especificado en el archivo. Además, los elementos especificados en el archivo de configuración que no se aplican al producto no se agregan. Se recomienda encarecidamente especificar la ruta de acceso completa al archivo de configuración. Durante una operación de exportación, este parámetro determina la ubicación para guardar el archivo de configuración de la instalación.
--allowUnsignedExtensions Opcional: durante la ejecución de una operación de instalación o modificación en un contexto --passive o --quiet mediante un archivo --config, si se especifican extensiones en el archivo de configuración, este parámetro es necesario para cargar extensiones sin una firma digital.
--installerOnly Opcional: durante una operación de instalación o actualización, este parámetro indica al instalador de Visual Studio que se instale solo a sí mismo (el instalador) y no el producto de Visual Studio. Su funcionalidad es equivalente al parámetro --update, pero es más intuitivo. Se ha diseñado para usarse al preparar y configurar máquinas cliente.
--help, --?, -h, -? Muestra una versión sin conexión de esta página.

Comandos de diseño y parámetros de línea de comandos

Todas las operaciones de administración de diseño, como la creación o actualización de un diseño, se ejecutan con el archivo .exe del cargador de arranque y se asume que el comando es el predeterminado de instalación (en blanco). Todas las operaciones de administración de diseño deben comenzar con el parámetro inicial --layout obligatorio. En la tabla siguiente se describen los demás parámetros que puede usar para crear o actualizar un diseño mediante la línea de comandos.

Parámetros de diseño Descripción
--layout <dir> Especifica un directorio para crear o actualizar una caché de instalación sin conexión. Para obtener más información, consulte Crear una instalación sin conexión de Visual Studio 2017.
--lang <one or more language-locales> Opcional: se usa con --layout para preparar una caché de instalación sin conexión con paquetes de recursos con los idiomas especificados. Para obtener más información, consulte la sección Lista de configuraciones regionales de idioma de esta página.
--add <one or more workload or component IDs> Opcional: uno o varios identificadores de componente o carga de trabajo para agregar. Se instalan los componentes necesarios del artefacto, pero no los componentes recomendados ni opcionales. Puede controlar más componentes de forma global mediante --includeRecommended o --includeOptional. Para un control más preciso, puede anexar ;includeRecommended o ;includeOptional al identificador (por ejemplo, --add Workload1;includeRecommended o --add Workload2;includeOptional). Para obtener más información, consulte la página Identificadores de componente y carga de trabajo.
Nota: Si se usa --add, solo se descargan las cargas de trabajo y los componentes especificados y sus dependencias. Si no se especifica --add, todos los componentes y las cargas de trabajo se descargan en el diseño.
--includeRecommended Opcional: incluye los componentes recomendados para cualquier carga de trabajo que se instale, pero no los componentes recomendados. Las cargas de trabajo se especifican con --allWorkloads o --add.
--includeOptional Opcional: incluye los componentes recomendados y opcionales para las cargas de trabajo que se incluyen en el diseño. Las cargas de trabajo se especifican con --add.
--wait Opcional: el proceso esperará hasta que la instalación se complete antes de devolver un código de salida. wait es útil al automatizar las instalaciones donde es necesario esperar a que la instalación finalice para controlar el código de retorno de esa instalación. El parámetro --wait solo se puede transferir al cargador de arranque; el instalador (setup.exe) no lo admite. Es útil cuando se actualizan diseños. Puede encontrar ejemplos adicionales aquí.
--useLatestInstaller Opcional: funcionalidad heredada que solo es aplicable a programas previos de Visual Studio anteriores a abril de 2023. Cualquier lanzamiento realizado después de abril de 2023 usa el instalador más reciente de forma predeterminada. Si este parámetro está presente, la última versión del Instalador de Visual Studio se incluirá en el diseño, aun cuando pertenezca a una versión principal del producto más reciente. El instalador más reciente puede ser útil si desea aprovechar las nuevas características o correcciones de errores que están disponibles en su última versión. Para obtener más información, consulte la documentación Configuración del diseño para usar siempre el instalador más reciente.
--config <path to *.vsconfig file> Opcional: si existe, Visual Studio usará el contenido del archivo de configuración para configurar el diseño. Asegúrese de especificar la ruta de acceso completa al archivo de configuración.
--noWeb Opcional: si están presentes, el programa de instalación de Visual Studio usa los archivos del directorio del diseño para instalar Visual Studio, por lo que no descargará ningún paquete de la web. Si un usuario intenta instalar componentes que no están en el diseño, se produce un error en la instalación. No use este parámetro si intenta implementar un diseño hospedado en un sitio web de una intranet interna. Para obtener más información, consulte Instalación en un cliente que no tiene acceso a Internet.

Importante: Tenga en cuenta que el parámetro --noWeb no evita que el Instalador de Visual Studio en una máquina cliente conectada a Internet busque actualizaciones si el cliente se ha configurado para buscar actualizaciones en los servidores hospedados de Microsoft. En este caso, --noWeb solo impide que el cliente descargue los paquetes del producto.
--verify Opcional: es posible comprobar el contenido del diseño. Se muestra una lista con los archivos dañados o que no se hayan encontrado.
--fix Opcional: es posible comprobar el contenido del diseño. Si faltan archivos o están dañados, se vuelven a descargar. Para corregir el diseño, es necesario tener acceso a Internet.
--clean <one or more paths to catalogs> Opcional: quita las versiones anteriores de los componentes de un diseño que se ha actualizado a una versión más reciente.
Parámetros de diseño avanzados Descripción
--channelId <id> Opcional: identificador del canal correspondiente a la instancia que se va a instalar, representado como VisualStudio.17.Release. channelId es necesario para el comando de instalación y se omite para otros comandos si se especifica --installPath. Vea ejemplos de sintaxis de --channelId.
--channelUri <uri> Opcional: el URI del manifiesto del canal. Este valor rige la ubicación de origen de las actualizaciones y el valor inicial se configura en el archivo response.json del diseño. Consulte los ejemplos de sintaxis de --channelUri para conocer los valores posibles. Si no se quieren las actualizaciones, --channelUri puede apuntar a un archivo no existente (por ejemplo,--channelUri C:\doesntExist.chman). Este parámetro puede usarse para el comando de instalación; se omite para los demás comandos.
--installChannelUri <uri> Opcional: el URI del manifiesto del canal que se va a usar para la instalación. El URI especificado por --channelUri, que debe especificarse cuando se especifica --installChannelUri, se usa para detectar actualizaciones. Este parámetro puede usarse para el comando de instalación; se omite para los demás comandos.
--installCatalogUri <uri> Opcional: el URI del manifiesto del catálogo que se va a usar para la instalación. Si se especifica, el administrador del canal intenta descargar el manifiesto del catálogo de este URI antes de usar el URI en el manifiesto del canal de instalación. Este parámetro se usa para admitir la instalación sin conexión, donde la caché de diseño se crea con el catálogo del producto que ya se ha descargado. Este parámetro puede usarse para el comando de instalación; se omite para los demás comandos.
--productId <id> Opcional: ID del producto de la instancia que se instala. Este parámetro se rellena previamente en condiciones normales de instalación. El productID es algo parecido a "Microsoft.VisualStudio.Product.Enterprise".
--arch all Opcional: de forma predeterminada, los diseños se crean solo con binarios de productos x64. Para incluir binarios de ARM para las cargas de trabajo aplicables junto con los binarios x64 en un diseño, use el parámetro --arch all o --arch *. Para crear un diseño solo de binarios de ARM, use --arch arm64.
--keepLayoutVersion Opcional: es posible aplicar cambios en el diseño sin actualizar la versión del producto incluida en este.
--locale <language-locale> Opcional: cambia el idioma para mostrar de la interfaz de usuario del instalador. La configuración se conservará. Para obtener más información, consulte la sección Lista de configuraciones regionales de idioma de esta página.
--cache Opcional: si está presente, los paquetes se conservarán después de instalarse de cara a posteriores reparaciones. Esta opción invalida la configuración global de directiva que se usará en posteriores instalaciones, reparaciones o modificaciones. La directiva predeterminada es almacenar en caché los paquetes. Se omite para el comando de desinstalación. Para más información, lea cómo deshabilitar o mover la caché de paquetes.
--nocache Opcional: si está presente, los paquetes se eliminarán después de instalarlos o repararlos. Solo se descargarán de nuevo si es necesario y se volverán a eliminar después de su uso. Esta opción invalida la configuración global de directiva que se usará en posteriores instalaciones, reparaciones o modificaciones. La directiva predeterminada es almacenar en caché los paquetes. Se omite para el comando de desinstalación. Para más información, lea cómo deshabilitar o mover la caché de paquetes.
--noUpdateInstaller Opcional: si está presente, impide que el instalador se actualice automáticamente cuando se especifica el modo silencioso. El instalador producirá un error en el comando y devolverá un código de salida distinto de cero si se especifica noUpdateInstaller con el modo silencioso cuando se requiere una actualización del instalador.
--path <name>=<path> Opcional: se usa para especificar rutas de acceso de instalación personalizada para la instalación. Los nombre de ruta de acceso admitidos son uso compartido, caché e instalar.
--path cache=<path> Opcional: usa la ubicación que especifique para descargar los archivos de instalación. Esta ubicación solo puede establecerse la primera vez que se instala Visual Studio. Ejemplo: --path cache="C:\VS\cache"
--path shared=<path> Opcional: contiene los archivos compartidos para las instalaciones en paralelo de Visual Studio. Algunas herramientas y SDK se instalan en una ubicación en esta unidad, mientras que otros pueden invalidar esta configuración e instalarse en otra unidad. Ejemplo: --path shared="C:\VS\shared"

Importante: Solo se puede establecer una vez, la primera que se instale Visual Studio.
--path install=<path> Opcional: equivale a –-installPath. En particular, --installPath "C:\VS" y --path install="C:\VS" son equivalentes. Solo se puede usar uno de estos comandos a la vez.

Comando ModifySettings y parámetros de línea de comandos

Puede modificar la configuración de actualización y configurar mediante programación la ubicación de origen de las actualizaciones para una instancia determinada de Visual Studio. Para ello, use el instalador o el programa de arranque en la máquina cliente y pase el comando modifySettings y el canal de actualización deseado.

Comando Descripción
modifySettings Verbo que se usa para modificar la configuración de actualización de una instancia determinada de Visual Studio.
Parámetros modifySettings Descripción
--installPath <dir> Recomendado para especificar en qué instancia de Visual Studio se debe actuar.
--newChannelUri Obligatorio: URI del manifiesto del canal. Este valor especifica dónde estará la siguiente ubicación de origen de las actualizaciones. Consulte los ejemplos de sintaxis de --channelUri para conocer los valores posibles. Si no se quieren las actualizaciones, --channelUri puede apuntar a un archivo no existente (por ejemplo,--channelUri C:\doesntExist.chman).
--channelUri URI del antiguo manifiesto del canal. Se puede usar si no se conoce --installPath. Debe usarse junto con productID para identificar la instancia correcta en la que se debe actuar.
--productId <id> Debe usarse si se especifica --channelUri y se usa para identificar la instancia correcta en la que se debe actuar. El productID es algo parecido a "Microsoft.VisualStudio.Product.Enterprise".
--quiet Opcional: este parámetro impide que se muestre una interfaz de usuario mientras se ejecuta el comando. No está disponible para usar mediante programación por parte de los usuarios estándar.
--removeOos true Opcional: durante un comando modifySettings, este parámetro (que debe tener la palabra true o false inmediatamente después) indica al instalador de Visual Studio que quite (o que no quite) de forma persistente todos los componentes instalados que hayan pasado a un estado sin soporte técnico. Es útil para ayudar a mantener la máquina protegida.

Ejemplos de sintaxis:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true
 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --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

Comando rollback y parámetros de línea de comandos

Puede revertir la actualización mediante programación si usa el instalador en el equipo cliente y pasa el comando de reversión junto con la instancia de la ruta de instalación.

Comando Descripción
rollback Comando para revertir una instancia determinada de Visual Studio a la actualización instalada previamente. Este comando no funcionará si DisableRollback está habilitado.
Parámetros de rollback Descripción
--installPath <dir> Recomendado para especificar en qué instancia de Visual Studio se debe actuar.

Ejemplos de sintaxis:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

Comandos de actualización de administrador y parámetros de línea de comandos

Puede descargar una actualización de administrador desde el catálogo de Microsoft Update y usarla para actualizar la instalación de cliente o el diseño.

Actualización de un diseño

Si va a actualizar un diseño a una versión determinada de Visual Studio, simplemente descargue la actualización de administrador en el equipo que hospeda el diseño, abra un símbolo del sistema en ese equipo y ejecute un comando como el siguiente: .

visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

Actualización de un cliente

En el cliente, si descarga la actualización de administrador en el directorio de instalación de la máquina cliente, puede hacer doble clic en el archivo para aplicar la actualización. También puede abrir una ventana de comandos y pasar algunos de los parámetros siguientes para cambiar el comportamiento predeterminado.

Configuración de la actualización de administrador en SCCM

Si va a implementar la actualización de administrador a través de Microsoft Endpoint Manager (SCCM), puede modificar el paquete para ajustar el comportamiento mediante los parámetros siguientes. También puede controlar los parámetros mediante un archivo de configuración en la máquina cliente. Para obtener más información, vea Métodos para configurar una actualización de administrador.

Tenga en cuenta que todos los parámetros de actualización de administrador se ejecutan de forma predeterminada en el contexto de "actualización", a menos que se especifique el verbo "diseño".

Parámetros de actualización de administrador Descripción
--installerUpdateArgs [optional parameters] Este parámetro funciona como una "matriz de tránsito" de parámetros específicos que son relevantes para escenarios de actualización de administrador. Los parámetros opcionales que están habilitados para este propósito son los siguientes:

--quiet: esta es la experiencia predeterminada para las actualizaciones de administrador y se muestra aquí para proporcionar información completa.
--passive: este parámetro invalida el parámetro --quiet. Hace que la interfaz de usuario aparezca de forma no interactiva.
--norestart: este parámetro se debe usar junto con --quiet o --passive, y hace que se retrasen los reinicios necesarios.
--noWeb: este parámetro impide que Visual Studio compruebe en Internet si hay actualizaciones para el producto.
--force: este parámetro fuerza el cierre de Visual Studio, incluso si está en uso. Use este parámetro con precaución, ya que podría provocar la pérdida del trabajo. Este parámetro solo se debe usar cuando la actualización del administrador se ejecuta en el contexto del usuario; se ignora si la actualización del administrador se ejecuta en el contexto del sistema.
--installWhileDownloading: este parámetro permite a Visual Studio descargar e instalar el producto en paralelo. Es la experiencia predeterminada para las actualizaciones de administrador y se muestra aquí para proporcionar información completa.
--keepWindowsUpdateOn: este parámetro impide que el instalador desactive el agente de Windows Update en el cliente. Debe usar este parámetro si va a importar una actualización del administrador desde el catálogo a SCCM. Puede que también tenga que establecer que el tiempo de expiración del paquete SCCM sea superior a los 10 minutos predeterminados. Cambiar el tipo de implementación de SCCM para que sea obligatorio hace que este parámetro no sea necesario.
--downloadThenInstall: este parámetro obliga a Visual Studio a descargar todos los archivos antes de instalarlos. Es mutuamente excluyente del parámetro --installWhileDownloading.
--checkPendingReboot La actualización se anulará si hay un reinicio pendiente en la máquina, independientemente de la aplicación que pueda haberlo provocado. El valor predeterminado es no comprobar si hay reinicios pendientes.

Ejemplo de sintaxis para pasar parámetros a una actualización de administrador:

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

Comando removeChannel y parámetros de línea de comandos

Los canales desde los que se puede actualizar se almacenan en la memoria caché del equipo cliente y, con el paso del tiempo, esta puede acabar bastante congestionada. Para quitar canales de actualización manualmente, abra el instalador de Visual Studio, cambie a la pestaña Disponible y haga clic en la X que aparece en la esquina superior derecha de la tarjeta del producto. Puede quitar canales mediante programación (por ejemplo, a ubicaciones de diseño anteriores) mediante el comando removeChannel. Puede ejecutar vswhere mediante programación en el equipo cliente para determinar qué canales hay almacenados en la memoria caché del equipo cliente.

Comando Descripción
removeChannel Comando para quitar un canal de la máquina cliente.
removeChannel parameters Descripción
--channelUri Obligatorio: URI del antiguo manifiesto del canal.
--quiet Opcional: este parámetro impide que se muestre una interfaz de usuario mientras se ejecuta el comando.
--passive Opcional: este parámetro invalida el parámetro --quiet. Hace que la interfaz de usuario aparezca de forma no interactiva.

Ejemplo de sintaxis:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

Uso de winget para instalar o modificar Visual Studio

La herramienta "winget" del Administrador de paquetes de Windows se puede usar para instalar o actualizar Visual Studio mediante programación en los equipos junto con otros paquetes que winget administra.

De forma predeterminada, winget solo instala la carga de trabajo principal de Visual Studio.

winget install --id Microsoft.VisualStudio.2022.Community

Con todo, si desea personalizar la instalación y especificar más cargas de trabajo y componentes para obtenerlos durante la instalación inicial, puede usar el modificador --override de winget junto con el comando de install de winget y pasar un archivo vsconfig exportado que contenga las cargas de trabajo y los componentes que quiera agregar:

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

Por supuesto, también puede incluir componentes directamente durante la instalación inicial, de la siguiente manera:

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Si ya tiene Visual Studio instalado en el equipo, se puede usar el comando configure de winget junto con el proveedor de DSC de Visual Studio PowerShell, un archivo .yaml y un archivo .vsconfig para agregar componentes a una instalación de Visual Studio existente. El comando configure de winget actúa básicamente como una operación de "modificación" de Visual Studio.

No se puede usar ni el modificador --override ni el proveedor de DSC de Visual Studio junto con el comando upgrade de winget, ya que upgrade actúa básicamente como una operación de "actualización" de Visual Studio e instala la versión más reciente de los componentes que ya se han seleccionado. No se pueden agregar componentes a través de una actualización. Para ello, deberá usar el comando configure de winget.

Cabe decir que las operaciones del Instalador de Visual Studio requieren privilegios de administrador actualmente, por lo que winget le pedirá que aumente los privilegios si es necesario para que el comando se complete. Además, actualmente no es posible usar winget para instalar varias ediciones (es decir, SKU diferentes) o varias instancias de la misma SKU a la vez en un equipo cliente. Por último, Visual Studio se debe cerrar si se va a configurar (modificar) para agregar componentes, o bien a actualizar a la versión más reciente.

Lista de los id. de carga de trabajo y los id. de componente

Para una lista de los identificadores de componente y carga de trabajo ordenados por producto de Visual Studio, consulte la página Identificadores de componente y carga de trabajo de Visual Studio.

Lista de configuraciones regionales de idioma

Idioma-configuración regional Lenguaje
Cs-cz Checo
De-de Alemán
En-us Inglés
Es-es Español
Fr-fr Francés
It-it Italiano
Ja-jp Japonés
Ko-kr Coreano
Pl-pl Polaco
Pt-br Portugués (Brasil)
Ru-ru Ruso
Tr-tr Turco
Zh-cn Chino (simplificado)
Zh-tw Chino (tradicional)

Códigos de error

En función del resultado de la operación, la variable de entorno %ERRORLEVEL% se establece en uno de los valores siguientes:

Valor Resultado
0 Operación completada correctamente
740 Elevación necesaria
1001 El proceso del instalador de Visual Studio está en ejecución
1003 Visual Studio está en uso
1602 Operación cancelada
1618 Otra instalación en ejecución
1641 Operación completada correctamente y reinicio empezado
3010 Operación completada correctamente, pero la instalación requiere reiniciar el equipo para que se pueda usar
5003 Error del programa previo al intentar descargar el instalador
5004 Operación cancelada
5005 Error de análisis de línea de comandos del programa previo
5007 Operación bloqueada: el equipo no cumple los requisitos
8001 Error de comprobación de la máquina de ARM
8002 Error de comprobación previa de descarga en segundo plano
8003 Error seleccionable sin soporte técnico
8004 Error de directorio de destino
8005 Comprobación del error de las cargas de origen
8006 Procesos de Visual Studio en ejecución
8010 No se admite el sistema operativo. Consulte los requisitos del sistema
-1073720687 Error de conectividad
-1073741510 El usuario o un proceso externo ha finalizado el Instalador de Microsoft Visual Studio
Otros
(por ejemplo:
-1, 1, 1603)
Condición de error: consulte los registros para obtener más información

Cada operación genera varios archivos de registro en el directorio %TEMP% que indican el progreso de la instalación. Ordene la carpeta por fecha y busque los archivos que empiecen por dd_bootstrapper, dd_client y dd_setup para el programa previo, la aplicación del instalador y el motor de configuración, respectivamente.

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: