New-SCStorageVolume

Creates a storage volume.

Syntax

New-SCStorageVolume [-AllocationUnitSizeKB <UInt32>] [-DedupMode <DedupMode>] -FileSystem <String>
 [-GuidPartitionTable] -JobGroup <Guid> [-JobVariable <String>] -Name <String> [-PROTipID <Guid>]
 [-ReadCacheSizeMB <UInt64>] [-RequiredPartitionSize <UInt64>] [-RunAsynchronously]
 -StorageFileServer <StorageFileServer> -StoragePool <StoragePool> [-VMMServer <ServerConnection>]
 [<CommonParameters>]
New-SCStorageVolume [-AllocationUnitSizeKB <UInt32>] [-DedupMode <DedupMode>] -FileSystem <String>
 [-GuidPartitionTable] -JobGroup <Guid> [-JobVariable <String>] -Name <String> [-PROTipID <Guid>]
 [-ReadCacheSizeMB <UInt64>] [-RequiredPartitionSize <UInt64>] [-RunAsynchronously]
 -StorageArray <StorageArray> -StoragePool <StoragePool> [-VMMServer <ServerConnection>] [<CommonParameters>]
New-SCStorageVolume [-AllocationUnitSizeKB <UInt32>] [-DedupMode <DedupMode>] -FileSystem <String>
 [-GuidPartitionTable] [-JobVariable <String>] -Name <String> [-NumberOfColumns <UInt16>] [-PROTipID <Guid>]
 [-PhysicalDiskRedundancy <UInt16>] [-RequiredPartitionSize <UInt64>] [-ResiliencySettingName <String>]
 [-RunAsynchronously] -SizeInBytes <UInt64> -StorageArray <StorageArray> -StoragePool <StoragePool>
 [-VMMServer <ServerConnection>] [<CommonParameters>]
New-SCStorageVolume [-AllocationUnitSizeKB <UInt32>] [-DedupMode <DedupMode>] -FileSystem <String>
 [-GuidPartitionTable] [-JobVariable <String>] -Name <String> [-NumberOfColumns <UInt16>] [-PROTipID <Guid>]
 [-PhysicalDiskRedundancy <UInt16>] [-RequiredPartitionSize <UInt64>] [-ResiliencySettingName <String>]
 [-RunAsynchronously] -SizeInBytes <UInt64> -StorageFileServer <StorageFileServer> -StoragePool <StoragePool>
 [-VMMServer <ServerConnection>] [<CommonParameters>]

Description

The New-SCStorageVolume cmdlet creates a storage volume in Virtual Machine Manager (VMM).

Examples

Example 1: Create a tiered storage volume

PS C:\> $StorageArray = Get-SCStorageArray -Name "HCArray" 
PS C:\> $StoragePool = Get-SCStoragePool -Name "S2DPool" 
PS C:\> New-SCStorageTier -StorageTierFriendlyName "Performance" -StorageTierSizeInMB 1024 -RunAsynchronously -JobGroup "191de146-dbec-4955-a347-70edd4315c41" 
PS C:\> New-SCStorageTier -StorageTierFriendlyName "Capacity" -StorageTierSizeInMB 1024 -RunAsynchronously -JobGroup "191de146-dbec-4955-a347-70edd4315c41" 
PS C:\> New-SCStorageVolume -StorageArray $StorageArray -StoragePool $storagePool -Name "Volume1" -RunAsynchronously -JobGroup "191de146-dbec-4955-a347-70edd4315c41" -FileSystem "CSVFS_NTFS"

The first command gets a storage array named HCArray, and then stores it in the $StorageArray variable.

The second command gets a storage pool named S2DPool, and then stores it in the $StoragePool variable.

The third and fourth commands create storage tiers by using the configuration of global tiers named Performance and Capacity. These are existing tiers.

The fifth command creates a tiered volume on hyper converged system. The command uses the values created in the previous commands. Make sure that the job group ID is the same as in the previous commands.

Parameters

-AllocationUnitSizeKB

Specifies the allocation size of a volume, in kilobytes.

Type:UInt32
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DedupMode

Apply deduplication on the volume or file share based on the workload. The acceptable values for this parameter are:

- 0 - Disabled

  • 1 - GeneralPurpose
  • 2 - Hyper-V
  • 3 - Backup

Type:DedupMode
Parameter Sets:Disabled, GeneralPurpose, HyperV, Backup, NotAvailable
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FileSystem

Specifies the file system of a storage volume. The acceptable values for this parameter are:

- CSVFS_NTFS

  • CSVFS_ReFS

Type:String
Parameter Sets:NTFS, ReFS, CSVFS_NTFS, CSVFS_ReFS
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-GuidPartitionTable
Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobGroup

Specifies an identifier for a series of commands that runs as a set just before the final command that includes the same job group identifier runs.

Type:Guid
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-JobVariable

Specifies a variable in which job progress is tracked and stored.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

Specifies the name of a VMM object.

Type:String
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NumberOfColumns

Specifies the number of columns for a virtual disk.

Type:UInt16
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PROTipID

Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.

Type:Guid
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PhysicalDiskRedundancy

Specifies the number of physical disk failures a virtual disk can sustain.

Type:UInt16
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ReadCacheSizeMB

Specifies cache size, in megabytes, for tiered virtual disk.

Type:UInt64
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RequiredPartitionSize
Type:UInt64
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ResiliencySettingName

Specifies the resiliency setting for a virtual disk. The acceptable values for this parameter are:

- Mirror

  • Parity

Type:String
Parameter Sets:Simple, Mirror, Parity
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SizeInBytes
Type:UInt64
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StorageArray

Specifies a storage array object.

Type:StorageArray
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StorageFileServer

Specifies a storage file server object.

Type:StorageFileServer
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StoragePool

Specifies a storage pool object.

Type:StoragePool
Required:True
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-VMMServer

Specifies a VMM server object.

Type:ServerConnection
Required:False
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False