Skip to content

ConvertTo HPOVStorageVolume

Jump to bottom
Chris Lynch edited this page Dec 4, 2019 · 33 revisions

Library Version 5.00

Library Version 4.20

Library Version 4.10

HPE OneView 5.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>]

Description

Storage volume snapshots can be converted to assignable and managed storage volume resources. You can create a full copy of a volume based on the data in the snapshot. For large volumes, this can take a long time, depending on storage system resources available for the copy action. When converting a snapshot to a storage volume, it will lose its parent/child relationship.

NOTE: You cannot create a volume from an HPE Nimble storage system snapshot from HPE OneView.

Minimum required Permissions: Infrastructure administrator or Storage administrator.

Parameters

-ApplianceConnection <Object>

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? false
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? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters?    False

-InputObject <Object>

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

$Volume = Get-HPOVStorageVolume -Name PrivVolume1 | Get-HPOVStorageVolumeSnapshot | Select-Object -Last 1
ConvertTo-HPOVStorageVolume -Name "Copy of PrivVolume1"

Get the most recent snapshot of PrivVolume1 and convert it to a volume.

 -------------------------- 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.20 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>]

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.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>]

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