PowerShell Logo Small

Dismount-DiskImage



This is the built-in help made by Microsoft for the command 'Dismount-DiskImage', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 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 [<SwitchParameter>]] [-CimSession <CimSession[]>] [-PassThru [<SwitchParameter>]]
[-StorageType <StorageType>] [-ThrottleLimit <Int32>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Dismount-DiskImage [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-PassThru [<SwitchParameter>]] [-StorageType <StorageType>]
[-ThrottleLimit <Int32>] -DevicePath <String[]> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Dismount-DiskImage [-AsJob [<SwitchParameter>]] [-CimSession <CimSession[]>] [-PassThru [<SwitchParameter>]] [-ThrottleLimit <Int32>]
-InputObject <CimInstance[]> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<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

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.