PowerShell Logo Small

Mount-WindowsImage



This is the built-in help made by Microsoft for the command 'Mount-WindowsImage', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Mounts a Windows image in a WIM or VHD file to a directory on the local computer.

SYNTAX


Mount-WindowsImage [-CheckIntegrity] [-LogLevel <LogLevel>] [-LogPath <String>] [-Optimize] [-ReadOnly] [-ScratchDirectory <String>] -ImagePath <String> -Index <UInt32>
-Path <String> [<CommonParameters>]
Mount-WindowsImage [-CheckIntegrity] [-LogLevel <LogLevel>] [-LogPath <String>] [-Optimize] [-ReadOnly] [-ScratchDirectory <String>] -ImagePath <String> -Name <String> -Path
<String> [<CommonParameters>]
Mount-WindowsImage [-LogLevel <LogLevel>] [-LogPath <String>] [-ScratchDirectory <String>] -Path <String> -Remount [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Mount-WindowsImage cmdlet maps a Windows image in a WIM or VHD file to the specified directory so that it is accessible for servicing.


The Path parameter specifies the location where you want to mount the Windows image.


The ImagePath parameter specifies the location of the WIM or VHD file containing the Windows image you want to mount.


Use the Index or Name parameter to specify which image in a WIM or VHD file that you want to mount. For a VHD file, the Index must be 1.


The Optimize parameter reduces the amount of time it takes to initially mount the image. However, processes that are ordinarily performed during a mount will instead be
completed the first time that you access a directory. As a result, there may be an increase in the time that is required to access a directory for the first time after
mounting an image using the optimize parameter.


The Remount parameter mounts an image in a WIM or VHD file that was already mounted at the specified Path, but has become inaccessible for servicing.


The CheckIntegrity parameter detects and tracks .wim file corruption. CheckIntegrity stops the operation if DISM detects that the .wim file is corrupted when used with the
Mount-WindowsImage cmdlet.


The CheckIntegrity parameter does not apply to virtual hard disk (VHD) files.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=289360
Dismount-WindowsImage
Save-WindowsImage
Get-WindowsImage
Repair-WindowsImage

REMARKS

<

Examples


Example 1

PS C:\>Mount-WindowsImage –ImagePath c:\imagestore\install.vhd –Index 1 –Path c:\offline



This command mounts the Windows image contained in the install.vhd file to the c:\offline directory.






Example 2

PS C:\>Mount-WindowsImage –ImagePath c:\imagestore\install.wim –Index 2 -Path c:\offline –ReadOnly



This command mounts the Windows image at index 2 of the install.wim file to the c:\offline derictory with read-only privileges.






Example 3

PS C:\>Mount-WindowsImage –ImagePath c:\imagestore\install.wim –Index 2 -Path c:\offline –Optimize



This command mounts the Windows image at index 2 of the install.wim file to the c:\offline directory with a quicker initial mount time. Additional operations may be slower.






Example 4

PS C:\>Mount-WindowsImage –Path c:\offline -Remount



This command remounts a Windows image that has already been mounted to the c:\offline directory but has become inaccessible for servicing.