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