Resize-IscsiVirtualDisk

Resize-IscsiVirtualDisk

Resizes an iSCSI virtual disk.

構文

Parameter Set: Path
Resize-IscsiVirtualDisk [-Path] <String> [-Size] <UInt64> [-ComputerName <String> ] [-Credential <PSCredential> ] [-PassThru] [ <CommonParameters>]

Parameter Set: InputObject
Resize-IscsiVirtualDisk [-Size] <UInt64> -InputObject <IscsiVirtualDisk> [-ComputerName <String> ] [-Credential <PSCredential> ] [-PassThru] [ <CommonParameters>]

詳細説明

The Resize-IscsiVirtualDisk cmdlet resizes a virtual disk either by expanding or compacting an existing virtual disk. Virtual disks that use the VHDX format can remain online while the cmdlet resizes them. If the cmdlet resizes an online disk, when the virtual disk is mapped to an iSCSI Target, initiators can continue to access the virtual disk even while the cmdlet resizes it. However, an initiator will not automatically see the resized virtual disk. To get access to the capacity of the expanded virtual disk, the initiator must use the Resize-Partition cmdlet to modify the volume hosted on the virtual disk.

This cmdlet can compact a disk only when the logical unit number (LUN) on the initiator side created some partitions on the LUN, and the compacting process simply shrinks the unallocated part of the LUN.

パラメーター

-ComputerName<String>

Specifies the computer name, or IP address, of the remote computer, if this cmdlet is run on a remote computer.

Specifies the cluster resource group network name, or cluster node name, if this cmdlet is run on a cluster configuration.

If you do not specify a value for this parameter, the cmdlet uses the local computer.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Credential<PSCredential>

Specifies the credentials when connecting to a remote computer.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-InputObject<IscsiVirtualDisk>

Accepts an iSCSI Virtual Disk object from the input pipeline.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-PassThru

作業中の項目を表すオブジェクトを返します。既定では、このコマンドレットによる出力はありません。

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-Path<String>

Specifies the path of the virtual hard disk (VHDX) file that is associated with the iSCSI virtual disk.
Filter the iSCSI Virtual Disk object using this parameter.

エイリアス

DevicePath

必須?

true

位置は?

1

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Size<UInt64>

Specifies the size of the resized iSCSI virtual disk.
Note: This parameter takes a number and a unit as input, such as 10GB, 20MB, or 1TB.
If you do not specify this parameter, the cmdlet prompts you for a value. You must enter the value in bytes, without specifying a unit.

エイリアス

なし

必須?

true

位置は?

2

既定値

なし

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

  • Microsoft.Iscsi.Target.Commands.IscsiVirtualDisk

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

  • Microsoft.Iscsi.Target.Commands.IscsiVirtualDisk

Example 1: Resize a virtual disk

This command resizes the virtual disk at the path E:\temp\test06.vhdx to 20GB.

PS C:\> Resize-IscsiVirtualDisk –Path "E:\temp\test06.vhdx" –Size 20GB

関連トピック

Resize-Partition

Checkpoint-IscsiVirtualDisk

Convert-IscsiVirtualDisk

Get-IscsiVirtualDisk

Import-IscsiVirtualDisk

New-IscsiVirtualDisk

Remove-IscsiVirtualDisk

Restore-IscsiVirtualDisk

Set-IscsiVirtualDisk