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

Modifies the properties of an existing HPE OneView storage volume.

​
Syntax

Set-OVStorageVolume
    -InputObject <Object>
    [-Name <String>]
    [-Description <String>]
    [-Capacity <Int64>]
    [-SnapShotStoragePool <Object>]
    [-PermitAdaptiveOptimization <Bool>]
    [-Shared <Bool>]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

​
Description

Set-OVStorageVolume updates the configuration of a storage volume that is already managed by HPE OneView. Pass the volume object from Get-OVStorageVolume via the pipeline or -InputObject. Capacity can only be increased — storage arrays do not support online shrinking of volumes. Attempting to specify a capacity smaller than the current size will produce an error. Changing -Shared from $true to $false is only permitted when the volume is not attached to more than one server profile.
Expanding a volume is an irreversible operation. The storage array will immediately allocate (for fully-provisioned volumes) or reserve (for thin-provisioned volumes) the additional space. Verify your target capacity before executing.

​
Parameters

​
InputObject
Object
required
The storage volume object to modify. Accepts pipeline input from Get-OVStorageVolume. Aliased as SourceVolume.
​
Name
String
New display name for the volume. Aliased as VolumeName.
​
Description
String
New description for the volume.
​
Capacity
Int64
New capacity in gibibytes (GiB). Must be greater than the current capacity. Aliased as size.
​
SnapShotStoragePool
Object
Storage pool to use for volume snapshots. Accepts an HPEOneView.Storage.StoragePool object or a pool name string.
​
PermitAdaptiveOptimization
Bool
Enables or disables Adaptive Optimization (AO) on 3PAR/Primera volumes. When $true, the array may relocate data between tiers based on access patterns.
​
Shared
Bool
Sets whether the volume is shareable ($true) or private ($false). Setting to $false requires that the volume is currently attached to no more than one server profile.
​
ApplianceConnection
Object
HPE OneView appliance connection. Defaults to the default connected session. Aliased as Appliance.

​
Examples

​
Expand a volume’s capacity

# Get the current volume
$vol = Get-OVStorageVolume -Name "AppData-Vol1"

# Expand from current size to 1 TiB
Set-OVStorageVolume -InputObject $vol -Capacity 1024

​
Rename a volume and update its description

Get-OVStorageVolume -Name "Vol1" | Set-OVStorageVolume -Name "Production-Vol1" -Description "Primary application data volume"

​
Make a private volume shareable

Get-OVStorageVolume -Name "AppData-Vol1" | Set-OVStorageVolume -Shared $true

​
Update the snapshot storage pool

$vol      = Get-OVStorageVolume -Name "DB-Vol-01"
$snapPool = Get-OVStoragePool -Name "FST_CPG2"

Set-OVStorageVolume -InputObject $vol -SnapShotStoragePool $snapPool

​
Output

HPEOneView.Appliance.TaskResource An asynchronous task that tracks the update operation on the storage system. Pipe to Wait-OVTaskComplete if you need the task to finish before proceeding.

Build docs developers (and LLMs) love

Get started for freeTalk to us