This is the built-in help made by Microsoft for the command 'New-VirtualDisk', in PowerShell version 3 - as retrieved from
Windows version 'Microsoft Windows Server 2012 Standard' PowerShell help files on 2016-06-23.
For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.
Creates a new virtual disk in the specified storage pool.
New-VirtualDisk [-StoragePoolFriendlyName] <String[]> [-AsJob [<SwitchParameter>]] [-AutoNumberOfColumns [<SwitchParameter>]] [-CimSession
<CimSession[]>] [-Interleave <UInt64>] [-IsEnclosureAware <Boolean>] [-NumberOfColumns <UInt16>] [-NumberOfDataCopies <UInt16>]
[-OtherUsageDescription <String>] [-PhysicalDiskRedundancy <UInt16>] [-PhysicalDisksToUse <CimInstance[]>] [-ProvisioningType
<ProvisioningType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-ThrottleLimit <Int32>] [-Usage <Usage>] [-UseMaximumSize
[<SwitchParameter>]] -FriendlyName <String> [<CommonParameters>]
New-VirtualDisk [-AsJob [<SwitchParameter>]] [-AutoNumberOfColumns [<SwitchParameter>]] [-CimSession <CimSession[]>] [-Interleave <UInt64>]
[-IsEnclosureAware <Boolean>] [-NumberOfColumns <UInt16>] [-NumberOfDataCopies <UInt16>] [-OtherUsageDescription <String>]
[-PhysicalDiskRedundancy <UInt16>] [-PhysicalDisksToUse <CimInstance[]>] [-ProvisioningType <ProvisioningType>] [-ResiliencySettingName
<String>] [-Size <UInt64>] [-ThrottleLimit <Int32>] [-Usage <Usage>] [-UseMaximumSize [<SwitchParameter>]] -FriendlyName <String> -InputObject
<CimInstance[]> [<CommonParameters>]
New-VirtualDisk [-AsJob [<SwitchParameter>]] [-AutoNumberOfColumns [<SwitchParameter>]] [-CimSession <CimSession[]>] [-Interleave <UInt64>]
[-IsEnclosureAware <Boolean>] [-NumberOfColumns <UInt16>] [-NumberOfDataCopies <UInt16>] [-OtherUsageDescription <String>]
[-PhysicalDiskRedundancy <UInt16>] [-PhysicalDisksToUse <CimInstance[]>] [-ProvisioningType <ProvisioningType>] [-ResiliencySettingName
<String>] [-Size <UInt64>] [-ThrottleLimit <Int32>] [-Usage <Usage>] [-UseMaximumSize [<SwitchParameter>]] -FriendlyName <String>
-StoragePoolName <String[]> [<CommonParameters>]
New-VirtualDisk [-AsJob [<SwitchParameter>]] [-AutoNumberOfColumns [<SwitchParameter>]] [-CimSession <CimSession[]>] [-Interleave <UInt64>]
[-IsEnclosureAware <Boolean>] [-NumberOfColumns <UInt16>] [-NumberOfDataCopies <UInt16>] [-OtherUsageDescription <String>]
[-PhysicalDiskRedundancy <UInt16>] [-PhysicalDisksToUse <CimInstance[]>] [-ProvisioningType <ProvisioningType>] [-ResiliencySettingName
<String>] [-Size <UInt64>] [-ThrottleLimit <Int32>] [-Usage <Usage>] [-UseMaximumSize [<SwitchParameter>]] -FriendlyName <String>
-StoragePoolUniqueId <String[]> [<CommonParameters>]
The New-VirtualDisk cmdlet creates a new virtual disk in the specified storage pool.
<
Add-VirtualDiskToMaskingSet
Connect-VirtualDisk
Disconnect-VirtualDisk
Get-StoragePool
Get-VirtualDisk
Hide-VirtualDisk
New-MaskingSet
Remove-VirtualDisk
Repair-VirtualDisk
Resize-VirtualDisk
Set-VirtualDisk
Show-VirtualDisk
<
Example 1: Creating a 100 GB virtual disk using default settings
PS C:\> New-VirtualDisk -StoragePoolFriendlyName CompanyData -FriendlyName UserData -Size 100GB
This example creates a virtual disk named UserData from the storage pool named CompanyData that is 100GB in size, using the storage pool
default settings for unspecified parameters.
Example 2: Creating a thinly-provisioned mirror
PS C:\> New-VirtualDisk -StoragePoolFriendlyName CompanyData -FriendlyName DataWarehouse –ResiliencySettingName Mirror -Size 42TB
-ProvisioningType Thin
This example creates a virtual disk named DataWarehouse, which is 42TB in size, uses the Mirror resiliency setting, and is thinly provisioned.
Example 3: Creating a three-way mirror
PS C:\> New-VirtualDisk -StoragePoolFriendlyName CompanyData -FriendlyName BusinessCritical -ResiliencySettingName Mirror -NumberOfDataCopies
3 -Size 42TB -ProvisioningType Thin
This example creates a 42 TB thinly-provisioned virtual disk on the Storage Spaces subsystem, using the Mirror resiliency setting with three
data copies. This creates a three-way mirror that is capable of tolerating two disk failures).
Example 4: Creating a two-column mirror
PS C:\> New-VirtualDisk -StoragePoolFriendlyName CompanyData -FriendlyName BusinessCritical -ResiliencySettingName Mirror - -Size 42TB
-ProvisioningType Thin -NumberOfColumns 2
This example creates a thinly-provisioned virtual disk on the Storage Spaces subsystem that uses two columns, regardless of how many physical
disks are in the storage pool above the two-disk minimum for a two-way mirror.