Compartir a través de

Opciones de línea de comandos de mantenimiento del paquete del sistema operativo DISM (.cab o .msu)

  • Artículo

Use DISM con archivos cabinet (.cab) de Windows o archivos de Instalador independiente de Windows Update (.msu) para instalar o quitar actualizaciones, paquetes de idioma y para habilitar o deshabilitar características de Windows. Las características son componentes opcionales para el sistema operativo principal.

Sintaxis

DISM.exe {/Image:<path_to_image_directory> | /Online} [dism_global_options] {servicing_option} [<servicing_argument>]

Las siguientes opciones de mantenimiento de paquetes del sistema operativo están disponibles para una imagen sin conexión:

DISM.exe /Image:<path_to_image_directory> [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

Las siguientes opciones de mantenimiento de paquetes del sistema operativo están disponibles para un sistema operativo en ejecución:

DISM.exe /Online [/Get-Packages | /Get-PackageInfo | /Add-Package | /Remove-Package ] [/Get-Features | /Get-FeatureInfo | /Enable-Feature | /Disable-Feature ] [/Cleanup-Image]

/Get-Help /?

Cuando se usa inmediatamente después de una opción de línea de comandos de mantenimiento de paquetes, se muestra información sobre la opción y los argumentos.

Es posible que haya temas adicionales disponibles cuando se especifica una imagen.

Sintaxis:

Dism /Get-Help

Ejemplos:

Dism /Image:C:\test\offline /Add-Package /?

Dism /Online /Get-Packages /?

/Get-Packages

Muestra información básica sobre todos los paquetes de la imagen. Use el argumento /Format:Table o /Format:List para mostrar la salida como una tabla o una lista.

Sintaxis:

Dism /Get-Packages [/Format:{Table | List}]

Ejemplos:

Dism /Image:C:\test\offline /Get-Packages

Dism /Image:C:\test\offline /Get-Packages /Format:Table

Dism /Online /Get-Packages

/Get-PackageInfo

Muestra información detallada sobre un paquete proporcionado como un archivo .cab. Solo se pueden especificar archivos .cab. No puede usar este comando para obtener información del paquete de los archivos .msu. /PackagePath:<path_to_package> puede apuntar a un archivo .cab o a una carpeta.

Puede usar la opción /Get-Packages para buscar el nombre del paquete en la imagen o puede especificar la ruta de acceso al archivo .cab. La ruta de acceso al archivo .cab debe apuntar al origen original del paquete, no a donde se instala el archivo en la imagen sin conexión.

Sintaxis:

Dism /Get-PackageInfo {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}

Ejemplos:

Dism /Image:C:\test\offline /Get-PackageInfo /PackagePath:C:\packages\package.cab

Dism /Image:C:\test\offline /Get-PackageInfo /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Add-Package

Instala un paquete de .cab o .msu especificado en la imagen.

Nota:

Puedes usa /Add-Package para agregar un paquete .msu a una imagen en línea o sin conexión de Windows 11, versión 21H2 o posterior. Si trabaja con una imagen de Windows anterior a Windows 11, versión 21H2, solo puede agregar paquetes .msu en imágenes de destino sin conexión.

Se pueden agregar varios paquetes en una línea de comandos. Se comprobará la aplicabilidad de cada paquete. Si el paquete no se puede aplicar a la imagen especificada, recibirá un mensaje de error. Use el argumento /IgnoreCheck si desea que el comando se procese sin comprobar la aplicabilidad de cada paquete.

Sintaxis:

Dism /Add-Package /PackagePath:<path_to_cabfile> [/IgnoreCheck] [/PreventPending]

  • /PackagePath puede apuntar a:

    • Un único archivo .cab o .msu.
    • Carpeta que contiene un único archivo .cab expandido.
    • Una carpeta que contiene un único archivo .msu.
    • Una carpeta que contiene varios archivos .cab o .msu.

  • Si /PackagePath apunta a una carpeta que contiene archivos .cab o .msu en su raíz, las subcarpetas también se comprobará recursivamente si hay archivos .cab y .msu.

  • Use la opción /PreventPending para omitir la instalación del paquete si el paquete o la imagen de Windows tiene acciones en línea pendientes.

Nota:

/Add-Package no ejecuta una comprobación completa de la aplicabilidad y las dependencias de un paquete:

  • Si va a agregar un paquete con dependencias, asegúrese de que todas las dependencias estén instaladas al agregar el paquete.
  • Si va a agregar un archivo .msu, asegúrese de comprobar la KB asociada para ver las instrucciones de instalación específicas del paquete.

Ejemplos:

Dism /Image:C:\test\offline /LogPath:AddPackage.log /Add-Package /PackagePath:C:\packages\package.msu

Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab /IgnoreCheck

Dism /Image:C:\test\offline /Add-Package /PackagePath:C:\test\packages\package.cab /PreventPending

Actualizaciones acumulativas de punto de control

A partir de Windows 11, versión 24H2, la actualización acumulativa más reciente puede tener una actualización acumulativa de requisitos previos necesaria para instalarse primero. Para instalar estas actualizaciones acumulativas de punto de control, llame a /Add-Package con la actualización acumulativa de destino. La carpeta de -PackagePath se usará para detectar e instalar uno o varios puntos de comprobación según sea necesario. Solo la actualización acumulativa de destino y las actualizaciones acumulativas de los puntos de comprobación de requisitos previos deben estar en la carpeta -PackagePath. Se procesarán los paquetes de actualización acumulativa con una revisión menor o igual que la actualización acumulativa de destino.

/Remove-Package

Quita un paquete de archivos .cab especificado de la imagen. Solo se pueden especificar archivos .cab. No puede usar este comando para quitar archivos .msu.

Nota:

El uso de este comando para quitar un paquete de una imagen sin conexión no reducirá el tamaño de la imagen.

Sintaxis:

/Remove-Package {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}
  • Use /PackagePath para apuntar al origen original del paquete, especifique la ruta de acceso al archivo CAB o especifique el paquete por nombre tal y como se muestra en la imagen. Use la opción /Get-Packages para buscar el nombre del paquete en la imagen.

Ejemplos:

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0 /PackageName:Microsoft-Windows-MediaPlayer-Package~31bf3856ad364e35~x86~~6.1.6801.0

Dism /Image:C:\test\offline /LogPath:C:\test\RemovePackage.log /Remove-Package /PackagePath:C:\packages\package1.cab /PackagePath:C:\packages\package2.cab

/Get-Features

Muestra información básica sobre todas las características (componentes del sistema operativo que incluyen características opcionales de Windows Foundation) en un paquete.

Sintaxis:

/Get-Features {/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>} [/Format:{Table | List}]
  • /Get-Features busca el nombre de los paquetes en la imagen o en el origen original del paquete. Si no especifica un nombre de paquete o una ruta de acceso, se mostrarán todas las características de la imagen.
  • /PackageName es un paquete en una imagen. Puede usar /DISM Get-Packages para ver los nombres de paquete en una imagen.
  • /PackagePath puede apuntar a un archivo .cab o a una carpeta.

Use el argumento /Format:Table o /Format:List para mostrar la salida como una tabla o una lista.

Ejemplos:

Dism /Image:C:\test\offline /Get-Features

Dism /Image:C:\test\offline /Get-Features /Format:List

Dism /Image:C:\test\offline /Get-Features /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

Dism /Image:C:\test\offline /Get-Features /PackagePath:C:\packages\package1.cab

/Get-FeatureInfo

Muestra información detallada sobre una característica. Se debe usar /FeatureName. Puede usar la opción /Get-Features para buscar el nombre de la característica en la imagen.

Sintaxis:

/Get-FeatureInfo /FeatureName:<name_in_image> [{/PackageName:<name_in_image> | /PackagePath:<path_to_cabfile>}]

/PackageName y /PackagePath son opcionales y se pueden usar para buscar una característica específica en un paquete.

Ejemplos:

Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts

Dism /Image:C:\test\offline /Get-FeatureInfo /FeatureName:Hearts /PackagePath:C:\packages\package.cab

/Enable-Feature

Habilita o actualiza la característica especificada en la imagen. Debe usar la opción /FeatureName. Use la opción /Get-Features para buscar el nombre de la característica en la imagen.

Sintaxis:

/Enable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Source: <source>] [/LimitAccess] [/All]

Puede especificar la opción /FeatureName varias veces en una línea de comandos para las características que comparten el mismo paquete primario.

No es necesario especificar el nombre del paquete con la opción /PackageName si el paquete es un paquete de Windows Foundation. De lo contrario, use /PackageName para especificar el paquete primario de la característica.

Puede restaurar y habilitar una característica que se ha quitado previamente de la imagen. Use el argumento /Source para especificar la ubicación de los archivos necesarios para restaurar la característica. El origen de los archivos puede usar la carpeta Windows en una imagen montada, por ejemplo, c:\test\mount\Windows. También puede usar una carpeta en paralelo de Windows como origen de los archivos, por ejemplo, z:\sources\SxS.

Si especifica varios argumentos /Source, los archivos se recopilan desde la primera ubicación donde se encuentran y se omiten el resto de las ubicaciones. Si no especifica /Source para una característica que se ha quitado, se usa la ubicación predeterminada en el Registro o, para imágenes en línea, se usa Windows Update (WU).

  • Use /LimitAccess para evitar que DISM se comunique con WU para obtener imágenes en línea.
  • Use /All para habilitar todas las características primarias de la característica especificada.

Ejemplos:

Dism /Online /Enable-Feature /FeatureName:Hearts /All

Dism /Online /Enable-Feature /FeatureName:Calc /Source:c:\test\mount\Windows /LimitAccess

Dism /Image:C:\test\offline /Enable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Disable-Feature

Deshabilita la característica especificada en la imagen. Debe usar la opción /FeatureName. Use la opción /Get-Features para buscar el nombre de la característica en la imagen.

Sintaxis:

/Disable-Feature /FeatureName:<name_in_image> [/PackageName:<name_in_image>] [/Remove]

Puede especificar /FeatureName varias veces en una línea de comandos para las características del mismo paquete primario.

No es necesario especificar el nombre del paquete mediante la opción /PackageName si el paquete es un paquete de Windows Foundation. De lo contrario, use /PackageName para especificar el paquete primario de la característica.

Use /Remove para eliminar una característica sin quitar el manifiesto de la característica de la imagen. La característica se mostrará como "Quitada" cuando se use /Get-FeatureInfo para mostrar los detalles de la característica y se puede restaurar y habilitar mediante /Enable-Feature con la opción /Source.

Ejemplos:

*Dism /Online /Disable-Feature /FeatureName:Hearts

Dism /Image:C:\test\offline /Disable-Feature /FeatureName:Calc /PackageName:Microsoft.Windows.Calc.Demo~6595b6144ccf1df~x86~en~1.0.0.0

/Cleanup-Image

Realiza operaciones de limpieza o recuperación en la imagen. /AnalyzeComponentStore y /ResetBase se pueden usar con imágenes de Windows 10, Windows 8.1 y Windows PE superiores a 5.0. A partir de Windows 10, versión 1607, puede especificar /Defer con /ResetBase, pero solo debe usar /Defer como opción en la fábrica donde DISM /Resetbase requiere más de 30 minutos para completarse.

Sugerencia

Para determinar cuándo se ejecutó por última vez la opción /ResetBase, compruebe la entrada del Registro LastResetBase_UTC en la ruta del Registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing.

Sintaxis:

/Cleanup-Image {/RevertPendingActions | /SPSuperseded [/HideSP] | /StartComponentCleanup [/ResetBase [/Defer]] | /AnalyzeComponentStore | /CheckHealth | /ScanHealth | /RestoreHealth [/Source: <filepath>] [/LimitAccess]}
Parámetro Descripción
/RevertPendingActions Si experimenta un error de arranque, puede usar la opción /RevertPendingActions para intentar recuperar el sistema. La operación revierte todas las acciones pendientes de las operaciones de mantenimiento anteriores, ya que estas acciones podrían ser la causa del error de arranque. La opción /RevertPendingActions no se admite en un sistema operativo en ejecución o en una imagen de Windows PE o Windows Recovery Environment (Windows RE). Importante: debe usar la opción /RevertPendingActions solo en un escenario de recuperación del sistema en una imagen de Windows que no se ha iniciado.
SPSuperseded Quita los archivos de copia de seguridad creados durante la instalación de un Service Pack. Use /HideSP para evitar que el Service Pack aparezca en la Panel de control Actualizaciones instaladas. El Service Pack no se puede desinstalar una vez completada la operación /SPSuperseded.
/StartComponentCleanup Limpia los componentes reemplazados y reduce el tamaño del almacén de componentes. Use /ResetBase para restablecer la base de componentes reemplazados, lo que puede reducir aún más el tamaño del almacén de componentes. Las actualizaciones instaladas de Windows no se pueden desinstalar después de ejecutar /StartComponentCleanup con la opción /ResetBase. Use /Defer con /ResetBase para aplazar las operaciones de limpieza de larga duración al siguiente mantenimiento automático.
/AnalyzeComponentStore Crea un informe del almacén de componentes. Para obtener más información sobre el informe y sobre cómo usar la información proporcionada en el informe, consulte Determinación del tamaño real de la carpeta WinSxS.
/CheckHealth Comprueba si la imagen se ha marcado como dañada por un proceso con errores y si se pueden reparar los daños.
/ScanHealth Analiza la imagen para detectar daños en el almacén de componentes. Esta operación puede tardar varios minutos.
/RestoreHealth Analiza la imagen para detectar daños en el almacén de componentes y, a continuación, realiza operaciones de reparación automáticamente. Esta operación puede tardar varios minutos.
/Source Se usa con /RestoreHealth para especificar la ubicación de las versiones correctas conocidas de los archivos que se pueden usar para la reparación, como una ruta de acceso al directorio de Windows de una imagen montada.
/LimitAccess Impide que DISM se comunique con Windows Update para reparar imágenes en línea.

Ejemplos:

Dism /Image:C:\test\offline /Cleanup-Image /RevertPendingActions

Dism /Image:C:\test\offline /Cleanup-Image /SPSuperseded /HideSP

Dism /Online /Cleanup-Image /ScanHealth

Dism /Online /Cleanup-Image /RestoreHealth /Source:c:\test\mount\windows /LimitAccess

Para obtener más información, consulte Reparación de una imagen de Windows.

Limitaciones

  • Al instalar un paquete en una imagen sin conexión, el estado del paquete es "instalación pendiente" debido a las acciones en línea pendientes. En otras palabras, el paquete se instalará cuando se arranque la imagen y se procesen las acciones en línea. Si se solicitan acciones posteriores, no se pueden procesar hasta que se complete la acción en línea pendiente anterior. Puede usar la opción /PreventPending al agregar un paquete con /AddPackage para omitir la instalación de un paquete cuando haya acciones en línea pendientes.
  • Algunos paquetes requieren que se instale primero otros paquetes. No debe suponer que se cumplirán las dependencias. Si un paquete tiene requisitos de dependencia, use un archivo de respuesta para instalar los paquetes necesarios. Al pasar un archivo de respuesta a DISM, se pueden instalar varios paquetes en el orden correcto. Para obtener más información, consulte Adición o eliminación de paquetes sin conexión mediante DISM.
  • Los paquetes se instalan en el orden en que aparecen en la línea de comandos.
  • Cuando se usa DISM para enumerar los componentes opcionales de una imagen de Windows PE, los componentes opcionales siempre se mostrarán como pendientes aunque la operación de mantenimiento se haya realizado correctamente. Esto es por diseño y no requiere ninguna acción adicional.

¿Qué es DISM?

Opciones de línea de comandos para DISM Image Management

Opciones de línea de comandos para Administración y mantenimiento de imágenes de implementación (DISM)