Opciones de la línea de comandos de Administración de imágenes de DISM

Artículo
05/30/2023

Administración y mantenimiento de imágenes de implementación (DISM.exe) monta un archivo de imagen de Windows (.wim) o un disco duro virtual (.vhd o .vhdx) para su mantenimiento. También puede usar el comando de administración de imágenes DISM para enumerar los números de índice de las imágenes, verificar la arquitectura de la imagen que está montando, añadir una imagen, aplicar una imagen, capturar una imagen y eliminar una imagen. Después de actualizar la imagen, debe desmontarla y confirmar o descartar los cambios realizados.

En este tema se tratan los comandos DISM relacionados con la administración de imágenes. Para consultar otras opciones de la línea de comandos, consulte Opciones de la línea de comandos de DISM (Administración y mantenimiento de imágenes de implementación). Para más información sobre los escenarios de DISM más comunes, consulte ¿Qué es DISM?.

Además de la herramienta de línea de comandos, DISM está disponible usando Windows PowerShell. Para más información, vea Cmdlets de Administración y mantenimiento de imágenes de implementación (DISM) en Windows PowerShell.

Se pueden usar los siguientes comandos para montar, desmontar, capturar, anexar y eliminar y consultar archivos .wim, .vhd y .vhdx. Estas opciones no distinguen entre mayúsculas y minúsculas.

/Append-Image

Agrega una imagen adicional a un archivo .wim. /Append-Image compara los archivos nuevos con los recursos del archivo .wim existente especificado por el argumento /ImageFile, y almacena solo una copia de cada archivo único para que cada archivo solo se capture una vez. El archivo .wim solo puede tener asignado un tipo de compresión. Por lo tanto, solo puede anexar archivos con el mismo tipo de compresión.

Esta opción de la línea de comandos no se aplica a los archivos de disco duro virtual (VHD).

Importante

Asegúrese de que dispone de suficiente espacio en disco para que se ejecute la opción /Append-Image. Si se queda sin espacio en disco mientras se anexa la imagen, puede dañar el archivo .wim.

Sintaxis:

DISM.exe /Append-Image /ImageFile:<path_to_image_file> /CaptureDir:<source_directory> /Name:<image_name> [/Description:<image_description>] [/ConfigFile:<configuration_file.ini>] [/Bootable] /WIMBoot [/CheckIntegrity] [/Verify] [/NoRpFix]

Parámetro	Descripción
/WIMBoot	Use /WIMBoot para adjuntar la imagen con la configuración de arranque del archivo de imagen de Windows (WIMBoot). Esto solo se aplica a las imágenes de Windows 8.1 que se hayan capturado o exportado como archivo WIMBoot. Esta característica no es compatible con Windows 10 y versiones posteriores.
/ConfigFile	especifica la ubicación de un archivo de configuración que enumera las exclusiones para los comandos de captura y compresión de imágenes. Para más información, consulte Lista de configuración de DISM y archivos WimScript.ini.
/Bootable	Marca una imagen de volumen como una imagen de arranque. Este argumento solo está disponible para las imágenes del Entorno de preinstalación de Windows (WinPE). En un archivo .wim solo se puede marcar una imagen de volumen como de arranque.
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.
/Verify	Busca errores y archivos duplicados.
/NoRpFix	Deshabilita la corrección de etiquetas de puntos de análisis. Un punto de análisis es un archivo que contiene un vínculo a otro archivo en el sistema de archivos. Si no se especifica /NoRpFix, no se capturarán los puntos de reparación que resuelvan a rutas de acceso fuera del valor especificado por /ImageFile.

Ejemplo:

Dism /Append-Image /ImageFile:install.wim /CaptureDir:D:\ /Name:Drive-D

/Apply-FFU

En el caso de FFU, este comando aplica una Utilidad flash completa (FFU) o FFU dividida (SFU) a una unidad física especificada.

Sintaxis:

/Apply-Ffu /ImageFile:<path_to_image_file> /ApplyDrive:<physical_drive_path> [/SFUFile:<pattern>]

Parámetro	Descripción
/ImageFile	La ruta de acceso y el nombre del archivo de imagen FFU que se aplicará
/ApplyDrive	La ruta de acceso a la unidad física de la que se obtendrán imágenes
/SFUfile<pattern>	Opcional, para FFU divididas que se capturan sin compresión. Use /SFUFile para hacer referencia a los archivos de FFU dividida (SFU). Pattern es el patrón de nombres y la ubicación de los archivos divididos. Use un carácter comodín al especificar el patrón de nomenclatura. Por ejemplo, "E:\image\install*.sfu" aplicará todos los archivos divididos del directorio E:\image llamados install1.sfu, install2.sfu, etc.

Ejemplo:

DISM.exe /Apply-Ffu /ImageFile:flash.ffu /ApplyDrive:\\.\PhysicalDrive0

/Apply-Image

Para WIM, este comando aplica un archivo de imagen de Windows (.wim) o un archivo de imagen de Windows dividido (.swm) a una partición especificada. A partir de Windows 10, versión 1607, DISM puede aplicar y capturar atributos extendidos (EA).

Para FFU, este comando aplica una imagen de actualización flash completa (.ffu) a una unidad especificada. No es compatible con la aplicación de una imagen desde un archivo de disco duro virtual (.vhdx), aunque puede usar este comando para aplicar una imagen completa a un VHD. FFU se aplica solo a Windows 10. Aunque puede usar este comando para aplicar un FFU, use /apply-ffu en su lugar.

Esta opción no es compatible con la aplicación de una imagen desde un disco duro virtual (VHD), aunque puede usar este comando para aplicar imágenes a un archivo .vhdx que haya sido adjuntado, particionado y formateado.

Argumentos para WIM:

DISM.exe /Apply-Image /ImageFile:<path_to_image_file> [/SWMFile:<pattern>] /ApplyDir:<target_directory> {/Index:< image_index> | /Name:<image_name>} [/CheckIntegrity] [/Verify] [/NoRpFix] [/ConfirmTrustedFile] [/WIMBoot (deprecated)] [/Compact] [/EA]

Argumentos para FFU

Vea /apply-ffu.

Parámetro	Descripción
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.
/Verify	Busca errores y archivos duplicados.
/NoRpFix	Deshabilita la corrección de etiquetas de puntos de análisis. Un punto de análisis es un archivo que contiene un vínculo a otro archivo en el sistema de archivos. Si no se especifica /NoRpFix, no se capturarán los puntos de reparación que resuelvan a rutas de acceso fuera del valor especificado por /ImageFile.
/SWMFile	Le permite hacer referencia a archivos .wim divididos (SWM). Pattern es el patrón de nombres y la ubicación de los archivos divididos. Use un carácter comodín al especificar el patrón de nomenclatura. Por ejemplo, "E:\image\install*.swm" aplicará todos los archivos divididos del directorio E:\image llamados install1.swm, install2.swm, etc.
/ConfirmTrustedFile	Valida la imagen para Escritorio de confianza. Esta opción solo puede ejecutarse en un ordenador que ejecute al menos WinPE 4.0. Cuando use /Apply-Image con la opción /ConfirmTrustedFile en WinPE, especifique siempre la opción /ScratchDir apuntando a una ubicación física del medio. Esto garantiza que los nombres de archivo cortos estén siempre disponibles. Consulte Opciones globales de DISM para la sintaxis de la línea de comandos para más información sobre el comportamiento predeterminado de la opción /ScratchDir. A partir de Windows 10, versión 1607, puede usar /EA para aplicar atributos extendidos.
/WIMBoot	Use /WIMBoot para adjuntar la imagen con la configuración de arranque del archivo de imagen de Windows (WIMBoot). Esto solo se aplica a las imágenes de Windows 8.1 que se hayan capturado o exportado como archivo WIMBoot. Esta característica no es compatible con Windows 10 y versiones posteriores.
/Compact	Aplica una imagen en modo compacto, ahorrando espacio en la unidad. Reemplaza a WIMBoot. Solo para ediciones de Windows 10 para escritorio (Home, Pro, Enterprise y Education). Nota: si está aplicando una imagen en modo compacto con la opción /ScratchDir, asegúrese de que su carpeta ScratchDir no se encuentra en una partición con formato FAT32. El uso de una partición FAT32 podría provocar reinicios inesperados durante el OOBE.
/EA	Nuevo en Windows 10, versión 1607. Aplica atributos extendidos.
/ApplyDrive	Especifica la unidad lógica, usando el DeviceID. para obtener el id. del dispositivo desde la línea de comandos, escriba "wmic diskdrive list brief". Nota: un VHD puede aparecer con el nombre "PhysicalDrive" en la descripción, por ejemplo, .\PhysicalDrive2.
/SFUFile	Use /SFUFile para hacer referencia a los archivos de FFU dividida (SFU). Pattern es el patrón de nombres y la ubicación de los archivos divididos.

Ejemplos:

Dism /apply-image /imagefile:install.wim /index:1 /ApplyDir:D:\

Dism /apply-image /imagefile:install.swm /swmfile:install*.swm /index:1 /applydir:D:

/Capture-CustomImage

Captura los cambios incrementales del archivo en función del archivo install.wim específico en un nuevo archivo, custom.wim para una imagen WIMBoot. No puede capturar un directorio vacío. Los archivos capturados se convierten en archivos de puntero. El custom.wim se coloca en la misma carpeta junto al install.wim.

Importante

/Capture-CustomImage solo captura los archivos de personalización. No puede usarse para capturar archivos de instalación en un nuevo WIM.
Mantenga juntos los archivos install.wim y custom.wim. No cambie ni el archivo custom.wim ni el archivo install.wim.
Solo puede capturar la imagen personalizada una vez. No quite ni vuelva a capturar un archivo custom.wim después de capturar los cambios incrementales del archivo.

Sintaxis:

Dism /Capture-CustomImage /CaptureDir:<source_directory> [/ConfigFile:<configuration_file.ini>] [/CheckIntegrity] [/Verify] [/ConfirmTrustedFile]

Parámetro	Descripción
/CaptureDir	Especifica el directorio en el que se aplicó y personalizó la imagen.
/ConfigFile	Especifica la ubicación de un archivo de configuración en el que recogen exclusiones de la captura de imagen y comandos de compresión. Para más información, consulte Lista de configuración de DISM y archivos WimScript.ini.
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.
/Verify	Busca errores y archivos duplicados.
[/ConfirmTrustedFile	Valida la imagen de Escritorio de confianza en un Windows 10, Windows 8.1 o Windows 8. Esta opción solo puede ejecutarse en un ordenador que ejecute al menos WinPE 4.0.

Ejemplo:

Dism /Capture-CustomImage /CaptureDir:D:\

/Capture-FFU

Captura una imagen de las particiones de una unidad física en un nuevo archivo .ffu.

Puede capturar la imagen como un archivo de imagen de utilidad flash completa (.ffu) o como un conjunto de archivos de ffu dividida (.sfu);

Sintaxis:

Dism /Capture-Ffu /ImageFile:<path_to_image_file> /CaptureDrive:<physical_drive_path> /Name:<image_name> [/Description:<image_description>] [/PlatformIds:<platform_ids>] [/Compress:{default|none}]

Parámetro	Descripción
/CaptureDrive	Unidad física que se va a capturar. Puede usar diskpart para obtener información sobre el número de unidad. Usa el formato `\\.\PhysicalDriveX`, donde X es el número de disco que proporciona diskpart.
/PlatformIds	No es necesario para la captura de escritorio. Especifica uno o varios id. de plataforma (separados por punto y coma) que se agregarán a la imagen. Si no se especifica, el id. de plataforma será '*'.
/Compress	Especifica el tipo de compresión usado al capturar. Si va a dividir la FFU, especifique `none`, ya que DISM no es compatible con la división de FFU comprimidas.

Ejemplos:

Capture una FFU de escritorio:

DISM.exe /Capture-Ffu /ImageFile:install.ffu /CaptureDrive:\\.\PhysicalDrive0 /Name:Drive0

Capture una FFU de escritorio que se dividirá:

DISM.exe /Capture-Ffu /ImageFile:install.ffu /CaptureDrive:\\.\PhysicalDrive0 /Name:Drive0 /Compress:none

/Capture-Image

Captura una imagen de una unidad en un nuevo archivo .wim. Los directorios capturados incluyen todas las subcarpetas y los datos. No se puede capturar un directorio vacío. Un directorio debe contener como mínimo un archivo. DISM también puede aplicar y capturar opcionalmente atributos extendidos (EA).

Puede capturar la imagen como un archivo de imagen de Windows (.wim) o un conjunto de archivos de imagen de Windows dividida (.swm), pero esta opción no es compatible con la captura de un archivo de disco duro virtual (.vhd/.vhdx). Consulte /Capture-FFU si quiere capturar una FFU.

Sintaxis:

Dism /Capture-Image /ImageFile:<path_to_image_file> /CaptureDir:<source_directory> /Name:<image_name> [/Description:<image_description>]
[/ConfigFile:<configuration_file.ini>] {[/Compress:{max|fast|none}] [/Bootable] | [/WIMBoot]} [/CheckIntegrity] [/Verify] [/NoRpFix] [/EA]

Parámetro	Descripción
/ConfigFile	Especifica la ubicación de un archivo de configuración en el que recogen exclusiones de la captura de imagen y comandos de compresión. Para más información, consulte Lista de configuración de DISM y archivos WimScript.ini.
/Compress	Especifica el tipo de compresión utilizado para la operación de captura inicial. La opción maximum proporciona la mejor compresión, pero tarda más en capturar la imagen. La opción fast ofrece una compresión de imagen más rápida, pero los archivos resultantes son más grandes que cuando se comprimen con la opción maximum. También es el tipo de compresión predeterminado que se usa si no se especifica el argumento. La opción none no comprime la imagen.
/Bootable	Marca una imagen de volumen como una imagen de arranque. Este argumento solo está disponible para imágenes de WinPE. En un archivo .wim solo se puede marcar una imagen de volumen como de arranque.
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.
/Verify	Busca errores y archivos duplicados.
/NoRpFix	Deshabilita la corrección de etiquetas de puntos de análisis. Un punto de análisis es un archivo que contiene un vínculo a otro archivo en el sistema de archivos. Si no se especifica /NoRpFix, no se capturarán los puntos de reparación que resuelvan a rutas de acceso fuera del valor especificado por /ImageFile.
/WIMBoot	Use /WIMBoot para adjuntar la imagen con la configuración de arranque del archivo de imagen de Windows (WIMBoot). Esto solo se aplica a las imágenes de Windows 8.1 que se hayan capturado o exportado como archivo WIMBoot. Esta característica no es compatible con Windows 10 y versiones posteriores.
/EA	Captura atributos extendidos. El modificador debe especificarse explícitamente para capturar atributos extendidos. DISM capturará los bits de atributos extendidos si están establecidos en los componentes que se capturarán en la imagen de WIM. Si los bits no están establecidos, DISM no los establecerá. Solo los componentes de la bandeja de entrada de los paquetes CAB y los controladores tendrán estos bits de atributo extendido, no los componentes del paquete AppX ni los componentes de la aplicación Win32. Los atributos extendidos con el prefijo "$Kernel". en nombre se omitirán porque solo se capturan los atributos extendidos del modo de usuario. Si usa DISM en Windows 10, versión 1607 para capturar atributos extendidos y usa una versión anterior de DISM para aplicar la imagen, la operación tendrá éxito pero los atributos extendidos no se establecerán en la imagen aplicada.

Ejemplos:

Dism /Capture-Image /ImageFile:install.wim /CaptureDir:D:\ /Name:Drive-D

dism /Capture-Image /CaptureDir:C:\ /ImageFile:"C:\WindowsWithOffice.wim" /Name:"Chinese Traditional" /ea

/Cleanup-Mountpoints

Elimina todos los recursos asociados a una imagen montada que se ha dañado. Este comando no desmontará las imágenes que ya están montadas, ni eliminará las imágenes que se pueden recuperar mediante el comando /Remount-Image.

Ejemplo:

Dism /Cleanup-Mountpoints

Para más información, consulte Reparar una imagen de Windows

/Commit-Image

Aplica los cambios que ha realizado en la imagen montada. La imagen permanece montada hasta que se usa la opción /Unmount-Image.

Sintaxis:

Dism /Commit-Image /MountDir:<path_to_mount_directory> [/CheckIntegrity] [/Append]

Parámetro	Descripción
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.
/Append	Agrega la imagen modificada al archivo .wim existente en lugar de sobrescribir la imagen original. Los argumentos /CheckIntegrity y /Append no se aplican a los archivos de disco duro virtual (VHD).

Ejemplo:

Dism /Commit-Image /MountDir:C:\test\offline

/Delete-Image

Elimina la imagen de volumen especificada de un archivo .wim con varias imágenes de volumen. Esta opción sólo elimina las entradas XML y de metadatos. No elimina los datos de la secuencia y no optimiza el archivo .wim.

Esta opción de la línea de comandos no se aplica a los archivos de disco duro virtual (VHD).

Sintaxis:

Dism /Delete-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>} [/CheckIntegrity]

Parámetro	Descripción
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.

Ejemplo:

Dism /Delete-Image /ImageFile:install.wim /Index:1

/Export-Image

Exporta una copia de la imagen especificada a otro archivo. Los archivos de origen y de destino deben usar el mismo tipo de compresión. También se puede optimizar una imagen exportándola a un archivo de imagen nuevo. Cuando se modifica una imagen, DISM almacena archivos de recursos adicionales que aumentan el tamaño global de la imagen. Al exportar la imagen se eliminarán los archivos de recursos innecesarios.

Esta opción de la línea de comandos no se aplica a los archivos de disco duro virtual (VHD).

Sintaxis:

Dism /Export-Image /SourceImageFile:<path_to_image_file> {/SourceIndex:<image_index> | /SourceName:<image_name>} /DestinationImageFile:<path_to_image_file> [/DestinationName:<Name>] [/Compress:{fast|max|none|recovery}] [/Bootable] [/WIMBoot] [/CheckIntegrity]

Parámetro	Descripción
/SWMFile	Le permite hacer referencia a archivos .wim divididos. pattern es el patrón de nombres y la ubicación de los archivos divididos. También puede especificar caracteres comodín. Por ejemplo, "E:\image\install*.swm" exportará todos los archivos divididos del directorio E:\image llamados install1.swm, install2.swm, etc.
/Compress	Especifica el tipo de compresión utilizado para la operación de captura inicial. El argumento /Compress no se aplica cuando exporta una imagen a un archivo .wim existente, solo puede usar este argumento cuando exporta una imagen a un nuevo archivo .wim. La opción maximum proporciona la mejor compresión, pero tarda más en capturar la imagen. La opción fast ofrece una compresión de imagen más rápida, pero los archivos resultantes son más grandes que cuando se comprimen con la opción maximum. También es el tipo de compresión predeterminado que se usa si no se especifica el argumento. Use la opción recovery para exportar imágenes de restablecimiento de pulsación de botón. Los archivos resultantes son mucho más pequeños en tamaño, lo que a su vez reduce en gran medida la cantidad de espacio en disco necesario para guardar la imagen de restablecimiento de pulsación de botón en una unidad de recuperación. El archivo de destino debe especificarse con extensión .esd. La opción none no comprime la imagen.
/Bootable	Marca una imagen de volumen como una imagen de arranque. Este argumento solo está disponible para imágenes de WinPE. En un archivo .wim solo se puede marcar una imagen de volumen como de arranque.
/WIMBoot	Use /WIMBoot para adjuntar la imagen con la configuración de arranque del archivo de imagen de Windows (WIMBoot). Esto solo se aplica a las imágenes de Windows 8.1 que se hayan capturado o exportado como archivo WIMBoot. Esta característica no es compatible con Windows 10 y versiones posteriores.
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.

Ejemplo:

Dism /Export-Image /SourceImageFile:install.wim /SourceIndex:1 /DestinationImageFile:install2.wim

/Get-ImageInfo

Muestra información sobre las imágenes contenidas en un archivo .wim, .ffu, .vhd o .vhdx. Cuando se usa con el argumento /Index o /Name, se muestra información sobre la imagen especificada, que incluye si una imagen es una imagen WIMBoot, si la imagen es Windows 8.1, consulte Hacer inventario de una imagen o componente usando DISM. El argumento /Name no se aplica a los archivos VHD. Debe especificar /Index:1 para los archivos FFU y VHDX.

Sintaxis:

Dism /Get-ImageInfo /ImageFile:<path_to_image.wim> [{/Index:<Image_index> | /Name:<Image_name>}]

Ejemplos:

Dism /Get-ImageInfo /ImageFile:C:\test\offline\install.wim

Dism /Get-ImageInfo /ImageFile:C:\test\images\myimage.vhd /Index:1

/Get-MountedImageInfo

Devuelve una lista de las imágenes .ffu, .vhd, .vhdx y .wim que están montadas actualmente, así como información sobre la imagen montada como, por ejemplo, si la imagen es válida, los permisos de lectura/escritura, la ubicación de montaje, la ruta de acceso del archivo montado y el índice de la imagen montada.

Ejemplo:

Dism /Get-MountedImageInfo

/Get-WIMBootEntry

Use /Get-WIMBootEntry para mostrar las entradas de configuración de WIMBoot para el volumen de disco especificado.

Para más información sobre cómo mostrar las entradas de configuración de WIMBoot, consulte Hacer inventario de una imagen o componente usando DISM.

Solo se aplica a Windows 8.1; esta característica no es compatible con Windows 10 y versiones posteriores.

Sintaxis:

Dism /Get-WIMBootEntry /Path:<volume_path>

Ejemplo:

Dism /Get-WIMBootEntry /Path:C:\

/List-Image

Muestra una lista de los archivos y carpetas de una imagen especificada.

Esta opción de la línea de comandos no se aplica a los archivos de disco duro virtual (VHD).

Sintaxis:

Dism /List-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>}

Ejemplo:

Dism /List-Image /ImageFile:install.wim /Index:1

/Mount-Image

Monta una imagen de un archivo .ffu, .wim, .vhd o .vhdx en el directorio especificado para que esté disponible para su mantenimiento.

Cuando monte una imagen, tenga en cuenta lo siguiente:

El directorio de montaje debe estar creado, pero vacío.
Se requiere un valor de índice o nombre para todos los tipos de imagen. Los WIM pueden contener más de una imagen. Para FFU y VHD, use index:1.

Sintaxis:

Dism /Mount-Image /ImageFile:<path_to_image_file> {/Index:<image_index> | /Name:<image_name>} /MountDir:<path_to_mount_directory> [/ReadOnly] [/Optimize] [/CheckIntegrity]

Parámetro	Descripción
/ReadOnly	Establece la imagen montada con permisos de solo lectura. Opcional.
/Optimize	Reduce el tiempo de montaje inicial.
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.

Ejemplos:

Dism /Mount-Image /ImageFile:C:\test\images\myimage.wim /index:1 /MountDir:C:\test\offline

Dism /Mount-Image /ImageFile:C:\test\images\myimage.vhd /index:1 /MountDir:C:\test\offline /ReadOnly

Dism /Mount-Image /ImageFile:C:\test\images\WinOEM.ffu /MountDir:C:\test\offline /index:1

/Optimize-FFU

Optimiza una imagen FFU para que sea más rápida de implementar y también se pueda implementar más fácilmente en discos de distintos tamaños. Consulte Capturar y aplicar imágenes de Actualización flash completa de Windows para más información.

Sintaxis:

Dism /Optimize-FFU /ImageFile:<path-to-ffu-file> [/PartitionNumber:<PartitionNumber>]

Parámetro	Descripción
/ImageFile	Ruta de acceso a la FFU que quiere optimizar.
/PartitionNumber	Opcional. De manera predeterminada `/Optimize-FFU` optimiza la partición del sistema operativo. `/PartitionNumber` le permite especificar la partición que quiere optimizar.

Ejemplos:

Dism /Optimize-FFU /ImageFile:flash.ffu

Dism /Optimize-FFU /ImageFile:flash.ffu /PartitionNumber:2

/Optimize-Image

Este comando debe ser el último comando que se ejecute en una imagen antes de aplicar la imagen a un dispositivo, y puede reducir el tiempo en la planta de fábrica al compilar dispositivos para escenarios de compilación a stock.

Sintaxis:

DISM.exe /Image:C:\test\offline /Optimize-Image {/Boot | /WimBoot}

/Boot intenta reducir el tiempo de configuración en línea que necesita el SO durante el arranque. Esta optimización puede representarse como no válida si se realizan operaciones de mantenimiento en la imagen después de optimizarla.

DISM /Optimize-Image /boot está disponible en los siguientes sistemas operativos:
- Windows 11
- Windows 10, versión 1607
- Windows 10, versión 1809 y posteriores
- Windows Server 2012 R2 o posterior
  
  Use /Boot para intentar reducir el tiempo de configuración en línea que necesita el SO durante el arranque. Tenga en cuenta que esta optimización puede representarse como no válida si se realizan operaciones de mantenimiento en la imagen después de optimizarla.
/WimBoot se usa para configurar una imagen sin conexión para la instalación en un sistema WIMBoot.

Ejemplos:

DISM.exe /Image:C:\test\offline /Optimize-Image /Boot

DISM.exe /Image:C:\test\offline /Optimize-Image /WimBoot

/Remount-Image

Vuelve a montar una imagen montada que se ha vuelto inaccesible y la pone a disposición para su mantenimiento.

Sintaxis:

Dism /Remount-Image /MountDir:<path_to_mount_directory>

Ejemplo:

Dism /Remount-Image /MountDir:C:\test\offline

/Split-FFU

En el caso de FFU, este comando divide un archivo de actualización flash completa (.ffu) existente en varios archivos de .sfu divididos de solo lectura. DISM no es compatible con la división de FFU comprimidas. Si va a dividir FFU, asegúrese de que la FFU se capturó con la opción /compress:none especificada.

Esta opción crea los archivos .sfu en el directorio especificado, asignando a cada archivo un nombre igual que el /SFUFile especificado, pero con un número añadido. Por ejemplo, si usa c:\flash.sfu, obtendrá un archivo flash.sfu, un archivo flash2.ffu, un archivo flash3.sfu, y así sucesivamente, definiendo cada porción del archivo .sfu dividido y guardándolo en el directorio C:\.

Sintaxis para FFU:

Dism /Split-Ffu /ImageFile:<path_to_image_file> /SFUFile:<pattern> /FileSize:<MB-Size> [/CheckIntegrity]

Parámetro	Descripción
/FileSize	Especifica el tamaño máximo en megabytes (MB) de cada archivo creado. Si un único archivo es mayor que el valor especificado en la opción /FileSize, uno de los archivos .swm divididos resultantes será mayor que el valor especificado en la opción /FileSize, con el fin de acomodar el archivo grande.
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.
/ImageFile	Especifica la ruta de acceso de un archivo .FFU, ejemplo: flash.ffu.
/SFUFile	Hace referencia a los archivos FFU dividida (SFU). Pattern es el patrón de nombres y la ubicación de los archivos divididos.

Ejemplo:

DISM.exe /Split-Ffu /ImageFile:flash.ffu /SFUFile:flash.sfu /FileSize:650

/Split-Image

Para WIM, este comando divide un archivo .wim existente en múltiples archivos .swm divididos de solo lectura.

Esta opción crea los archivos .swm en el directorio especificado, asignando a cada archivo un nombre igual que el path_to_swm especificado, pero con un número añadido. Por ejemplo, si establece path_to_swm como c:\Data.swm, esta opción crea un archivo Data.swm, un archivo Data2.swm, un archivo Data3.swm, y así sucesivamente, definiendo cada porción del archivo .wim dividido y guardándolo en el directorio C:\.

Esta opción de la línea de comandos no se aplica a los archivos de disco duro virtual (VHD).

Sintaxis para WIM:

Dism /Split-Image /ImageFile:<path_to_image_file> /SWMFile:<path_to_swm> /FileSize:<MB-Size> [/CheckIntegrity]

Parámetro	Descripción
/FileSize	Especifica el tamaño máximo en megabytes (MB) de cada archivo creado. Si un único archivo es mayor que el valor especificado en la opción /FileSize, uno de los archivos .swm divididos resultantes será mayor que el valor especificado en la opción /FileSize, con el fin de acomodar el archivo grande.
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.
/ImageFile	Especifica la ruta de acceso de un archivo de imagen, ejemplo: install.wim.

Ejemplo:

Dism /Split-Image /ImageFile:install.wim /SWMFile:split.swm /FileSize:650

/Unmount-Image

Desmonta el archivo .ffu, .wim, .vhd o .vhdx y confirma o descarta los cambios realizados cuando se montó la imagen.

Debe usar el argumento /commit o /discard cuando use la opción /Unmount-Image.

Sintaxis:

Dism /Unmount-Image /MountDir:<path_to_mount_directory> {/Commit | /Discard} [/CheckIntegrity] [/Append]

Parámetro	Descripción
/CheckIntegrity	Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se usa con operaciones de captura, desmontaje, exportación y confirmación. /CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con operaciones de aplicar y montar.
/Append	Agrega la imagen modificada al archivo .wim existente en lugar de sobrescribir la imagen original. Los argumentos /CheckIntegrity y /Append no se aplican a los discos duros virtuales (VHD, VHDX), ni a los archivos FFU.

Ejemplos:

Dism /Unmount-Image /MountDir:C:\test\offline /commit

Dism /Unmount-Image /MountDir:C:\test\offline /discard

/Update-WIMBootEntry

Actualiza la entrada de configuración WIMBoot, asociada al id. de origen de datos especificado, con el archivo de imagen con el nombre cambiado o la ruta de acceso al archivo de imagen movida.

Nota: /Update-WIMBootEntry requiere un reinicio para que las actualizaciones surtan efecto.

Sintaxis:

Dism /Update-WIMBootEntry /Path:<Volume_path> /DataSourceID:<Data_source_id> /ImageFile:<Renamed_image_path>

Parámetro	Descripción
/Path	Especifica el volumen de disco de la configuración de WIMBoot.
/DataSourceID	Especifica el id. del origen de datos tal y como lo muestra /Get-WIMBootEntry.

Ejemplo:

DISM.exe /Update-WIMBootEntry /Path:C:\ /DataSourceID:0 /ImageFile:R:\Install.wim

/Apply-SiloedPackage

Aplica uno o más paquetes de aprovisionamiento en silo (SPP) a una imagen especificada. Esta opción solo está disponible tras ejecutar CopyDandI.cmd desde el ADK, versión 1607 o posterior, y ejecutar dism.exe /Apply-SiloedPackage desde la carpeta de destino creada por CopyDandI.cmd.

Nota

/Apply-SiloedPackage solo puede ejecutarse una vez en una imagen de Windows, pero /PackagePath puede usarse más de una vez en el mismo comando para aplicar varios SPP. Los SPP se aplicarán en el orden especificado, por lo que una dependencia debe especificarse antes que la SPP que depende de ella.

Para más información sobre los paquetes de provisión en silo y cómo usar CopyDandI.cmd, consulte Paquetes de aprovisionamiento en silo.

Para saber cómo trabajar con paquetes de aprovisionamiento en silos, consulte Laboratorio 10: Agregar aplicaciones y configuraciones de escritorio con paquetes de aprovisionamiento en silo (SPP).

/Apply-SiloedPackage /PackagePath:<package_path> /ImagePath:<applied_image_path>

Parámetro	Descripción
/PackagePath	Especifica la ruta de acceso de un archivo de paquete de aprovisionamiento en silo.
/ImagePath	Especifica la ruta de acceso de la imagen de Windows en la que está aplicando el SPP.

Ejemplo:

Dism.exe /apply-SiloedPackage /PackagePath:C:\test\Word.spp /PackagePath:C:\test\spp2.spp /ImagePath:C:\

DISM: Referencia técnica de Administración y mantenimiento de imágenes de implementación para Windows

¿Qué es DISM?

Opciones globales de DISM para la sintaxis de la línea de comandos

Implemente Windows usando Actualización flash completa (FFU)

WIM frente a VHD frente a FFU: comparación de formatos de archivo de imagen

Compartir a través de

Opciones de la línea de comandos de Administración de imágenes de DISM

/Append-Image

/Apply-FFU

/Apply-Image

/Capture-CustomImage

/Capture-FFU

/Capture-Image

/Cleanup-Mountpoints

/Commit-Image

/Delete-Image

/Export-Image

/Get-ImageInfo

/Get-MountedImageInfo

/Get-WIMBootEntry

/List-Image

/Mount-Image

/Optimize-FFU

/Optimize-Image

/Remount-Image

/Split-FFU

/Split-Image

/Unmount-Image

/Update-WIMBootEntry

/Apply-SiloedPackage

Recursos adicionales

Compartir a través de

Opciones de la línea de comandos de Administración de imágenes de DISM

/Append-Image

/Apply-FFU

/Apply-Image

/Capture-CustomImage

/Capture-FFU

/Capture-Image

/Cleanup-Mountpoints

/Commit-Image

/Delete-Image

/Export-Image

/Get-ImageInfo

/Get-MountedImageInfo

/Get-WIMBootEntry

/List-Image

/Mount-Image

/Optimize-FFU

/Optimize-Image

/Remount-Image

/Split-FFU

/Split-Image

/Unmount-Image

/Update-WIMBootEntry

/Apply-SiloedPackage

Temas relacionados

Recursos adicionales