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. Tenga en cuenta que, mediante el parámetro --includeRecommended, habilitará el cuadro de diálogo Actualizar Configuración para "agregar componentes recomendados para cargas de trabajo instaladas al actualizar". Consulte Personalizar la configuración de actualización para cambiar esta configuración. |
--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". |
--includeRecommended |
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 deshabilite la funcionalidad "Agregar componentes recomendados para cargas de trabajo instaladas en actualización" en el cuadro de diálogo Configuración de actualización. |
--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
A partir de Visual Studio 2022, puede revertir una 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. 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 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:
- Se ofrece una opción de soporte técnico de chat de instalación para incidencias relacionadas con la instalación (solo en inglés).
- 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 de administrador de TI aquí.
- Sugiera una característica, realice el seguimiento de los problemas del producto y encuentre respuestas en la comunidad de desarrolladores de Visual Studio.