Skip to content

ConvertTo HPOVStorageVolume

Jump to bottom
Chris Lynch edited this page Dec 10, 2020 · 33 revisions

Library Version 4.20

Library Version 4.10

Library Version 4.00

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

<CommonParameters>

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.

Related Links

HPE OneView 4.00 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

<CommonParameters>

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.

Related Links

Wiki Table of Contents

Clone this wiki locally