Remove-WindowsImage

Remove-WindowsImage

Deletes the specified volume image from a WIM file that has multiple volume images.

Sintaxis

Parameter Set: InputByFilePathAndIndex
Remove-WindowsImage -ImagePath <String> -Index <UInt32> [-CheckIntegrity] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [ <CommonParameters>]

Parameter Set: InputByFilePathAndName
Remove-WindowsImage -ImagePath <String> -Name <String> [-CheckIntegrity] [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [ <CommonParameters>]

Descripción detallada

The Remove-WindowsImage cmdlet deletes the specified volume image from a WIM file that has multiple volume images. This cmdlet deletes only the metadata entries and XML entries. It does not delete the stream data and does not optimize the WIM file.

This command-line option 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.

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

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

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

Ejemplos

Example 1

This command removes the first image in c:\imagestore\custom.wim.

PS C:\> Remove-WindowsImage -ImagePath c:\imagestore\custom.wim -Index 1 -CheckIntegrity

Example 2

This command removes the image named Starter that is located in c:\imagestore\custom.wim.

PS C:\> Remove-WindowsImage -ImagePath c:\imagestore\custom.wim -Name "Starter" -CheckIntegrity

Temas relacionados

Add-WindowsImage

Dismount-WindowsImage

Expand-WindowsImage

Export-WindowsImage

Get-WindowsImage

Mount-WindowsImage

New-WindowsImage

Repair-WindowsImage

Save-WindowsImage

Split-WindowsImage