New-SCStorageVolume
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 |