Get-DiskImage
Get-DiskImage
Gets one or more disk image objects (virtual hard disk or ISO).
Синтаксис
Parameter Set: ByImagePath
Get-DiskImage [-ImagePath] <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-StorageType <StorageType> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByDevicePath
Get-DiskImage -DevicePath <String[]> [-AsJob] [-CimSession <CimSession[]> ] [-StorageType <StorageType> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]
Parameter Set: ByVolume
Get-DiskImage [-AsJob] [-CimSession <CimSession[]> ] [-StorageType <StorageType> ] [-ThrottleLimit <Int32> ] [-Volume <CimInstance> ] [ <CommonParameters>]
Подробное описание
The Get-DiskImage cmdlet gets the objects associated with one or more disk images (virtual hard disk or ISO). This cmdlet requires either the full image path of the ISO or VHD file, or the device path.
This cmdlet reports whether the specified ISO or VHD file is currently attached.
Параметры
-AsJob
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-CimSession<CimSession[]>
Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объекта сеанса, например результат выполнения командлета New-CimSession или Get-CimSession. Сеанс по умолчанию — текущий сеанс на локальном компьютере.
Псевдонимы |
Session |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-DevicePath<String[]>
Specifies the device path of the ISO or VHD file. You cannot use this parameter with the ImagePath parameter.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-ImagePath<String[]>
Specifies the path of the ISO or VHD file. You cannot use this parameter with the DevicePath parameter.
Псевдонимы |
отсутствуют |
Требуется? |
true |
Указать положение? |
1 |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByValue, ByPropertyName) |
Принимать подстановочные знаки? |
false |
-StorageType<StorageType>
Specifies the type of a disk image: ISO, VHD, VHDx, or Unknown. If the StorageType parameter is not specified or the Unknown type is provided, the storage type is determined by file extension.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Принимать подстановочные знаки? |
false |
-ThrottleLimit<Int32>
Определяет максимальное число одновременных операций, которое можно установить для запуска командлета. Если этот параметр опущен или имеет значение 0, Windows PowerShell® вычисляет оптимальный предел регулирования для командлета на основе числа командлетов CIM, запущенных на компьютере. Предел регулирования применяется только к текущему командлету, а не к сеансу или компьютеру.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
false |
Принимать подстановочные знаки? |
false |
-Volume<CimInstance>
Gets the disk image associated with the specified Volume object. Enter a Volume CIM object, which can be obtained by using the Get-Volume cmdlet.
Псевдонимы |
отсутствуют |
Требуется? |
false |
Указать положение? |
named |
Значение по умолчанию |
отсутствуют |
Принимать входные данные конвейера? |
True (ByValue) |
Принимать подстановочные знаки? |
false |
<CommonParameters>
Этот командлет поддерживает следующие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, и -OutVariable. Для получения дополнительных сведений см. about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Входные данные
Тип входных данных — это тип объектов, которые можно передать в командлет через конвейер.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_Volume
You can pipe a Volume object to the Volume parameter.
Выходные данные
Тип выходных данных — это тип объектов, которые выдает командлет.
Microsoft.Management.Infrastructure.CimInstance#ROOT/Microsoft/Windows/Storage/MSFT_DiskImage
This cmdlet returns an object that represents the specified disk image.
Примечания
- Объект
Microsoft.Management.Infrastructure.CimInstanceявляется классом-оболочкой, который отображает объекты инструментария управления Windows (WMI). После символа решетки (#) задается пространство имен и имя класса базового объекта инструментария управления Windows.
Примеры
Example 1: Get a disk image by path
This example gets an ISO disk image specified by path and displays information about the disk image.
PS C:\> Get-DiskImage –ImagePath "E:\ISO-Files\My US Visit Fall 2010 Pictures.iso"
Example 2: Get a disk image by device path
This example gets an ISO disk image specified by device path and displays information about the disk image.
PS C:\> Get-DiskImage -DevicePath \\.\CDROM1
Example 3: Get the drive letter associated with a mounted ISO
This example displays the drive letter associated with an ISO file.
PS C:\> Get-DiskImage -DevicePath \\.\CDROM1 | Get-Volume
Example 4: Get the drive letter associated with a mounted VHD
This example displays one or more drive letters associated with volumes in a VHD file.
PS C:\> Get-DiskImage –ImagePath E:\vhd1.vhdx | Get-Disk | Get-Partition | Get-Volume