New HPOVStorageVolume - HewlettPackard/POSH-HPEOneView GitHub Wiki

HPE OneView 4.10 Library

New-HPOVStorageVolume

Create a Storage Volume resource.

SYNTAX

New-HPOVStorageVolume [-Name] <String> [-StoragePool] <Object> [-Description] <String>[ [-SnapshotStoragePool] <Object>][ [-StorageSystem] <Object>][ [-DataProtectionLevel] <String>][ [-EnableAdaptiveOptimization] <SwitchParameter>] [-Capacity] <Int64>[ [-ProvisioningType] <String>][ [-EnableCompression] <Boolean>][ [-EnableDeduplication] <Boolean>][ [-Full] <SwitchParameter>][ [-Shared] <SwitchParameter>][ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object> [<CommonParameters>]

New-HPOVStorageVolume [-Name] <String>[ [-VolumeTemplate] <Object>] [-Description] <String>[ [-SnapshotStoragePool] <Object>][ [-DataProtectionLevel] <String>][ [-EnableAdaptiveOptimization] <SwitchParameter>] [-Capacity] <Int64>[ [-ProvisioningType] <String>][ [-EnableCompression] <Boolean>][ [-EnableDeduplication] <Boolean>][ [-Full] <SwitchParameter>][ [-Shared] <SwitchParameter>][ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object> [<CommonParameters>]

Detailed Description

This cmdlet will help create a Storage Volume resource on a managed Storage System. The volume can be created by specifying the Storage Pool or an existing Storage Volume Template. When the Storage Pool name is not unique, you can either use the -StorageSystem parameter, or pass via the pipeline the Storage Pool from Get-HPOVStoragePool.

If the Storage Volume Template Global Policy is enabled, a valid Storage Volume Template must be provided.

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one HPOneView.Appliance.Connection object or Name property value. If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases	None
Required?	true
Position?	named
Default value	(${Global:ConnectedSessions} \| ? Default)
Accept pipeline input?	true (ByPropertyName)
Accept wildcard characters?	False

-Async <SwitchParameter>

Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.

Aliases	None
Required?	false
Position?	named
Default value	false
Accept pipeline input?	false
Accept wildcard characters?	False

-Capacity <Int64>

Aliases [-size] Max volume capacity in GB. e.g. 20 to specify 20GB.

Aliases	size
Required?	true
Position?	named
Default value	0
Accept pipeline input?	false
Accept wildcard characters?	False

-DataProtectionLevel <String>

Specify the StoreVirtual protection level (aka Network RAID) for the volume. Allowed values are:

* NetworkRaid0None
* NetworkRaid5SingleParity
* NetworkRaid10Mirror2Way
* NetworkRaid10Mirror3Way
* NetworkRaid10Mirror4Way
* NetworkRaid6DualParity

Aliases	None
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Description <String>

Provide a description for the volume.

Aliases	None
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-EnableAdaptiveOptimization <SwitchParameter>

Whether or not Adaptive Optimization is enabled on the storage volume. Only supported with StoreVirtual

Aliases	None
Required?	false
Position?	named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-EnableCompression <Boolean>

Enable compression for StoreServe (3PAR) supported resources. Please verify the InformOS version installed supports Compression.

Aliases	None
Required?	False
Position?	named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-EnableDeduplication <Boolean>

Enable deduplication for SSD-based Storage Pools (CPG).

Aliases	None
Required?	False
Position?	named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-Full <SwitchParameter>

NOTE: This parameter is being deprecated for the -ProvisionType parameter. Please update your scripts.

Include this switch to enable Thick volume provisioning. Omit to specify Thin storage provisioning. Default: Thin

Aliases	None
Required?	false
Position?	named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-Name <String>

Aliases [-VolumeName] Storage Volume Name. Device Volume created on the storage system will be this name without spaces.

Aliases	VolumeName
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-ProvisioningType <String>

Specify the type of volume to provision. Allowed values are:

* Thin
* Full
* TPDD (Thin Provision Dedup) - Only available for HPE StoreServ storage systems with SSD storage pools (aka CPG"s).

Aliases	ProvisionType
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Scope <HPOneView.Appliance.ScopeCollection>

Provide an HPOneView.Appliance.ScopeCollection resource object to initially associate with. Resource can also be added to scope using the Add-HPOVResourceToScope Cmdlet.

Aliases	None
Required?	False
Position?	named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-Shared <SwitchParameter>

Include this switch to mark the Storage Volume as a Shareable resource for shared volume access. Default: Private

Aliases	None
Required?	false
Position?	named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-SnapshotStoragePool <Object>

Aliases [-pool, -PoolName] Storage Pool URI, name or resource object.

Aliases	None
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-StoragePool <Object>

Aliases [-pool, -PoolName] Storage Pool URI, name or resource object.

Aliases	pool, poolName
Required?	true
Position?	named
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-StorageSystem <Object>

When the Storage Pool name is not unique, specify the Storage System name the pool is managed/associate with.

Aliases	None
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-VolumeTemplate <Object>

Aliases [-template, -svt] Specify the Storage Volume Template Name, URI or Resource.

Aliases	template, svt
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

HPOneView.Storage.Pool [System.Management.Automation.PSCustomObject]

Storage Pool resource object

Return Values

HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject]

Async create task

Examples

-------------------------- EXAMPLE 1 --------------------------

New-HPOVStorageVolume -name TestVol1 -PoolName PoolR1 -Size 60

Create a 60GB private, thin provisioned volume named "TestVol1" from the "PoolR1" Storage Pool.

-------------------------- EXAMPLE 2 --------------------------

Get-HPOVStoragePool PoolR1 | New-HPOVStorageVolume -name TestVol1 PoolR1 -Size 60

Get the "PoolR1" Storage Pool resource and pipe it to create a 60GB private, thin provisioned volume named "TestVol1".

-------------------------- EXAMPLE 3 --------------------------

Get-HPOVStoragePool PoolR1 -StorageSystem 3ParSys1 | New-HPOVStorageVolume -name TestVol1 -Size 60

Get the "PoolR1" Storage Pool resource and pipe it to create a 60GB private, thin provisioned volume named "TestVol1".

-------------------------- EXAMPLE 4 --------------------------

New-HPOVStorageVolume -name TestVol1 -StoragePool PoolR1 -StorageSystem 3ParSys1 -Size 60

Create a 60GB private, thin provisioned volume named "TestVol1" from the "PoolR1" Storage Pool resource that is managed by "3ParSys1".

-------------------------- EXAMPLE 5 --------------------------

$svt = Get-HPOVStorageVolumeTemplate SVT_120GB_R5 $New-HPOVStorageVolume testvol3 -volumetemplate $svt -capacity 90 | Wait-HPOVTaskComplete

Create a 90GB volume named "TestVol1", using the "SVT_120GB_R5" Storage Volume Template, then wait for volume to be provisioned.

HPE OneView 4.00 Library