ConvertTo HPOVStorageVolume - HewlettPackard/POSH-HPEOneView GitHub Wiki

HPE OneView 4.10 Library

ConvertTo-HPOVStorageVolume

Convert an existing Storage Volume Snapshot to a Storage Volume.

SYNTAX

ConvertTo-HPOVStorageVolume [-InputObject] <Object> [-Name] <String> [-Description] <String> [-SharingMode] <String> [-ApplianceConnection] <Object>[ [-Async] <SwitchParameter>] [<CommonParameters>]

Detailed Description

Storage Volume Snapshots can be converted to assignable and managed Storage Volume resources. When converting a Snapshot to a Storag Volume, it will lose its parent/child relationship.

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?	4
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

-Description <String>

The description of the storage volume.

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

-InputObject <Object>

Aliases [-Snapshot]

Provide the snapshot resource object to convert managed by the appliance.

Aliases	Snapshot
Required?	true
Position?	0
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-Name <String>

The Storage Volume Name.

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

-SharingMode <String>

Specify if the new storage volume should be Private or Shared.

Aliases	None
Required?	true
Position?	3
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.VolumeSnapshot [System.Management.Automation.PSCustomObject]

Storage Volume Snapshot resource object.

Return Values

System.Collections.ArrayList <HPOneView.Appliance.TaskResource>

Multiple resources

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

Create Storage Volume async task.

Examples

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

Get-HPOVStorageVolume

Return all storage volume resource objects.

 -------------------------- EXAMPLE 2 --------------------------
$Snapshots = Get-HPOVStorageVolume "Volume 1" | Get-HPOVStorageVolumeSnapshot
$Snapshots | ? { ((Get-Date $_.created -Format d) -eq (Get-Date 02/23/2016 -format d)} | ConvertTo-HPOVStorageVolume -Name "Copy of Volume 1" | Wait-HPOVTaskComplete

Get all of the available storage volume snapshots for "Volume 1", then convert the snapshot created on the specified date to a storage volume resource.

HPE OneView 4.00 Library