New-SCStorageVolume

Creates a storage volume.

Syntax

NewVolume

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

NewVolumeOnArray

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

NewVolumeTiered

New-SCStorageVolume
    -Name <String>
    -StoragePool <StoragePool>
    -FileSystem <String>
    -StorageFileServer <StorageFileServer>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-ReadCacheSizeMB <UInt64>]
    [-GuidPartitionTable]
    [-RequiredPartitionSize <UInt64>]
    [-DedupMode <DedupMode>]
    [-AllocationUnitSizeKB <UInt32>]
    [-StorageClassification <StorageClassification>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

NewVolumeTieredOnArray

New-SCStorageVolume
    -Name <String>
    -StoragePool <StoragePool>
    -FileSystem <String>
    -StorageArray <StorageArray>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-ReadCacheSizeMB <UInt64>]
    [-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.

Parameter properties

Type:UInt32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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

Parameter properties

Type:DedupMode
Default value:None
Accepted values:Disabled, GeneralPurpose, HyperV, Backup, NotAvailable
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FileSystem

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

  • CSVFS_NTFS
  • CSVFS_ReFS

Parameter properties

Type:String
Default value:None
Accepted values:NTFS, ReFS, CSVFS_NTFS, CSVFS_ReFS
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GuidPartitionTable

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NewVolumeTiered
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NewVolumeTieredOnArray
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-JobVariable

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

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Name

Specifies the name of a VMM object.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NumberOfColumns

Specifies the number of columns for a virtual disk.

Parameter properties

Type:UInt16
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NewVolume
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NewVolumeOnArray
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PhysicalDiskRedundancy

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

Parameter properties

Type:UInt16
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NewVolume
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NewVolumeOnArray
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Guid
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ReadCacheSizeMB

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

Parameter properties

Type:UInt64
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NewVolumeTiered
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NewVolumeTieredOnArray
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RequiredPartitionSize

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

Parameter properties

Type:UInt64
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResiliencySettingName

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

  • Mirror
  • Parity

Parameter properties

Type:String
Default value:None
Accepted values:Simple, Mirror, Parity
Supports wildcards:False
DontShow:False

Parameter sets

NewVolume
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NewVolumeOnArray
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RunAsynchronously

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SizeInBytes

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

Parameter properties

Type:UInt64
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NewVolume
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NewVolumeOnArray
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StorageArray

Specifies a storage array object.

Parameter properties

Type:StorageArray
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NewVolumeOnArray
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NewVolumeTieredOnArray
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StorageClassification

{{Fill StorageClassification Description}}

Parameter properties

Type:StorageClassification
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StorageFileServer

Specifies a storage file server object.

Parameter properties

Type:StorageFileServer
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

NewVolume
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
NewVolumeTiered
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-StoragePool

Specifies a storage pool object.

Parameter properties

Type:StoragePool
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VMMServer

Specifies a VMM server object.

Parameter properties

Type:ServerConnection
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.