PowerShell Logo Small

New-VirtualDisk



This is the built-in help made by Microsoft for the command 'New-VirtualDisk', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 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.

SYNOPSIS

Creates a new virtual disk in the specified storage pool.

SYNTAX


New-VirtualDisk [-StoragePoolFriendlyName] <String[]> [-AsJob] [-AutoNumberOfColumns] [-AutoWriteCacheSize] [-CimSession <CimSession[]>] [-Interleave <UInt64>]
[-IsEnclosureAware <Boolean>] [-NumberOfColumns <UInt16>] [-NumberOfDataCopies <UInt16>] [-OtherUsageDescription <String>] [-PhysicalDiskRedundancy <UInt16>]
[-PhysicalDisksToUse <CimInstance[]>] [-ProvisioningType <ProvisioningType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>]
[-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] [-Usage <Usage>] [-UseMaximumSize] [-WriteCacheSize <UInt64>] -FriendlyName <String> [<CommonParameters>]
New-VirtualDisk [-AsJob] [-AutoNumberOfColumns] [-AutoWriteCacheSize] [-CimSession <CimSession[]>] [-Interleave <UInt64>] [-IsEnclosureAware <Boolean>] [-NumberOfColumns
<UInt16>] [-NumberOfDataCopies <UInt16>] [-OtherUsageDescription <String>] [-PhysicalDiskRedundancy <UInt16>] [-PhysicalDisksToUse <CimInstance[]>] [-ProvisioningType
<ProvisioningType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] [-Usage
<Usage>] [-UseMaximumSize] [-WriteCacheSize <UInt64>] -FriendlyName <String> -StoragePoolName <String[]> [<CommonParameters>]
New-VirtualDisk [-AsJob] [-AutoNumberOfColumns] [-AutoWriteCacheSize] [-CimSession <CimSession[]>] [-Interleave <UInt64>] [-IsEnclosureAware <Boolean>] [-NumberOfColumns
<UInt16>] [-NumberOfDataCopies <UInt16>] [-OtherUsageDescription <String>] [-PhysicalDiskRedundancy <UInt16>] [-PhysicalDisksToUse <CimInstance[]>] [-ProvisioningType
<ProvisioningType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] [-Usage
<Usage>] [-UseMaximumSize] [-WriteCacheSize <UInt64>] -FriendlyName <String> -StoragePoolUniqueId <String[]> [<CommonParameters>]
New-VirtualDisk [-AsJob] [-AutoNumberOfColumns] [-AutoWriteCacheSize] [-CimSession <CimSession[]>] [-Interleave <UInt64>] [-IsEnclosureAware <Boolean>] [-NumberOfColumns
<UInt16>] [-NumberOfDataCopies <UInt16>] [-OtherUsageDescription <String>] [-PhysicalDiskRedundancy <UInt16>] [-PhysicalDisksToUse <CimInstance[]>] [-ProvisioningType
<ProvisioningType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] [-Usage
<Usage>] [-UseMaximumSize] [-WriteCacheSize <UInt64>] -FriendlyName <String> -InputObject <CimInstance[]> [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The New-VirtualDisk cmdlet creates a new virtual disk in the specified storage pool.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkID=307007
Add-VirtualDiskToMaskingSet
Connect-VirtualDisk
Disconnect-VirtualDisk
Get-StoragePool
Get-StorageTier
Get-VirtualDisk
Hide-VirtualDisk
New-MaskingSet
Remove-VirtualDisk
Repair-VirtualDisk
Resize-VirtualDisk
Set-VirtualDisk
Show-VirtualDisk

REMARKS

<

Examples


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.




Example 5: Create a mirror space with storage tiers

PS C:\> $SSD = Get-StorageTier -FriendlyName *SSD*
PS C:\> $HDD = Get-StorageTier -FriendlyName *HDD*
PS C:\> Get-StoragePool CompanyData | New-VirtualDisk -FriendlyName "UserData01" -ResiliencySettingName "Mirror" –StorageTiers $SSD, $HDD -StorageTierSizes 8GB, 32GB



This example creates a 40 GB fixed provisioning virtual disk on the Storage Spaces subsystem. The virtual disk uses the Mirror resiliency setting and storage tiers to store
8 GB of data on the SSD tier and 32 GB of data on the HDD tier.




Example 6: Create a dual-parity space

PS C:\>New-VirtualDisk -StoragePoolFriendlyName "CompanyData" -FriendlyName "ArchivalData" -Size 50GB -ProvisioningType Fixed -ResiliencySettingName "Parity"
-PhysicalDiskRedundancy 2



This example creates a virtual disk on the Storage Spaces subsystem that uses the dual-parity resiliency type to help protect against two simultaneous disk failures and
maximize capacity efficiency.