Uso de 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:
- Inicie la instalación en el cliente con determinadas opciones y comportamientos preseleccionados.
- Automatice el proceso de instalación o actualización.
- Cree o mantenga un diseño de red de los archivos de producto para instalar o actualizar máquinas cliente.
Los siguientes verbos y parámetros de línea de comandos se pueden usar con los siguientes archivos ejecutables o programas:
- El programa de arranque de instalación, que es un archivo pequeño (~1 MB) (por ejemplo, vs_enterprise.exe) que inicia el proceso de descarga y la instalación inicial.
- El instalador de Visual Studio que puede que ya esté instalado en el equipo y se encuentra 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 y se documentan advertencias o excepciones especiales. Además, en algunos escenarios es posible que no tenga acceso a todos estos ejecutables descritos anteriormente. Por ejemplo, es posible que las máquinas cliente solo tengan el instalador disponible para la ejecución mediante programación si Visual Studio se instaló 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. Esta página contiene vínculos a los instaladores de versión fija para la versión y edición elegidas de Visual Studio.
| Edición | Cargador 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 específica o un canal específico de Visual Studio 2022, consulte la página historial de versiones de Visual Studio 2022. Esta página tiene vínculos a los cargadores de arranque de versión no editable para cada lanzamiento de servicio.
| Edición | Cargador de arranque |
|---|---|
| Visual Studio 2022 Enterprise | vs_enterprise.exe |
| Visual Studio 2022 Professional | vs_professional.exe |
| Visual Studio 2022 Community | vs_community.exe |
| Herramientas de compilación de Visual Studio 2022 | vs_buildtools.exe |
Sugerencia
Si anteriormente descargó un archivo bootstrap y quiere comprobar su versión, aquí te mostramos cómo. 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 la página Versiones de Visual Studio 2019.
Sugerencia
Si anteriormente descargó un archivo bootstrapper y quiere comprobar qué versión instalará, aquí se explica cómo. En Windows, abra el Explorador de archivos, haga clic con el botón derecho en el archivo de arranque, elija Propiedades y, a continuación, elija la pestaña Detalles. El campo Versión del producto describirá el canal y la versión que instalará el archivo de arranque. El número de versión siempre debe leerse como "versión de mantenimiento más reciente de lo que se especifica" y el canal es Current a menos que se especifique explícitamente. 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.
Instalar, actualizar, modificar, reparar, desinstalar y exportar comandos y parámetros de línea de comandos
Al invocar el cargador de arranque de Visual Studio o el instalador de forma programática para instalar el producto o para mantener una disposición:
- El primer parámetro es el comando (el verbo) que describe la operación que se va a realizar.
- Los parámetros de la línea de comandos opcionales posteriores, todos prefijos por dos guiones (--), definen aún más cómo se supone que se produce esa operación.
Todos los parámetros de la línea de comandos de Visual Studio son insensibles a mayúsculas y minúsculas, y se pueden encontrar más ejemplos en la página de ejemplos de parámetros de línea de comandos .
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 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 instala la instancia en el equipo cliente. Para otros comandos como update o modify, este parámetro es Required y denota el directorio de instalación para que la instancia actúe. |
--productId <id> |
Opcional: el identificador de la instancia de producto que ha sido modificada y se utiliza con --channelId. El productID es algo parecido a "Microsoft.VisualStudio.Product.Enterprise". |
--channelUri |
Opcional: Durante un comando de actualización, puede introducir un nuevo --channelUri para cambiar la ubicación de las configuraciones de actualización. Se recomienda emparejar el parámetro --installPath para que quede explícito qué instancia de Visual Studio se está configurando. Consulte ejemplos de sintaxis de --channelUri |
--channelId <id> |
Identificador 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 identificadores de carga de trabajo o componente que se van a agregar. Los componentes necesarios del artefacto se instalan, pero no los componentes recomendados o opcionales. Puede controlar otros componentes globalmente mediante parámetros --includeRecommended o --includeOptional. Para incluir varias cargas de trabajo o componentes, repita el comando --add (por ejemplo, --add Workload1 --add Workload2). Para el control más específico, 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 una instalación o modificación de comandos, 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 componentes, pero sin componentes recomendados u opcionales. |
--includeRecommended |
opcional: durante un comando de instalación o modificación, este parámetro incluye los componentes recomendados para cualquier carga de trabajo que se instale. No incluye los componentes opcionales. Las cargas de trabajo se especifican con --allWorkloads o --add. Tenga en cuenta que, al utilizar el parámetro --includeRecommended, habilitará el cuadro de diálogo Configuración de actualización para "agregar componentes recomendados a las cargas de trabajo instaladas durante la actualización". Consulte Personalizar la configuración de actualización para cambiar esta configuración. |
--includeOptional |
opcional: durante una instalación o modificación de comandos, este parámetro incluye los componentes opcionales de 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 instalar o modificar, este parámetro repetible especifica los paquetes de idiomas para 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 del equipo. 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 identificadores de carga de trabajo o componente que se van a quitar. 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 una instalación o modificación de un comando, 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: se usa con cualquier comando, este parámetro impide que se muestre cualquier 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 de (y, de hecho, invalida) el parámetro --quiet. Tampoco está disponible para que los usuarios estándar lo usen mediante programación, independientemente de cómo se establezca la directiva AllowStandardUserControl. |
--norestart |
opcional: este parámetro debe emparejarse 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 obliga a Visual Studio a cerrarse incluso si se usa algún proceso de Visual Studio. Forzar que Visual Studio se cierre podría provocar la pérdida de trabajo, por lo que debe usarlo con precaución. |
--installWhileDownloading |
opcional: durante un comando de instalación, actualización o modificación, este parámetro permite a Visual Studio descargar e instalar 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 para asignar a un producto instalado. El alias no puede tener más de 10 caracteres. |
--productKey |
opcional: durante un comando de instalación, este parámetro define la clave de producto que se usará para un producto instalado. La clave de producto se compone de 25 caracteres alfanuméricos con el 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 se deben quitar todos los componentes instalados pasados a un estado fuera de soporte técnico. Este comportamiento es aplicable a un único evento. Si desea que este comportamiento sea persistente, aplique este parámetro al comando modifySettings, descrito más adelante o configure la directiva global removeOOS. Útil para ayudar a mantener la máquina segura. |
--config <path to *.vsconfig file> |
Opcional: Durante una operación de instalación o modificación, puede pasar un archivo de configuración utilizando el parámetro --config para especificar las cargas de trabajo, los componentes o las extensiones que se añadirán según un archivo de configuración de instalación guardado anteriormente. Esta operación es solo aditiva; no elimina nada que no esté 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 instalación. |
--allowUnsignedExtensions |
Opcional: durante la ejecución de una operación de instalación o modificación en un contexto de --passive o --quiet mediante un archivo de --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 instale únicamente el instalador y no el producto de Visual Studio. Su funcionalidad es equivalente al parámetro --update, pero más intuitivo. Está diseñado para usarse al preparar y preconfigurar 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ños, como la creación o actualización de un diseño, se ejecutan con el exe del cargador de arranque y se supone que el comando es el valor predeterminado de instalación (en blanco). Todas las operaciones de administración de diseño deben comenzar con el parámetro inicial requerido --layout. 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, vea Creación de una instalación basada en red de Visual Studio. |
--lang <one or more language-locales> |
opcional: se utiliza con --layout para preparar una caché de instalación sin conexión con paquetes de recursos en uno o más 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. Los componentes necesarios del artefacto se instalan, pero no los componentes recomendados o opcionales. Puede controlar más componentes globalmente mediante --includeRecommended o --includeOptional. Para el control más específico, 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 las cargas de trabajo instaladas, pero no los componentes opcionales. Las cargas de trabajo se especifican con --allWorkloads o --add. |
--includeOptional |
opcional: incluye los componentes opcionales recomendados y para cualquier carga de trabajo que se incluya en el diseño. Las cargas de trabajo se especifican con --add. |
--wait |
opcional: el proceso espera hasta que se complete la instalación antes de devolver un código de salida. wait resulta útil al automatizar las instalaciones en las que hay que esperar a que finalice la instalación para controlar el código devuelto de esa instalación. El parámetro --wait solo se puede pasar al programa de arranque; el instalador (setup.exe) no lo admite. Resulta útil al actualizar diseños. Puede encontrar más ejemplos aquí. |
--useLatestInstaller |
Opcional: funcionalidad obsoleta que solo es aplicable a los instaladores de Visual Studio anteriores a abril de 2023. Cualquier cosa enviada después de abril de 2023 usa el instalador más reciente de forma predeterminada. Si este parámetro está presente, la versión más reciente del instalador de Visual Studio se incluye en el diseño, incluso si pertenece a una versión principal más reciente del producto. 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 versión más reciente. 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 está presente, Visual Studio usa 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á presente, el programa de instalación de Visual Studio usa los archivos del directorio de diseño para instalar Visual Studio y no descarga 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 intranet interno. Para obtener más información, consulte Instalación en un cliente que no tiene acceso a Internet. importante: el parámetro --noWeb no impide que el instalador de Visual Studio en un equipo cliente conectado a Internet compruebe si el cliente está configurado para examinar los servidores hospedados por Microsoft para obtener actualizaciones. En este caso, --noWeb simplemente impide que el cliente descargue los paquetes de productos. |
--verify |
opcional: compruebe el contenido de un diseño. Se muestran los archivos dañados o que faltan. |
--fix |
opcional: compruebe el contenido de un diseño. Si hay archivos corruptos o faltantes, se vuelven a descargar. El acceso a Internet es necesario para corregir un diseño. |
--clean <one or more paths to catalogs> |
Opcional: Elimina las versiones antiguas de los componentes de un diseño que se actualiza a una versión más reciente. |
| parámetros de diseño avanzado | Descripción |
|---|---|
--channelId <id> |
Opcional: El identificador del canal para 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. Refiérase a los ejemplos de sintaxis de --channelUri para identificar los valores posibles. Si no se quieren actualizaciones, --channelUri puede apuntar a un archivo no existente (por ejemplo, --channelUri C:\doesntExist.chman). Este parámetro se puede usar para el comando install; otros comandos lo omiten. |
--installChannelUri <uri> |
Opcional: el URI del manifiesto del canal que se va a usar para la instalación. El URI especificado por --channelUri (que se debe especificar cuando se especifica --installChannelUri) se usa para detectar actualizaciones. Este parámetro se puede usar para el comando install; otros comandos lo omiten. |
--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 memoria caché de diseño se crea con el catálogo de productos ya descargado. Este parámetro se puede usar para el comando install; otros comandos lo omiten. |
--productId <id> |
opcional: el identificador del producto para la instancia instalada. Este parámetro se rellena previamente en condiciones de instalación normales. El productID es algo parecido a "Microsoft.VisualStudio.Product.Enterprise". |
--arch all |
Opcional: de forma predeterminada, los diseños se crean solo con archivos binarios de productos x64. Para incluir archivos binarios de ARM para cargas de trabajo aplicables junto con los archivos 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: aplique cambios en el diseño sin actualizar la versión del producto incluida en el diseño. |
--locale <language-locale> |
Opcional: Cambie el idioma de visualización de la interfaz de usuario para el instalador en sí. 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. Esto invalida la configuración de directiva global que se usará para las posteriores instalaciones, reparaciones o modificaciones. La directiva predeterminada es almacenar en caché los paquetes. Esto se omite para el comando uninstall. Lea sobre cómo desactivar o mover la memoria caché de paquetes para obtener más información. |
--nocache |
Opcional: si está presente, los paquetes se eliminarán después de instalarse o repararse. Solo se descargarán si es necesario y se eliminarán de nuevo después de su uso. Esto invalida la configuración de directiva global que se usará para las posteriores instalaciones, reparaciones o modificaciones. La directiva predeterminada es almacenar en caché los paquetes. Esto se omite para el comando uninstall. 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 instalación personalizadas 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 especificada para descargar archivos de instalación. Esta ubicación solo se puede establecer la primera vez que se instala Visual Studio. Ejemplo: --path cache="C:\VS\cache" |
--path shared=<path> |
opcional: contiene archivos compartidos para instalaciones de Visual Studio en paralelo. Algunas herramientas y SDK se instalan en una ubicación en esta unidad, mientras que otras podrían invalidar esta configuración e instalar en otra unidad. Ejemplo: --path shared="C:\VS\shared" Importante: solo se puede establecer una vez y la primera vez que se instala Visual Studio. |
--path install=<path> |
opcional: equivalente a –-installPath. En concreto, --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 programáticamente la ubicación de origen de las actualizaciones para una instancia determinada de Visual Studio utilizando el instalador o el programa de arranque en el equipo cliente e introduciendo el comando modifySettings junto con el canal de actualización deseado.
| Comando | Descripción |
|---|---|
modifySettings |
Verbo usado 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 ejemplos de sintaxis de de --channelUri para obtener valores posibles. Si no se quieren 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 sobre la que actuar. |
--productId <id> |
Se debe usar si se especifica --channelUri y se usa para identificar la instancia correcta sobre la que actuar. El productID es algo parecido a "Microsoft.VisualStudio.Product.Enterprise". |
--includeRecommended |
Opcional: durante un comando modifySettings, este parámetro (que debe tener la palabra true o false inmediatamente después de él) indica al instalador de Visual Studio que deshabilite la funcionalidad "agregar componentes recomendados para cargas de trabajo instaladas en la actualización" en el cuadro de diálogo Configuración de actualización. |
--quiet |
opcional: este parámetro impide que se muestre cualquier 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. Útil para ayudar a mantener la máquina segura. |
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 de rollback y parámetros de línea de comandos
A partir de Visual Studio 2022, puede revertir una actualización mediante programación mediante el instalador en el equipo cliente y pasar el comando de reversión junto con la instancia de ruta de instalación.
| Comando | Descripción |
|---|---|
rollback |
Comando para revertir una instancia determinada de Visual Studio a la actualización instalada anteriormente. Este comando no funcionará si el 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"
Comando de Administrator Update 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 vas a actualizar un layout a una versión determinada de Visual Studio, simplemente descarga la actualización para administradores en el equipo que alberga el layout, abre una ventana de comandos en ese equipo y ejecuta un comando parecido al 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 del 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 del administrador en SCCM
Si va a implementar la actualización del 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 a través de un archivo de configuración en el equipo cliente. Para obtener más información, consulte métodos de 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: --quiet: esta es la experiencia predeterminada para las actualizaciones de administrador y se muestra aquí para su integridad. --passive: este parámetro invalida el parámetro --quiet. Hace que la interfaz de usuario aparezca de forma no interactiva. --norestart: este parámetro debe usarse junto con --quiet o --passive y hace que se retrase cualquier reinicio necesario. --noWeb: este parámetro impide que Visual Studio compruebe en Internet las actualizaciones del producto. --force: este parámetro obliga a Visual Studio a cerrarse incluso si Visual Studio está en uso. Use este parámetro con precaución, ya que puede provocar la pérdida de trabajo. Este parámetro solo se debe usar cuando se ejecuta la actualización del administrador en el contexto del usuario; se omite si la actualización de administrador se ejecuta en el contexto del sistema. --installWhileDownloading: este parámetro permite que Visual Studio descargue e instale el producto en paralelo. Es la experiencia predeterminada para las actualizaciones de administrador y se muestra aquí para mayor integridad. --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 de administrador desde el catálogo a SCCM. También es posible que tenga que establecer el tiempo de espera del paquete SCCM para que sea mayor que el valor predeterminado de 10 minutos. Cambiar el tipo de implementación scCM a Obligatorio hace que este parámetro sea innecesario.--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 haber causado. 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
Quitar el comando de canal y los parámetros de línea de comandos
Los canales que están disponibles para actualizarse se almacenan en caché en el cliente y, con el tiempo, pueden desordenar las cosas. 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 eliminar canales mediante programación (por ejemplo, antiguas ubicaciones de diseño) usando el comando removeChannel. Puede ejecutar vswhere mediante programación en el equipo cliente para determinar qué canales se almacenan en caché en el 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 cualquier 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 simplemente 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, como este:
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 esencialmente como una operación "modificar" de Visual Studio. Consulte cómo crear un archivo de configuración de WinGet para obtener información sobre cómo crear una configuración de winget.
No es posible usar el interruptor de --override o el proveedor de DSC de Visual Studio junto con el comando upgrade de winget, ya que upgrade esencialmente actúa como una operación de "actualización" de Visual Studio e instala la versión más reciente de los componentes que ya has seleccionado. No se pueden agregar componentes a través de una actualización o mejora. Para ello, deberá usar el comando configure de winget.
Tenga en cuenta que actualmente las operaciones del Instalador de Visual Studio requieren privilegios de administrador, por lo que winget le pedirá que eleva los privilegios si es necesario para completar el comando. Además, actualmente no es posible usar winget para instalar varias ediciones (es decir, SKU diferentes) o varias instancias de la misma SKU al mismo tiempo en un equipo cliente. Por último, Visual Studio debe cerrarse si va a configurar (modificar) para agregar componentes o actualizarlos a la versión más reciente.
Lista de identificadores de carga de trabajo e identificadores de componente
Para obtener una lista de identificadores de carga de trabajo y componente ordenados por producto de Visual Studio, consulte la página identificadores de carga de trabajo y componente de Visual Studio.
Lista de configuraciones regionales de idioma
| Idioma-configuración regional | Idioma |
|---|---|
| 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
Según el resultado de la operación, la variable de entorno %ERRORLEVEL% se establece en uno de los siguientes valores:
| Valor | Resultado |
|---|---|
| 0 | Operación completada correctamente |
| 740 | Elevación necesaria |
| 1001 | El proceso del instalador de Visual Studio se está ejecutando |
| 1003 | Visual Studio está en uso |
| 1602 | Se canceló la operación |
| 1618 | Otra instalación en ejecución |
| 1641 | La operación se completó correctamente y se inició el reinicio |
| 3010 | La operación se completó correctamente, pero la instalación requiere reiniciar antes de que se pueda usar. |
| 5003 | El bootstrapper no pudo descargar el instalador |
| 5004 | Se canceló la operación |
| 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 | Error al verificar las cargas de origen |
| 8006 | Procesos de Visual Studio en ejecución |
| 8010 | El sistema operativo no es compatible. Consulte los requisitos del sistema |
| -1073720687 | Error de conectividad |
| -1073741510 | El usuario o un proceso externo ha finalizado el Instalador de Microsoft Visual Studio |
| Otro (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 archivos que comiencen por dd_bootstrapper, dd_clienty dd_setup para el gestor de arranque, la aplicación instaladora y el motor de instalación, respectivamente.
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 de chat de instalación de (solo inglés) para cuestiones relacionadas con la instalación.
- Informe los problemas del producto mediante la herramienta Notificar un problema que aparece tanto en el instalador de Visual Studio como 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.