Opciones de Command-Line de mantenimiento del paquete de sistema operativo DISM (.cab o .msu)

  • Artículo

Use DISM con el gabinete de Windows (.cab) o Windows Update archivos de instalador independiente (.msu) para instalar o quitar actualizaciones, paquetes de idioma y para habilitar o deshabilitar las 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 /Format:Table argumento 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 .cab archivos. 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 /Get-Packages opción para buscar el nombre del paquete en la imagen, o bien 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 especificado .cab o .msu en la imagen.

Nota

Puede usar /Add-Package para agregar un paquete .msu a una imagen de Windows 11 en línea o sin conexión, versión 21H2 o posterior. Si está trabajando con una imagen de Windows antes de 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 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 de .cab expandido.
    • Carpeta que contiene un único archivo .msu.
    • Carpeta que contiene varios archivos .cab o .msu.

  • Si /PackagePath apunta a una carpeta que contiene un archivo .cab o .msu en su raíz, las subcarpetas también se comprobarán de forma recursiva para los archivos .cab y .msu.

  • Use la /PreventPending opción 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 base de conocimiento 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

/Remove-Package

Quita un paquete de archivos .cab especificado de la imagen. Solo se pueden especificar .cab archivos. 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 para especificar el paquete por nombre tal y como se muestra en la imagen. Use la /Get-Packages opción 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 o ruta de acceso del paquete, se mostrarán todas las características de la imagen.
  • /PackageName es un paquete de 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 /Format:Table argumento 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 /Get-Features opción 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 /FeatureName opción . Use la /Get-Features opción 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 /FeatureName opción varias veces en una línea de comandos para las características que comparten el mismo paquete primario.

No tienes que especificar el nombre del paquete con la /PackageName opción 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 /Source argumento para especificar la ubicación de los archivos necesarios para restaurar la característica. El origen de los archivos puede realizar 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 las 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 /Get-Features opción 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 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.

Use /Remove para quitar una característica sin quitar el manifiesto de la característica de la imagen. La característica se mostrará como "Quitada" cuando 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. /AnalyzeComponentStorey /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 de acceso del HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing Registro.

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 ni 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 arranca.
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 el Novedades Panel de control instalado. 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 de Windows instaladas 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 cómo usar la información proporcionada en el informe, vea Determinar el 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 Examina la imagen en busca de daños en el almacén de componentes. Esta operación puede tardar varios minutos.
/RestoreHealth Examina 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 válidas 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 Evita 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 "instalar pendiente" debido a 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 /PreventPending opción 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, vea Agregar o quitar paquetes sin conexión mediante DISM.
  • Los paquetes se instalan en el orden en que aparecen en la línea de comandos.
  • Al usar DISM para enumerar los componentes opcionales de una imagen de Windows PE, los componentes opcionales siempre se mostrarán como pendientes incluso cuando 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)