Expand-WindowsImage

Expand-WindowsImage

Applies an image to a specified location.

Sintaxis

Parameter Set: InputByFilePathAndIndex
Expand-WindowsImage -ApplyPath <String> -ImagePath <String> -Index <UInt32> [-CheckIntegrity] [-ConfirmTrustedFile] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-NoRpFix] [-ScratchDirectory <String> ] [-SplitImageFilePattern <String> ] [-Verify] [-WIMBoot] [ <CommonParameters>]

Parameter Set: InputByFilePathAndName
Expand-WindowsImage -ApplyPath <String> -ImagePath <String> -Name <String> [-CheckIntegrity] [-ConfirmTrustedFile] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-NoRpFix] [-ScratchDirectory <String> ] [-SplitImageFilePattern <String> ] [-Verify] [-WIMBoot] [ <CommonParameters>]

Descripción detallada

The Expand-WindowsImage cmdlet applies an image to a specified location.

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

Parámetros

-ApplyPath<String>

Specifies the location where the image is to be applied.

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

-ConfirmTrustedFile

Validates the image for Trusted Desktop on a Windows® 8 or Windows® 8,1. This option can only be run on a computer running at least Entorno de preinstalación de Windows® (Windows PE) 4.0.

-ImagePath<String>

Specifies the location of a WIM file.

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

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

-SplitImageFilePattern<String>

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

-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 offline image to be added 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 applies an image at index 1 in the c:\imagestore\custom.wim file to partition d:.

PS C:\> Expand-WindowsImage -ImagePath c:\imagestore\custom.wim -ApplyPath d:\ -Index 1

Example 2

This command applies the split image with a name that matches c:\imagestore\split\custom*.swm with a name of Windows Pro to partition d:. Check for errors and file duplication while applying the image.

PS C:\> Expand-WindowsImage -ImagePath c:\imagestore\split\custom.swm -SplitImageFilePattern c:\imagestore\split\custom*.swm -ApplyPath d:\ -Name "Windows Pro" -Verify

Temas relacionados

Dismount-WindowsImage

Expand-WindowsImage

Export-WindowsImage

Get-WindowsImage

Mount-WindowsImage

New-WindowsImage

Remove-WindowsImage

Repair-WindowsImage

Save-WindowsImage

Split-WindowsImage