Export-WindowsImage

Export-WindowsImage

Exports a copy of the specified image to another image file.

Sintaxis

Parameter Set: InputByFilePathAndIndex
Export-WindowsImage -DestinationImagePath <String> -SourceImagePath <String> -SourceIndex <UInt32> [-CheckIntegrity] [-CompressionType <String> ] [-DestinationName <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [-Setbootable] [-SplitImageFilePattern <String> ] [-WIMBoot] [ <CommonParameters>]

Parameter Set: InputByFilePathAndName
Export-WindowsImage -DestinationImagePath <String> -SourceImagePath <String> -SourceName <String> [-CheckIntegrity] [-CompressionType <String> ] [-DestinationName <String> ] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [-Setbootable] [-SplitImageFilePattern <String> ] [-WIMBoot] [ <CommonParameters>]

Descripción detallada

The Export-WindowsImage cmdlet exports a copy of the specified image to another image file. The source and destination files must use the same compression type.

You can also optimize an image by exporting to a new image file with Export-WindowsImage. When you modify an image, DISM stores additional resource files that increase the overall size of the image. Exporting the image will remove unnecessary resource files.

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

Parámetros

-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.

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-CompressionType<String>

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-DestinationImagePath<String>

Specifies the location of the exported image file.

Alias

DIP

¿Requerido?

true

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-DestinationName<String>

Specifies the name of the exported image in the exported image file.

Alias

DN

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-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

Alias

LL

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-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.

Alias

LP

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-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.

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-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.

Alias

SB

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-SourceImagePath<String>

Specifies the location of the source image file.

Alias

SIP

¿Requerido?

true

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-SourceIndex<UInt32>

Especifica el número de índice de una imagen de Windows en un archivo WIM o VHD. Para un archivo VHD, el índice debe ser 1.

Alias

SI

¿Requerido?

true

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-SourceName<String>

Specifies the name of the source image in the source image file.

Alias

SN

¿Requerido?

true

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-SplitImageFilePattern<String>

Especifica la ubicación y el nombre del archivo base de imagen dividido.

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

-WIMBoot

Specifies that the image will be formatted to install on a Windows image file boot (WIMBoot) system.

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

True (ByPropertyName)

¿Aceptar caracteres comodín?

false

<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 exports the image at Index 1 of the file C:\imagestore\custom.wim to the file c:\imagestore\export.wim with the name Exported Image.

PS C:\> Export-WindowsImage -SourceImagePath C:\imagestore\custom.wim -SourceIndex 1 -DestinationImagePath c:\imagestore\export.wim -DestinationName "Exported Image"

Temas relacionados

Dismount-WindowsImage

Expand-WindowsImage

Export-WindowsImage

Get-WindowsImage

Mount-WindowsImage

New-WindowsImage

Remove-WindowsImage

Repair-WindowsImage

Save-WindowsImage

Split-WindowsImage