Share via

New-SCStorageVolume

  • Reference
Module:
VirtualMachineManager

Creates a storage volume.

Syntax

New-SCStorageVolume
   [-VMMServer <ServerConnection>]
   -Name <String>
   -StoragePool <StoragePool>
   -SizeInBytes <UInt64>
   -FileSystem <String>
   -StorageFileServer <StorageFileServer>
   [-ResiliencySettingName <String>]
   [-NumberOfColumns <UInt16>]
   [-PhysicalDiskRedundancy <UInt16>]
   [-GuidPartitionTable]
   [-RequiredPartitionSize <UInt64>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCStorageVolume
   [-VMMServer <ServerConnection>]
   -Name <String>
   -StoragePool <StoragePool>
   -SizeInBytes <UInt64>
   -FileSystem <String>
   -StorageArray <StorageArray>
   [-ResiliencySettingName <String>]
   [-NumberOfColumns <UInt16>]
   [-PhysicalDiskRedundancy <UInt16>]
   [-GuidPartitionTable]
   [-RequiredPartitionSize <UInt64>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCStorageVolume
   [-VMMServer <ServerConnection>]
   -Name <String>
   -StoragePool <StoragePool>
   -FileSystem <String>
   -StorageFileServer <StorageFileServer>
   [-ReadCacheSizeMB <UInt64>]
   -JobGroup <Guid>
   [-GuidPartitionTable]
   [-RequiredPartitionSize <UInt64>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
New-SCStorageVolume
   [-VMMServer <ServerConnection>]
   -Name <String>
   -StoragePool <StoragePool>
   -FileSystem <String>
   -StorageArray <StorageArray>
   [-ReadCacheSizeMB <UInt64>]
   -JobGroup <Guid>
   [-GuidPartitionTable]
   [-RequiredPartitionSize <UInt64>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<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
Position:Named
Default value:None
Required:False
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
Accepted values:Disabled, GeneralPurpose, HyperV, Backup, NotAvailable
Position:Named
Default value:None
Required:False
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
Accepted values:NTFS, ReFS, CSVFS_NTFS, CSVFS_ReFS
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-GuidPartitionTable

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

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

-Name

Specifies the name of a VMM object.

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

-NumberOfColumns

Specifies the number of columns for a virtual disk.

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

-PhysicalDiskRedundancy

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

Type:UInt16
Position:Named
Default value:None
Required:False
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReadCacheSizeMB

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

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

-RequiredPartitionSize

Type:UInt64
Position:Named
Default value:None
Required:False
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
Accepted values:Simple, Mirror, Parity
Position:Named
Default value:None
Required:False
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SizeInBytes

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

-StorageArray

Specifies a storage array object.

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

-StorageClassification

{{Fill StorageClassification Description}}

Type:StorageClassification
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageFileServer

Specifies a storage file server object.

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

-StoragePool

Specifies a storage pool object.

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

-VMMServer

Specifies a VMM server object.

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