PowerShell Logo Small

Dismount-DiskImage



This is the built-in help made by Microsoft for the command 'Dismount-DiskImage', 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

Dismounts a disk image (virtual hard disk or ISO) so that it can no longer be accessed as a disk.

SYNTAX


Dismount-DiskImage [-ImagePath] <String[]> [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-StorageType <StorageType>] [-ThrottleLimit <Int32>] [-Confirm] [-WhatIf]
[<CommonParameters>]
Dismount-DiskImage [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-ThrottleLimit <Int32>] -InputObject <CimInstance[]> [-Confirm] [-WhatIf] [<CommonParameters>]
Dismount-DiskImage [-AsJob] [-CimSession <CimSession[]>] [-PassThru] [-StorageType <StorageType>] [-ThrottleLimit <Int32>] -DevicePath <String[]> [-Confirm] [-WhatIf]
[<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Dismount-DiskImage cmdlet dismounts a disk image (virtual hard disk or ISO) so that it can no longer be accessed as a disk. This cmdlet requires either the full image
path of the ISO or VHD file, or the device path.


To eject a VHD file, administrator privilege is required. Administrator privilege is not needed to eject an ISO file on Windows® 8. On Windows Server® 2012, only an
administrator is allowed to mount or eject ISO file.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=294429
Get-DiskImage
Mount-DiskImage

REMARKS

<

Examples


Example 1: Dismount a disk image by path

PS C:\>Dismount-DiskImage -ImagePath "E:\ISO-Files\My US Visit Fall 2010 Pictures.iso"



This example ejects an ISO named My US Visit Fall 2010 Pictures by specifying the image path at E:\ISO-Files.




Example 2: Dismount a disk image by device path

PS C:\>Dismount-DiskImage -DevicePath \\.\CDROM1



This example ejects an ISO by specifying device path for cdrom1. Refer to the Get-DiskImage cmdlet to learn how to find the device path of an ISO or VHD file.