ImageX es una herramienta de línea de comandos de Windows Vista que puede usar para crear y administrar archivos de imagen de Windows (.wim). Un archivo .wim contiene una o más imágenes de volumen, que son volúmenes de disco que contienen imágenes de un sistema operativo Windows instalado.
Para modificar las imágenes de volumen, debe instalar el controlador Filtro de sistema de archivos de Windows Imaging (filtro WIM FS) en un equipo que ejecute Windows XP con el Service Pack 2 (SP2), Windows Server 2003 con el Service Pack 1 (SP1) o Windows Vista. La instalación de este controlador permite montar un archivo .wim como si fuera un directorio, así como buscar, copiar, pegar y editar las imágenes de volumen con una herramienta de administración de archivos, como el Explorador de Windows, sin necesidad de extraer o volver a crear la imagen.
Importante |
|
Debe ejecutar cada una de estas opciones de línea de comandos de forma individual. Si no proporciona una ubicación para el archivo .wim capturado, el proceso lo crea automáticamente en el directorio de ImageX. Por ejemplo, si especifica Data.wim en lugar de D:\Imaging\Data.wim cuando utilice la opción /capture, aparecerá el archivo Data.wim en el directorio ImageX. |
Opciones de línea de comandos de ImageX
Las opciones de línea de comandos de ImageX usan las siguientes convenciones.
imagex [marcadores] {/append | /apply | /capture | /delete | /dir | /export | /info | /split | /mount | /mountrw | /unmount} [parámetros]
En la siguiente lista se muestra la sintaxis válida usada para cada tipo de operación de imagex.
imagex /append
rutaDeAccesoDeImagen archivoDeImagen {"descripción"} {/boot | /check | /configarchivoDeConfiguración.ini | /scroll | /verify}
imagex /apply
archivoDeImagen númeroDeImagen
nombreDeImagen rutaDeAccesoDeImagen {/check | /ref | /scroll | /verify}
imagex /capture
rutaDeAccesoDeImagen archivoDeImagen"name" {"descripción"} {/boot | /check | /compress [tipo] | /config | /flags "IDDeEdición" | /norpfix | /scroll | /verify}
imagex /delete
archivoDeImagen númeroDeImagen
nombreDeImagen {/check}
imagex /dir
archivoDeImagen númeroDeImagen
nombreDeImagen
imagex /export
archivoDeOrigen númeroDeOrigen
nombreDeOrigen archivoDeDestino nombreDeDestino {/boot | /check | /compress [tipo] | /ref [splitwim.swm]}
imagex /info
archivoDeImagen[númeroDeImagen | nombreDeImagen] [nombreNuevo] [descripciónNueva] {/boot | /check}
imagex /mount
archivoDeImagen númeroDeImagen
nombreDeImagen rutaDeAccesoDeImagen {/check}
imagex /mountrw
archivoDeImagen númeroDeImagen
nombreDeImagen rutaDeAccesoDeImagen {/check}
imagex /split
archivoDeImagen tamañoDelArchivoDeDestino {/check}
imagex /unmount
rutaDeAccesoDeImagen {/commit}
|
Operación
|
Descripción
|
|
imagex /append
rutaDeAccesoDeImagen archivoDeImagen {"descripción"} {/boot | /check | /configarchivoDeConfiguración.ini | /scroll | /verify}
|
Anexa una imagen de volumen a un archivo de imagen de Windows (.wim) existente. Crea una única instancia del archivo, comparándola con los recursos que ya existen en el archivo .wim, de forma que no se capture el mismo archivo dos veces.
Importante |
|
Debe ejecutar esta opción desde el Entorno de preinstalación de Windows (Windows PE). Además, debe asegurarse de que dispone de espacio en disco suficiente para ejecutar la opción /append. Si se acaba el espacio en disco mientras utiliza la opción /append, puede que se dañe el archivo .wim anexado. |
Importante |
|
El archivo .wim sólo puede tener un tipo de compresión asignado; por consiguiente, sólo puede anexar archivos con el mismo tipo de compresión. |
rutaDeAccesoDeImagen
Especifica el nombre y la ubicación del archivo .wim existente que se anexará.
archivoDeImagen
Especifica el nombre y la ubicación de la imagen de volumen que se anexa el archivo existente.
"descripción"
Especifica el texto en el que se ofrece información de referencia adicional. Se requieren comillas rectas.
También puede establecer las opciones siguientes:
/boot
Marca una imagen de volumen como de arranque. Esta opción sólo se aplica a imágenes de Windows PE. En un archivo .wim sólo se puede marcar una imagen de volumen como de arranque.
/check
Comprueba la integridad del archivo .wim. Si no se proporciona, se quitan las comprobaciones existentes.
/config
archivoDeConfiguración.ini
Especifica el nombre y la ubicación del archivo de configuración. Puede cambiar el nombre de este archivo según corresponda.
/scroll
Desplaza la salida para redirigirla.
/verify
Habilita la comprobación de los recursos de archivos: busca errores y duplicación de archivos.
Por ejemplo:
imagex /append d: d:\imaging\datos.wim "Unidad D" /verify
|
|
imagex /apply
archivoDeImagen númeroDeImagen
nombreDeImagenrutaDeAccesoDeImagen {/check | /ref | /scroll | /verify}
|
Aplica una imagen de volumen a una unidad de disco especificada.
Importante |
|
Debe ejecutar esta opción desde Windows PE. |
archivoDeImagen
Especifica el nombre y la ubicación de la imagen de volumen que se aplica al directorio.
númeroDeImagen
Especifica el número que hace referencia al volumen específico en el archivo .wim.
nombreDeImagen
Especifica el nombre que identifica a la imagen en el archivo .wim.
rutaDeAccesoDeImagen
Especifica la ruta de acceso del archivo en el que se aplicará la imagen.
Debe crear todas las particiones de disco duro antes de empezar este proceso, a menos que ejecute esta opción mediante un script. Si usa la opción /apply para una estructura de directorios, la opción incluirá el directorio especificado, incluidos todos los subdirectorios y archivos.
Importante |
|
Debe incluir el directorio principal para la opción /apply. De lo contrario, al aplicar la imagen se sobrescribirá todo el contenido de la ubicación. Por ejemplo, si aplica la imagen a la unidad C, la opción /apply sobrescribirá todo lo que exista en esta unidad con los archivos de imagen.
Para automatizar la creación de un directorio, debe agregar el comando mkdirdirectorioDeDestino al script antes de ejecutar imagex /apply. |
También puede establecer las opciones siguientes:
/check
Comprueba la integridad del archivo .wim. Si no se especifica, se eliminarán las comprobaciones existentes.
/ref
wimDividido.swm
Habilita la referencia de archivos .wim divididos (SWM). wimDividido.swm es el nombre y la ubicación de los archivos divididos adicionales. Se aceptan caracteres comodín.
/scroll
Desplaza el resultado de la redirección.
/verify
Habilita la comprobación de errores y duplicación de archivos en recursos de archivo.
Por ejemplo:
imagex /apply d:\imaging\datos.wim 1 d:\directorioNuevo /verify
|
|
imagex /capture
rutaDeAccesoDeImagen archivoDeImagen"name" {"descripción"} {/boot | /check | /compress [tipo] | /config | /flags "IDDeEdición" | /norpfix | /scroll | /verify}
|
Captura una imagen de volumen desde una unidad de disco en un archivo .wim nuevo. 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.
Nota |
|
ImageX no admite atributos extendidos. ImageX ignorará los atributos extendidos durante una operación de captura. |
Durante la operación de captura, se aplica automáticamente la compresión rápida. Si requiere otro tipo de compresión, utilice la opción /compress.
rutaDeAccesoDeImagen
Especifica el nombre y la ubicación de la imagen de volumen para su captura.
archivoDeImagen
Especifica el nombre y la ubicación del archivo .wim nuevo.
"nombre"
Especifica el nombre del archivo .wim nuevo. Este valor es obligatorio. Las comillas rectas son obligatorias.
"descripción"
Especifica el texto en el que se ofrece información de referencia adicional. Este valor es opcional. Las comillas rectas son obligatorias.
También puede configurar las opciones siguientes:
/boot
Marca una imagen de volumen como de arranque. Sólo está disponible para imágenes de Windows PE. En un archivo .wim sólo se puede marcar una imagen de volumen como de arranque.
/check
Comprueba la integridad del archivo .wim. Si no se especifica, se eliminarán las comprobaciones existentes.
/compress [maximum | fast | none]
Especifica el tipo de compresión que se usa en la operación de captura inicial. La opción maximum proporciona la mejor compresión, pero tarda más tiempo en capturar la imagen. La opción fast proporciona una compresión de imagen más rápida, pero los archivos resultantes son más grandes que los comprimidos con la opción maximum. Además, es el tipo de compresión predeterminado y se usa si deja el parámetro en blanco. La opción none no comprime la imagen capturada.
Nota |
|
El tipo de compresión que elija afecta al tiempo de captura, pero sólo afecta levemente al tiempo de aplicación. |
/config
archivoDeConfiguración.ini
Especifica el nombre y la ubicación del archivo de configuración. Puede cambiar el nombre de este archivo según corresponda.
Nota |
|
Si cambia el nombre del archivo listaDeConfiguración.ini file a Wimscript.ini y lo almacena en el directorio de ImageX (donde se encuentra el archivo ImageX.exe), se ejecutará automáticamente al ejecutar la opción /capture, sin que resulte necesario usar la opción /config. |
/flags "IDDeEdición"
Especifica la versión de Windows que está a punto de capturar. El valor /flags es obligatorio si se va a implementar de nuevo un archivo Install.wim personalizado con la instalación de Windows. Se requieren comillas rectas. Este marcador no es obligatorio si se implementa la imagen con ImageX. Entre los tipos válidos de Id. de edición se incluyen los siguientes:
HomeBasic
HomePremium
Starter
Ultimate
Business
Enterprise
ServerDatacenter
ServerEnterprise
ServerStandard
/norpfix
Deshabilita la reparación de etiquetas de punto de análisis. Si se selecciona, no se capturarán los puntos de análisis que se resuelven en rutas de acceso fuera de rutaDeAccesoDeImagen.
/scroll
Desplaza el resultado de la redirección.
/verify
Habilita la comprobación de errores y duplicación de archivos en recursos de archivo.
Nota |
|
La opción /verify afectará al tiempo de captura global. Durante una operación de captura, la barra de progreso indica sólo el estado de la operación de captura, no el de la operación de comprobación. Una vez completada la captura, se inicia el proceso de comprobación. Este proceso lleva tiempo aunque la barra de progreso indique el 100%. |
Por ejemplo:
imagex /capture d: d:\imaging\data.wim "Drive D" /verify
imagex /compress fast /flags "Ultimate" /check /scroll /capture c: d:\install.wim "Windows Vista Ultimate"
|
|
imagex /delete
archivoDeImagennúmeroDeImagennombreDeImagen{/check}
|
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.
Una vez montado el archivo, puede ver, pero no modificar, toda la información incluida en el directorio. Si no especifica los parámetros que se deben montar, esta opción mostrará una lista de todas las imágenes montadas.
archivoDeImagen
Especifica el nombre y la ubicación del archivo .wim especificado para su eliminación.
númeroDeImagen
Especifica el número que hace referencia al volumen específico en el archivo .wim.
Importante |
|
Debe ejecutar esta opción desde Windows PE. Como mínimo, debe haber siempre una imagen de volumen en un archivo .wim; sólo podrá eliminar una imagen de volumen si hay más de una imagen. |
nombreDeImagen
Especifica el nombre que hace referencia a la imagen en el archivo .wim.
También puede establecer la opción siguiente:
/check
Comprueba la integridad del archivo .wim. Si no se especifica, se eliminarán las comprobaciones existentes.
Por ejemplo:
imagex /delete d:\imaging\datos.wim 1
|
|
imagex /dir
archivoDeImagennúmeroDeImagennombreDeImagen
|
Muestra una lista de los archivos y las carpetas incluidos en una imagen de volumen especificada.
archivoDeImagen
Especifica el nombre y la ubicación de la imagen de volumen para su revisión. Si no proporciona una imagen de volumen, esta opción devuelve una lista de directorios de todas las imágenes de volumen incluidas en el archivo .wim.
númeroDeImagen
Especifica el número que hace referencia al volumen específico en el archivo .wim.
nombreDeImagen
Especifica el nombre que hace referencia a la imagen en el archivo .wim.
Por ejemplo:
imagex /dir d:\imaging\datos.wim 1
|
|
imagex /export
archivoDeOrigennúmeroDeOrigennombreDeOrigen archivoDeDestino nombreDeDestino {/boot | /check | /compress [tipo] | /ref [splitwim.swm]}
|
Exporta una copia del archivo .wim especificado a otro archivo .wim. 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, ImageX 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.
Importante |
|
Debe ejecutar esta opción desde Windows PE. Además, debe asegurarse de que dispone de espacio en disco suficiente para ejecutar la opción /export. Si se queda sin espacio en disco durante la ejecución de la opción /export, puede dañar el archivo .wim de destino. |
archivoDeOrigen
Especifica la ruta de acceso del archivo .wim que contiene la imagen que se copiará
númeroDeOrigen
Especifica el número que hace referencia al volumen específico en el archivo .wim.
nombreDeOrigen
Especifica el nombre que identifica a la imagen en el archivo .wim de origen.
archivoDeDestino
Especifica la ruta de acceso del archivo .wim que recibe la copia de la imagen.
nombreDeDestino
Especifica el nombre único de la imagen del archivo .wim de destino.
También puede configurar las opciones siguientes:
/boot
Marca una imagen de volumen como de arranque. Sólo está disponible para las imágenes de Windows PE. En un archivo .wim sólo se puede marcar una imagen de volumen como de arranque.
/check
Comprueba la integridad del archivo .wim. Si no se especifica, se eliminarán las comprobaciones existentes.
/compress [maximum | fast | none]
Especifica el tipo de compresión utilizado para la operación de captura inicial. La opción maximum proporciona la mejor compresión, pero es la que tarda más en capturar la imagen. La opción fast proporciona una compresión de imagen más rápida, pero los archivos resultantes son más grandes que los comprimidos con la opción maximum. Se trata también del tipo de compresión predeterminado, que se utiliza si se deja este parámetro en blanco. La opción none no comprime la imagen capturada en absoluto.
/ref
splitwim.swm
Habilita la referencia de archivos .wim divididos (SWM). wimDividido.swm es el nombre y la ubicación de los archivos divididos adicionales. Se aceptan caracteres comodín.
Por ejemplo:
imagex /export d:\imaging\datos.wim d:\imaging\ejemplo.wim 1
|
|
imagex /info
archivoDeImagen[númeroDeImagen | nombreDeImagen] [nombreNuevo] [descripciónNueva] {/boot | /check}
|
Devuelve las descripciones XML almacenadas para el archivo .wim especificado, incluidos, entre otros, el tamaño total del archivo, el número de índice de la imagen, el recuento de directorios, el recuento de archivos y una descripción.
archivoDeImagen
Especifica el nombre y la ubicación del archivo .wim para la revisión de datos XML.
númeroDeImagen
Especifica el número que identifica una imagen en el archivo .wim.
nombreDeImagen
Especifica el nombre que identifica una imagen en el archivo .wim.
nombreNuevo
Especifica el nombre único nuevo de la imagen especificada.
descripciónNueva
Especifica la descripción nueva de la imagen especificada.
También puede configurar las opciones siguientes:
/boot
Marca una imagen de volumen como de arranque. Sólo está disponible para las imágenes de Windows PE. En un archivo .wim sólo se puede marcar una imagen de volumen como de arranque.
/check
Comprueba la integridad del archivo .wim. Si no se especifica, se eliminarán las comprobaciones existentes.
Por ejemplo:
imagex /info d:\imaging\datos.wim
|
|
imagex /mount
archivoDeImagennúmeroDeImagennombreDeImagenrutaDeAccesoDeImagen {/check}
|
Monta un archivo .wim a partir de Windows XP con el Service Pack 2 (SP2), Windows Server 2003 con el Service Pack 1 (SP1) o Windows Vista con permiso de sólo lectura en un directorio especificado.
Una vez montado el archivo, puede ver, pero no modificar, toda la información incluida en el directorio.
Importante |
|
Debe instalar el filtro WIM FS para poder montar una imagen. |
archivoDeImagen
Especifica la ruta del archivo .wim que contiene la imagen especificada.
númeroDeImagen
Especifica el número que hace referencia al volumen específico en el archivo .wim.
nombreDeImagen
Especifica el nombre que hace referencia a la imagen en el archivo .wim.
rutaDeAccesoDeImagen
Especifica la ruta de acceso del archivo en el que se montará la imagen especificada.
También puede establecer el marcador siguiente:
/check
Comprueba la integridad del archivo .wim. Si no se especifica, se eliminarán las comprobaciones existentes.
Por ejemplo:
imagex /mount d:\imaging\datos.wim 2 c:\imágenesMontadas
|
|
imagex /mountrw
archivoDeImagen
númeroDeImagen
nombreDeImagen
rutaDeAccesoDeImagen {/check}
|
Monta un archivo .wim a partir de Windows XP con el Service Pack 2 (SP2), Windows Server 2003 con el Service Pack 1 (SP1) o Windows Vista con permiso de lectura y escritura en un directorio especificado.
Una vez montado el archivo, puede ver y modificar toda la información incluida en el directorio.
Importante |
|
Debe instalar el filtro WIM FS para poder montar una imagen. |
La opción /mountrw requiere acceso exclusivo al archivo .wim; por lo tanto, no se puede utilizar la opción /mountrw si hay una imagen montada que utiliza la opción /mount o /mountrw.
Importante |
|
No se debe montar una imagen en el directorio principal o los subdirectorios de un directorio ya montado. Al montar una imagen en un directorio que contiene archivos, los archivos existentes se enmascararán hasta que ejecute la opción /unmount. Asimismo, no debe montar la imagen en carpetas reservadas para Windows. |
archivoDeImagen
Especifica el nombre y la ubicación del archivo .wim que se montará con permiso de lectura y escritura.
númeroDeImagen
Especifica el número que hace referencia al volumen específico en el archivo .wim.
nombreDeImagen
Especifica el nombre que hace referencia a la imagen en el archivo .wim.
rutaDeAccesoDeImagen
Especifica la ruta de acceso del archivo en el que se montará la imagen especificada.
También puede configurar la opción siguiente:
/check
Comprueba la integridad del archivo .wim. Si no se especifica, se eliminarán las comprobaciones existentes.
Por ejemplo:
imagex /mountrw d:\imaging\datos.wim 2 c:\imágenesMontadas
|
|
imagex /split
archivoDeImagen
tamañoDelArchivoDeDestino {/check}
|
Divide un archivo .wim existente en varios archivos .wim divididos de sólo lectura (.swm).
Importante |
|
Debe ejecutar esta opción desde Windows PE. |
archivoDeImagen
Especifica el nombre y la ubicación del archivo .wim que se dividirá.
archivoDeDestino
Especifica la ruta de acceso de los archivos divididos.
tamaño
Especifica el tamaño máximo en megabytes (MB) de cada archivo creado.
Esta opción genera los archivos .swm en el directorio especificado y asigna a cada archivo el mismo nombre que el archivoDeImagen indicado, pero con un número anexado y con la extensión de nombre de archivo .swm. Por ejemplo, si decide dividir un archivo denominado Datos.wim, esta opción crea un archivo Datos.swm, un archivo Datos2.swm, un archivo Datos3.swm, y así sucesivamente, que definen cada parte del archivo .wim dividido.
También puede establecer la opción siguiente:
/check
Comprueba la integridad del archivo .wim. Si no se especifica, se eliminarán las comprobaciones existentes.
Por ejemplo:
imagex /split d:\imaging\datos.wim 600
|
|
imagex /unmount
rutaDeAccesoDeImagen {/commit}
|
Desmonta la imagen montada desde un directorio especificado.
Importante |
|
Confirme que dispone de espacio en disco duro suficiente para agregar los archivos de la imagen. Debe tener en cuenta la suma del tamaño de los archivos que agregará al archivo .wim y el aumento en el tamaño debido a la modificación de los archivos existentes, y restar a esta cantidad los archivos eliminados, antes de ejecutar la opción /commit. Si no dispone de espacio en disco duro suficiente, se producirá un error. |
rutaDeAccesoDeImagen
Especifica la ubicación de directorio completa para desmontar los archivos. Si no especifica ningún directorio, esta opción mostrará una lista de todas las imágenes montadas.
Importante |
|
Si usa la opción /unmount sin la opción /commit, se descartarán los cambios. Para poder guardar los cambios, debe montar la imagen con la opción /mountrw y usar la opción /commit al desmontar la imagen. |
Por ejemplo:
imagex /unmount /commit c:\imágenesMontadas
|
Opciones /verify y /check
Las opciones /verify y /check ofrecen funciones de verificación de archivos e integridad de datos para archivos .wim.
La opción /verify comprueba las escrituras en caché y busca errores y archivos duplicados. La opción /verify no admite el vaciado de discos, la escritura simultánea ni la omisión del almacenamiento en caché del sistema. Durante una operación de captura, la opción /verify vuelve a leer el archivo capturado y lo compara, byte por byte, con el archivo capturado original. Durante una operación de aplicación, la opción /verify vuelve a usar algoritmos hash en el archivo aplicado y lo compara con el hash generado durante una operación de captura.
La opción /check sirve para detectar daños en un archivo .wim. Si no se establece la opción /check durante una operación de captura, el marcador de pasa por alto durante una operación de aplicación. Durante una operación de captura, la opción /check genera y almacena una serie de hash por cada bloque de datos de 10 megabytes (MB) del archivo .wim. Durante una operación de aplicación, la opción /check usa algoritmos hash y compara los bloques de 10 MB con los hash almacenados durante la operación de captura.
Las opciones /verify y /check afectarán al rendimiento durante las operaciones de aplicación. Se recomienda que utilice tanto la opción /verify como la opción /check para lograr una validación de imágenes y una integridad de datos óptimas.
Códigos de error de ImageX
|
Código de error
|
Descripción
|
|
0
|
Correcto
|
|
1
|
Opción de línea de comandos no válida
|
|
2
|
Error WIMGAPI
|
|
3
|
Script de configuración no válido
|
|
4
|
Acceso denegado, requiere privilegios de administrador
|
Vea también