This is the built-in help made by Microsoft for the command 'New-Volume', 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.
Creates a volume with the specified file system.
New-Volume [-StoragePoolFriendlyName] <String[]> [-AccessPath <String>] [-AsJob] [-CimSession <CimSession[]>] [-NumberOfColumns <UInt16>] [-PhysicalDiskRedundancy <UInt16>]
[-ProvisioningType <ProvisioningType>] [-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit
<Int32>] -FileSystem <FileSystem> -FriendlyName <String> [<CommonParameters>]
New-Volume [-AccessPath <String>] [-AsJob] [-CimSession <CimSession[]>] [-NumberOfColumns <UInt16>] [-PhysicalDiskRedundancy <UInt16>] [-ProvisioningType <ProvisioningType>]
[-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] -FileSystem <FileSystem>
-FriendlyName <String> -StoragePoolUniqueId <String[]> [<CommonParameters>]
New-Volume [-AccessPath <String>] [-AsJob] [-CimSession <CimSession[]>] [-NumberOfColumns <UInt16>] [-PhysicalDiskRedundancy <UInt16>] [-ProvisioningType <ProvisioningType>]
[-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] -FileSystem <FileSystem>
-FriendlyName <String> -StoragePoolName <String[]> [<CommonParameters>]
New-Volume [-AccessPath <String>] [-AsJob] [-CimSession <CimSession[]>] [-NumberOfColumns <UInt16>] [-PhysicalDiskRedundancy <UInt16>] [-ProvisioningType <ProvisioningType>]
[-ResiliencySettingName <String>] [-Size <UInt64>] [-StorageTiers <CimInstance[]>] [-StorageTierSizes <UInt64[]>] [-ThrottleLimit <Int32>] -FileSystem <FileSystem>
-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 setting,
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: "-ProvisioningType
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" -StorageTiers
(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 storage
tier, and then formats the volume with the NTFS file system and assigns drive letter M.