Condividi tramite


Expand-IscsiVirtualDisk

Expand-IscsiVirtualDisk

Expands an iSCSI virtual disk.

Syntax

Parameter Set: Path
Expand-IscsiVirtualDisk [-Path] <String> [ <CommonParameters>]

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

Parameter Set: InputObject
Expand-IscsiVirtualDisk -InputObject <IscsiVirtualDisk> [ <CommonParameters>]

Detailed Description

The Expand-IscsiVirtualDisk cmdlet expands a virtual disk. When the operation is online, the initiator can still access the virtual disk even while it is expanding.
However, the initiator will not automatically see the expanded virtual disk. To get access to the larger virtual disk, the initiator will need to use the Resize-Partition cmdlet to expand the volume hosted on the virtual disk.

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.

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

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 (VHD) 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 expanded iSCSI virtual disk.
Note: This parameter takes a number and a unit as input, such as 10GB, 20MB, or 1TB.
If this parameter is not provided, then a prompt for the input of this parameter with be displayed, as it is a required field. At that time, the value will need to be provided in Bytes; since no unit can be entered at the prompt.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • Microsoft.Iscsi.Target.Commands.IscsiVirtualDisk

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.Iscsi.Target.Commands.IscsiVirtualDisk

Examples

EXAMPLE 1

This example expands the virtual disk with the path E:\temp\test.vhd to 20GB.

PS C:\> Expand-IscsiVirtualDisk –Path "E:\temp\test.vhd" –Size 20GB

Resize-Partition

Checkpoint-IscsiVirtualDisk

Convert-IscsiVirtualDisk

Get-IscsiVirtualDisk

Import-IscsiVirtualDisk

New-IscsiVirtualDisk

Remove-IscsiVirtualDisk

Restore-IscsiVirtualDisk

Set-IscsiVirtualDisk