Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/HewlettPackard/POSH-HPEOneView/llms.txt

Use this file to discover all available pages before exploring further.

​
Synopsis

Creates a new storage volume from a storage pool or volume template.

​
Syntax

​
From storage pool (default)

New-OVStorageVolume
    -Name <String>
    -StoragePool <HPEOneView.Storage.StoragePool>
    [-Description <String>]
    [-SnapshotStoragePool <HPEOneView.Storage.StoragePool>]
    [-StorageSystem <Object>]
    [-Capacity <Int64>]
    [-ProvisioningType <String>]
    [-Full]
    [-Shared]
    [-EnableCompression <Bool>]
    [-EnableDeduplication <Bool>]
    [-EnableEncryption <Bool>]
    [-PerformancePolicy <HPEOneView.Storage.PerformancePolicy>]
    [-VolumeSet <HPEOneView.Storage.VolumeSet>]
    [-Folder <HPEOneView.Storage.NimbleFolder>]
    [-EnableIOPSLimit <Bool>]
    [-IOPSLimit <Int>]
    [-EnableDataTransferLimit <Bool>]
    [-DataTransferLimit <Int>]
    [-CachePinning <Bool>]
    [-Scope <HPEOneView.Appliance.ScopeCollection[]>]
    [-Async]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

​
From volume template

New-OVStorageVolume
    -Name <String>
    -VolumeTemplate <Object>
    [-Description <String>]
    [-SnapshotStoragePool <HPEOneView.Storage.StoragePool>]
    [-Capacity <Int64>]
    [-ProvisioningType <String>]
    [-Full]
    [-Shared]
    [-EnableCompression <Bool>]
    [-EnableDeduplication <Bool>]
    [-EnableEncryption <Bool>]
    [-PerformancePolicy <HPEOneView.Storage.PerformancePolicy>]
    [-VolumeSet <HPEOneView.Storage.VolumeSet>]
    [-Folder <HPEOneView.Storage.NimbleFolder>]
    [-EnableIOPSLimit <Bool>]
    [-IOPSLimit <Int>]
    [-EnableDataTransferLimit <Bool>]
    [-DataTransferLimit <Int>]
    [-CachePinning <Bool>]
    [-Scope <HPEOneView.Appliance.ScopeCollection[]>]
    [-Async]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

​
Description

New-OVStorageVolume creates a storage volume on an HPE OneView-managed array. You can provision a volume directly from a storage pool (CPG) or from a volume template that enforces organizational standards. Specify -Capacity in gibibytes (GiB). If -Capacity is omitted, the value from the volume template or the storage system default is used. Use -ProvisioningType Thin for thin provisioning (deduplication-supported TPVV), Full for thick/fully-allocated provisioning, or TPDD for thin provisioning with deduplication and compression (Adaptive Optimization). Use the -Full switch as a shorthand for full provisioning. For shared volumes that need to be attached to multiple server profiles simultaneously, add the -Shared switch. The cmdlet returns an async task when the storage system accepts the request. Pipe to Wait-OVTaskComplete if you need synchronous behavior, or use -Async to immediately return the task object.
If the appliance has a mandatory volume template policy enabled (Set-OVStorageVolumeTemplatePolicy), you must use the -VolumeTemplate parameter set. Providing only a storage pool will fail.

​
Parameters

​
Name
String
required
Display name for the new volume. Aliased as VolumeName.
​
StoragePool
HPEOneView.Storage.StoragePool
required
The storage pool (CPG) on which to create the volume. Accepts pipeline input from Get-OVStoragePool. Aliased as pool and poolName.
​
VolumeTemplate
Object
required
Volume template to use when creating the volume (template parameter set). Accepts an HPEOneView.Storage.VolumeTemplate object or a template name string. Aliased as template and svt.
​
Description
String
Optional description for the volume.
​
SnapshotStoragePool
HPEOneView.Storage.StoragePool
Storage pool to use for snapshots of this volume. Defaults to the same pool as the volume if not specified.
​
StorageSystem
Object
Storage system to use when the pool name is ambiguous across multiple systems.
​
Capacity
Int64
Volume size in gibibytes (GiB). Must be at least 1 GiB. Aliased as size.
​
ProvisioningType
String
Provisioning type for the volume. Accepted values: Thin, Full, TPDD. Aliased as ProvisionType.
​
Full
SwitchParameter
Shorthand switch to request full (thick) provisioning. Equivalent to -ProvisioningType Full.
​
Shared
SwitchParameter
Marks the volume as shareable, allowing it to be attached to multiple server profiles simultaneously.
​
EnableCompression
Bool
Enables inline compression on the volume. Supported on Primera and Alletra systems.
​
EnableDeduplication
Bool
Enables inline deduplication on the volume. Supported on Primera and Alletra systems.
​
EnableEncryption
Bool
Enables volume-level encryption. Requires the storage system to support this feature.
​
PerformancePolicy
HPEOneView.Storage.PerformancePolicy
Performance policy to assign to the volume. Use Get-OVStorageSystem to retrieve available performance policies.
​
VolumeSet
HPEOneView.Storage.VolumeSet
Volume set (consistency group) to add the volume to.
​
EnableIOPSLimit
Bool
Enables an IOPS limit on the volume.
​
IOPSLimit
Int
default:"256"
Maximum IOPS for the volume when -EnableIOPSLimit is $true. Valid range: 256–4,294,967,295.
​
EnableDataTransferLimit
Bool
Enables a data transfer throughput limit on the volume.
​
DataTransferLimit
Int
Maximum data transfer rate (MB/s) when -EnableDataTransferLimit is $true.
​
CachePinning
Bool
Pins the volume in the storage system cache for maximum performance.
​
Folder
HPEOneView.Storage.NimbleFolder
Nimble Storage folder to place the volume in.
​
Scope
HPEOneView.Appliance.ScopeCollection[]
Assigns the volume to one or more HPE OneView scopes at creation time.
​
Async
SwitchParameter
Returns the task object immediately without waiting for the operation to complete.
​
ApplianceConnection
Object
HPE OneView appliance connection. Defaults to the default connected session. Aliased as Appliance.

​
Examples

​
Create 10 thin-provisioned volumes in a loop

$StoragePool1 = Get-OVStoragePool -Name FST_CPG1

1..10 | ForEach-Object {
    New-OVStorageVolume -Name "Vol$_" -StoragePool $StoragePool1 -Capacity 60
}
Creates Vol1 through Vol10, each 60 GiB, using the default provisioning type of the storage pool.

​
Create shared volumes

1..5 | ForEach-Object {
    New-OVStorageVolume -Name "SharedVol$_" -StoragePool FST_CPG2 -Capacity 250 -Shared
}
Creates five 250 GiB shared volumes that can each be attached to multiple server profiles.

​
Create a thin-provisioned volume with snapshot pool

$dataPool = Get-OVStoragePool -Name "FST_CPG1" -StorageSystem "HP3Par_1"
$snapPool = Get-OVStoragePool -Name "FST_CPG2" -StorageSystem "HP3Par_1"

New-OVStorageVolume `
    -Name "AppData-Vol1" `
    -StoragePool $dataPool `
    -SnapshotStoragePool $snapPool `
    -Capacity 500 `
    -ProvisioningType Thin

​
Create a volume from a template

$svt = Get-OVStorageVolumeTemplate -Name "Gold-Tier-Template"

New-OVStorageVolume -Name "DB-Vol-01" -VolumeTemplate $svt -Capacity 1024

​
Output

HPEOneView.Appliance.TaskResource An asynchronous task object. Pipe to Wait-OVTaskComplete to block until the volume is created.