New-WindowsImage

New-WindowsImage

Captures an image of a drive to a new WIM file.

Sintaxis

Parameter Set: Default
New-WindowsImage -CapturePath <String> -ImagePath <String> -Name <String> [-CheckIntegrity] [-CompressionType <String> ] [-ConfigFilePath <String> ] [-Description <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-NoRpFix] [-ScratchDirectory <String> ] [-Setbootable] [-Verify] [-WIMBoot] [ <CommonParameters>]

Descripción detallada

The New-WindowsImage cmdlet captures an image of a drive to a new WIM file. Captured directories include all subfolders and data. You cannot capture an empty directory. A directory must contain at least one file.

This cmdlet does not apply to virtual hard disk (VHD) files.

Parámetros

-CapturePath<String>

Specifies the drive or path to the Windows operating system that is to be captured to an image file.

-CheckIntegrity

Detecta y realiza un seguimiento de los daños en el archivo .wim cuando se utiliza con los cmdlets Add-WindowsImage, Dismount-WindowsImage o Save-WindowsImage. CheckIntegrity detiene la operación si DISM detecta que el archivo .wim está dañado cuando se usa con los cmdlets Expand-WindowsImage o Mount-WindowsImage.

-CompressionType<String>

-ConfigFilePath<String>

Specifies the location of a configuration file that lists exclusions for image capture commands and compress commands. For more information, see DISM Configuration List and WimScript.ini Files, https://go.microsoft.com/fwlink/?LinkID=313768.

-Description<String>

Specifies the description of the image to be captured.

-ImagePath<String>

Specifies the location of a WIM file.

-LogLevel<LogLevel>

Especifica el nivel de salida máximo que se muestra en los registros. El nivel de registro predeterminado es 3. Los valores aceptados son los siguientes:1 = Solo errores2 = Errores y advertencias3 = Errores, advertencias e información4 = Todo lo anterior junto con la salida de depuración

-LogPath<String>

Especifica la ruta de acceso completa y el nombre de archivo en el que se registrará. Si no se establece, el valor predeterminado es %WINDIR%\Logs\Dism\dism.log.En Windows PE, el directorio predeterminado es el espacio de desecho de RAMDISK que puede tener un mínimo de 32 MB. El archivo de registro se archivará automáticamente. El archivo de registro se guardará con la extensión .bak anexada al nombre de archivo y se generará un nuevo archivo de registro. Cada vez que se almacene el archivo de registro, se sobrescribirá el archivo .bak. Cuando use un recurso compartido de red que no esté unido a un dominio, utilice el comando net use junto con las credenciales de dominio para establecer permisos de acceso antes de establecer la ruta de acceso de registro para el registro DISM.

-Name<String>

Specifies the name of an image in a WIM file.

-NoRpFix

Deshabilita la corrección de etiquetas de puntos de repetición de análisis. Un punto de repetición de análisis es un archivo que contiene un vínculo a otro archivo del sistema de archivos. Si no se especifica el parámetro, no se capturarán los puntos de repetición de análisis que se resuelven en rutas de acceso fuera del valor que especifica el parámetro ImagePath.

-ScratchDirectory<String>

Especifica un directorio temporal que se usará al extraer los archivos que se utilizarán durante el mantenimiento. El directorio debe existir localmente. Si no se especifica, se usará el directorio \Windows\%Temp% con un nombre de subdirectorio de valor hexadecimal generado aleatoriamente para cada ejecución de DISM. Los elementos del directorio temporal se eliminan después de cada operación. No se debe usar una ubicación de recurso compartido de red como directorio temporal para expandir un paquete (archivo .cab o .msu) para la instalación. El directorio que se utilice para extraer los archivos para el uso temporal durante el mantenimiento debe ser un directorio local.

-Setbootable

Marca una imagen de volumen como una imagen de arranque. Este argumento solo está disponible para imágenes de Windows PE. Solo se puede marcar una imagen de volumen como de arranque en un archivo .wim.

-Verify

Busca errores y duplicaciones de archivos. Durante una operación de aplicación, por ejemplo, mediante el cmdlet Add-WindowsImage, el tamaño y el hash del archivo que se está aplicando se comparan con el archivo de imagen para comprobar que son iguales. Durante una operación de captura, por ejemplo, cuando se usa el cmdlet New-WindowsImage, tras capturar los archivos en una imagen de Windows, el archivo se escribe en un archivo temporal y se compara bit a bit con el archivo original.

-WIMBoot

Specifies that the image will be formatted to install on a Windows Image Format Boot (WIMBoot) system.

<CommonParameters>

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

• System.String[]
• Microsoft.Dism.Commands.ImageObject
• Microsoft.Dism.Commands.ImageObjectWithState

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

• Microsoft.Dism.Commands.OfflineImageObject

Ejemplos

Example 1

This command captures the Drive D image in the WIM file located on d:\ and save to the file c:\imagestore\custom.wim.

PS C:\> New-WindowsImage -ImagePath c:\imagestore\custom.wim -CapturePath d:\ -Name "Drive D"

Temas relacionados

Dismount-WindowsImage

Expand-WindowsImage

Export-WindowsImage

Get-WindowsImage

Mount-WindowsImage

New-WindowsImage

Remove-WindowsImage

Repair-WindowsImage

Save-WindowsImage

Split-WindowsImage