New HPOVStorageVolume

Library Version 2.00

Library Version 1.20

HPE OneView 2.00 Library

New-HPOVStorageVolume

Create a Storage Volume resource.

SYNTAX

New-HPOVStorageVolume [-VolumeName] <String> [-Description] <String> [-StoragePool] <Object> [-Capacity] <Int64> [-ApplianceConnection] <Object> [-StorageSystem] <String>[ [-Full] <SwitchParameter>][ [-Shared] <SwitchParameter>] [<CommonParameters>]

New-HPOVStorageVolume [-VolumeName] <String> [-Capacity] <Int64> [-VolumeTemplate] <Object> [-ApplianceConnection] <Object>[ [-Shared] <SwitchParameter>] [<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:ConnectSessions} | ? Default

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

-Capacity <Int64>

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

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

-Description <String>

Provide a description for the volume.

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

-Full <SwitchParameter>

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

-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

-StoragePool <Object>

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

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

-StorageSystem <String>

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

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

-VolumeName <String>

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

Aliases	name
Required?	true
Position?	0
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?	true
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

System.String Storage Pool Name or URI

System.Management.Automation.PSCustomObject Storage Pool resource object

Return Values

HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject] Async create task

Examples

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

PS C:\> New-HPOVStorageVolume -name TestVol1 -PoolName PoolR1 -Size 60

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

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

PS C:\> 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 --------------------------

PS C:\> 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 --------------------------

PS C:\> 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 --------------------------

PS C:\> $svt = Get-HPOVStorageVolumeTemplate SVT_120GB_R5 PS C:\> $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 1.20 Library

New-HPOVStorageVolume

Create a Storage Volume resource.

SYNTAX

New-HPOVStorageVolume [-volumeName] <volumeName>[ [-description] <description>] [-StoragePool] <StoragePool>[ [-StorageSystem] <StorageSystem>] [-capacity] <capacity>[ [-full] <full>][ [-shared] <shared>][ [-Permanent] <Permanent>] [<CommonParameters>]

New-HPOVStorageVolume [-volumeName] <volumeName> [-VolumeTemplate] <VolumeTemplate>[ [-capacity] <capacity>][ [-shared] <shared>][ [-Permanent] <Permanent>] [<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

-volumeName <volumeName>

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

Aliases	None.
Required?	true
Position?	1
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-description <description>

Optional. Provide a description for the volume.

Aliases	None.
Required?	false
Position?	2
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-StoragePool <StoragePool>

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

Aliases	None.
Required?	true
Position?	3
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	false

-StorageSystem <StorageSystem>

Optional. 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 <VolumeTemplate>

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

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

-capacity <capacity>

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

Aliases	None.
Required?	true
Position?	4
Default value	0
Accept pipeline input?	false
Accept wildcard characters?	false

-full <full>

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

-shared <shared>

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

-Permanent <Permanent>

DEPRECATED PARAMETER. Please use the New-HPOVProfileAttachVolume to create Ephemeral Volumes.

Aliases	None.
Required?	false
Position?	named
Default value	False
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

System.String Storage Pool Name or URI System.Management.Automation.PSCustomObject Storage Pool resource object

Return Values

>HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject] Async create task