This is the built-in help made by Microsoft for the command 'New-Volume', in PowerShell version 4 - as retrieved from
Windows version 'Microsoft Windows 8.1 Enterprise' 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 volume with the specified file system.
New-Volume [-StoragePoolFriendlyName] <String[]> [-AccessPath <String>] [-AsJob] [-CimSession <CimSession[]>] [-NumberOfColumns <UInt16>] [-PhysicalDiskRedundancy <UI
nt16>] [-ProvisioningType <ProvisioningType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-Thro
ttleLimit <Int32>] -FileSystem <FileSystem> -FriendlyName <String> [<CommonParameters>]
New-Volume [-AccessPath <String>] [-AsJob] [-CimSession <CimSession[]>] [-NumberOfColumns <UInt16>] [-PhysicalDiskRedundancy <UInt16>] [-ProvisioningType <Provisionin
gType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] -FileSystem <FileSy
stem> -FriendlyName <String> -StoragePoolUniqueId <String[]> [<CommonParameters>]
New-Volume [-AccessPath <String>] [-AsJob] [-CimSession <CimSession[]>] [-NumberOfColumns <UInt16>] [-PhysicalDiskRedundancy <UInt16>] [-ProvisioningType <Provisionin
gType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] -FileSystem <FileSy
stem> -FriendlyName <String> -StoragePoolName <String[]> [<CommonParameters>]
New-Volume [-AccessPath <String>] [-AsJob] [-CimSession <CimSession[]>] [-NumberOfColumns <UInt16>] [-PhysicalDiskRedundancy <UInt16>] [-ProvisioningType <Provisionin
gType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] -FileSystem <FileSy
stem> -FriendlyName <String> -InputObject <CimInstance[]> [<CommonParameters>]
The New-Volume cmdlet creates a volume with the specified file system. The cmdlet manages the creation of the virtual disk with the specified size and resiliency sett
ing, initializes the disk, creates a partition on it and formats the volume with the specified file system, including Cluster Shared Volumes (CSVs).
<
Online Version: http://go.microsoft.com/fwlink/?LinkId=216646
<
Example 1: Create a volume on a mirror space
PS C:\> New-Volume -StoragePoolName "CompanyData" -FriendlyName "TestVolume" -Size 10GB -ResiliencySettingName "Mirror" -FileSystem NTFS -AccessPath "M: "-Provisionin
gType Fixed
This command creates a new storage space in the CompanyData pool using the Mirror resiliency setting and fixed provisioning, and then formats the volume with the NTFS
file system and assigns drive letter M.
Example 2: Create a volume on a new tiered storage space
PS C:\>New-Volume -StoragePoolFriendlyName "CompanyData" -FriendlyName "UserData" -AccessPath "M:" -ResiliencySettingName "Mirror" -ProvisioningType "Fixed" -StorageT
iers (Get-StorageTier -FriendlyName "*SSD*"), (Get-StorageTier -FriendlyName "*HDD*") -StorageTierSizes 20GB, 80GB -FileSystem NTFS
This command creates new storage space in the CompanyData pool using the Mirror resiliency setting, fixed provisioning, a 20 GB SSD storage tier, and an 80 GB HDD sto
rage tier, and then formats the volume with the NTFS file system and assigns drive letter M.