Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Resize-IscsiVirtualDisk

Resize-IscsiVirtualDisk

microsoft.iscsi.target.commands.dll

Synopsis

Resizes an iSCSI virtual disk.

Syntax

Resize-IscsiVirtualDisk [-Path] [-Size] [-ComputerName] [-Credential] [-PassThru] [<CommonParameters>]

Resize-IscsiVirtualDisk [-Size] [-ComputerName] [-Credential] [-PassThru] [-InputObject] [<CommonParameters>]

Detailed Description

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.

Parameters

-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.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

True (ByPropertyName)

Accept wildcard characters?

false

-Credential <PSCredential>

Specifies the credentials when connecting to a remote computer.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

True (ByPropertyName)

Accept wildcard characters?

false

-InputObject <IscsiVirtualDisk>

Accepts an iSCSI Virtual Disk object from the input pipeline.

Aliases

None

Required?

true

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-PassThru <SwitchParameter>

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

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.

Aliases

DevicePath

Required?

true

Position

1

Default value

None

Accept pipeline input?

True (ByPropertyName)

Accept wildcard characters?

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.

Aliases

None

Required?

true

Position

2

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

Input Type

Microsoft.Iscsi.Target.Commands.IscsiVirtualDisk

Return Type

Microsoft.Iscsi.Target.Commands.IscsiVirtualDisk

Notes

None

Examples

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

Online Version
Resize-Partition
Checkpoint-IscsiVirtualDisk
Convert-IscsiVirtualDisk
Get-IscsiVirtualDisk
Import-IscsiVirtualDisk
New-IscsiVirtualDisk
Remove-IscsiVirtualDisk
Restore-IscsiVirtualDisk
Set-IscsiVirtualDisk