PowerShell Logo Small

New-Volume



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.

SYNOPSIS

Creates a volume with the specified file system.

SYNTAX


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>]



Search powershellhelp.space

DESCRIPTION


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).



<

RELATED LINKS


Online Version: http://go.microsoft.com/fwlink/?LinkId=216646

REMARKS

<

Examples


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.