Resize-VHD
Resize-VHD
Resizes a virtual hard disk.
Синтаксис
Parameter Set: Size
Resize-VHD [-Path] <String[]> [-SizeBytes] <UInt64> [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: MinimumSize
Resize-VHD [-Path] <String[]> -ToMinimumSize [-AsJob] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-Passthru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Подробное описание
The Resize-VHD cmdlet resizes a virtual hard disk. This cmdlet lets you shrink or expand the size of a virtual hard disk, but the shrink operation is allowed only on VHDX virtual hard disks. The shrink operation fails if it would shrink the virtual disk to less than its minimum size (available through the VHDX object’s MinimumSize property).
Resize-VHD is an offline operation; the virtual hard disk must not be attached when the operation is initiated.
Параметры
-AsJob
Runs the cmdlet as a background job.
Псевдонимы |
none |
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
none |
Принимать входные данные конвейера? |
false |
Обрабатывать символы-шаблоны? |
false |
-CimSession<Microsoft.Management.Infrastructure.CimSession[]>
Запускает командлет в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные командлета New-CimSession или Get-CimSession. По умолчанию используется текущий сеанс на локальном компьютере.
Псевдонимы |
none |
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
none |
Принимать входные данные конвейера? |
false |
Обрабатывать символы-шаблоны? |
false |
-ComputerName<String[]>
Specifies one or more Hyper-V hosts on which a virtual hard disk is to be resized. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.
Псевдонимы |
none |
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
none |
Принимать входные данные конвейера? |
false |
Обрабатывать символы-шаблоны? |
false |
-Credential<System.Management.Automation.PSCredential[]>
Specifies one or more user accounts that have permission to perform this action. The default is the current user.
Псевдонимы |
none |
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
none |
Принимать входные данные конвейера? |
false |
Обрабатывать символы-шаблоны? |
false |
-Passthru
Specifies that an object is to be passed through to the pipeline representing the virtual hard disk to be resized.
Псевдонимы |
none |
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
none |
Принимать входные данные конвейера? |
false |
Обрабатывать символы-шаблоны? |
false |
-Path<String[]>
Specifies the path to the virtual hard disk that is to be resized.
Псевдонимы |
FullName |
Обязательное поле? |
true |
Позиция? |
1 |
Значение по умолчанию |
none |
Принимать входные данные конвейера? |
true (ByValue, ByPropertyName) |
Обрабатывать символы-шаблоны? |
false |
-SizeBytes<UInt64>
Specifies the size to which the virtual hard disk is to be resized.
Псевдонимы |
none |
Обязательное поле? |
true |
Позиция? |
2 |
Значение по умолчанию |
none |
Принимать входные данные конвейера? |
false |
Обрабатывать символы-шаблоны? |
false |
-ToMinimumSize
Specifies that the virtual hard disk is to be resized to its minimum possible size.
Псевдонимы |
none |
Обязательное поле? |
true |
Позиция? |
named |
Значение по умолчанию |
none |
Принимать входные данные конвейера? |
false |
Обрабатывать символы-шаблоны? |
false |
-Confirm
Выводит приглашение для подтверждения перед выполнением командлета.
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
false |
Принимать входные данные конвейера? |
false |
Обрабатывать символы-шаблоны? |
false |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не запущен.
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
false |
Принимать входные данные конвейера? |
false |
Обрабатывать символы-шаблоны? |
false |
<CommonParameters>
Этот командлет поддерживает общие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Входы
Входной тип — это тип объектов, которые можно направить в командлет.
Выходные данные
Возвращаемый тип — это тип объектов, возвращаемых командлетом.
Примеры
Example 1
Expands the VHDX to 1 terabyte (assuming that the previous size was less than the new size prior to the command).
PS C:\> Resize-VHD –Path c:\BaseVHD.vhd –SizeBytes 1TB
Example 2
Shrinks the VHDX to one terabyte (assuming that the virtual hard disk object associated with the file path has a MinimumSize less than or equal to 1TB).
PS C:\> Resize-VHD –Path c:\BaseVHDX.vhdx –SizeBytes 1TB
Example 3
Shrinks the VHDX to its minimum possible size.
PS C:\> Resize-VHD –Path c:\BaseVHDX.vhdx –ToMinimumSize