New-VDisk
This cmdlet creates a managed VDisk object whose lifecycle is independent of a virtual machine`s lifecycle on the specified datastore. For RDM (RawVDisk), you must specify the device name of the SCSI LUN and the virtual machine host which is connected to the SCSI LUN.
Syntax
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
CapacityGB | Decimal | named |
|
Specifies the capacity of the newly created VDisk object in gigabytes (GB). |
| required
|
Datastore | Datastore | named |
|
Specifies the datastore on which you want to store the metadata of the VDisk object. For flat disk, the contents of the disk are also stored on the specified datastore. |
| required
|
Name | String | named |
|
Specifies the name of the newly created VDisk object. |
| optional | DiskType | DiskType | named |
|
Specifies the type of the newly created VDisk object. |
| optional | ProgressAction | ActionPreference | named |
|
|
| optional | Server | VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. |
| optional | StorageFormat | VDiskStorageFormat | named |
|
Specifies the storage format of the newly created VDisk object. |
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
Datastore | Datastore | named |
|
Specifies the datastore on which you want to store the metadata of the VDisk object. For flat disk, the contents of the disk are also stored on the specified datastore. |
| required
|
Name | String | named |
|
Specifies the name of the newly created VDisk object. |
| required
|
ScsiLun | ScsiLun | named |
|
Specifies the backing SCSI LUN for the newly created VDisk object. |
| optional | DiskType | DiskType | named |
|
Specifies the type of the newly created VDisk object. |
| optional | ProgressAction | ActionPreference | named |
|
|
| optional | Server | VIServer[] | named |
|
Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. |
| optional | VMHost | VMHost | named |
|
Specifies the virtual machine host which is connected to the SCSI LUN. |
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
HardDisk | HardDisk | named |
|
Specifies the virtual hard disk object which you want to promote as a VDisk object. |
| required
|
Name | String | named |
|
Specifies the name of the newly created VDisk object. |
| optional | ProgressAction | ActionPreference | named |
|
Output
VMware.VimAutomation.ViCore.Types.V1.Storage.VDisk.VDiskExamples
Example 1
New-VDisk -Name 'MyDisk' -CapacityGB 1 -Datastore $ds -DiskType Flat -StorageFormat Thin
Creates a new thin-provisioned flat VDisk object named 'MyDisk' on the $ds datastore with capacity of 1 GB.
Example 2
New-VDisk -Name 'MyDisk' -Datastore $ds -DiskType RawPhysical -ScsiLun $scsiLun
Creates a new physical raw VDisk object named 'MyDisk' backed by the $scsiLun SCSI LUN and with metadata on the $ds datastore.
Example 3
New-VDisk -HardDisk $hd -Name $newName
Promotes the $hd virtual hard disk to a VDisk object.
Related Commands
VDisk
This cmdlet copies the specified VDisk objects to the specified datastore.
This cmdlet lists VDisk objects based on the specified filters.
This cmdlet moves the specified VDisk objects to the specified datastore.
This cmdlet creates a managed VDisk object whose lifecycle is independent of a virtual machine`s lifecycle on the specified datastore.
This cmdlet removes VDisk objects and the associated backings from the datastore.
This cmdlet renames, inflates, or extends the size of the specified VDisk object.