Add HPOVStorageVolume

ℹ️ Note: This Wiki is going through a major change, and will be migrated to a new location. If you want to preview this new documentation, please go here.

Library Version 5.00

Library Version 4.20

Library Version 4.10

HPE OneView 5.00 Library

Add-HPOVStorageVolume

Import an existing Storage Volume resource.

Syntax

Add-HPOVStorageVolume [-StorageSystem] <Object> [-StorageDeviceName] <String> [-VolumeName] <String> [[-VolumeID] <String>] [[-Description] <String>] [[-Shared] <SwitchParameter>] [[-Scope] <HPOneView.Appliance.ScopeCollection>] [[-ApplianceConnection] <Object>] [<CommonParameters>]

Description

This Cmdlet will help add an existing storage volume that was provisioned on the Storage System. In order to import an existing storage volume, the following prerequisites must be met:

The storage system that contains the volume you want to add is being managed by the appliance, and the volume must be within the same 3Par virtual domain as the managed storage system.
The storage pool that contains the volume you want to add is being managed by the appliance.
The snapshot storage pool defined for the volume you want to add is being managed by the appliance.

The Storage Volume's WWN or device name will be needed, which can be retrieved from the storage system management console.

Privileges: 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:ConnectedSessions} | ? Default

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

-Description <String>

Provide a description for the volume.

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

-StorageDeviceName <String>

The Storage Systems Device Name of the volume. This can be found in either the 3PAR IMC, CLI or HPE SSMC by looking at the provisioned volume and copying the "Name" property.

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

-StorageSystem <Object>

The Storage System where the volume will be imported from. Volume to be imported must be provisioned to the same Managed Domain as the Storage System.

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

-VolumeID <String>

Warning: This parameter is deprecated. Please use the -StorageDeviceName parameter.

The 128bit WWN FC address of the volume to be imported. Address must be in the following format: AA:BB:CC:DD:EE:AA:BB:CC:DD:EE:AA:BB:CC:DD:EE:AA

Aliases	volid, id, wwn
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-VolumeName <String>

Specify the Storage Volume Name.

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

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

Storage Pool resource object

Return Values

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

Async create task

Examples

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

Add-HPOVStorageVolume -StorageSystem (Get-HPOVStorageSystem -Name 3ParSys1) -StorageDeviceName MyStorageVol1 -VolumeName MyStorageVol1

Import the volume "MyStorageVol1" from the "3ParSys1" Storage System.

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

Get-HPOVStorageSystem -Name 3ParSys1 | Add-HPOVStorageVolume -StorageDeviceName MyStorageVol1 -VolumeName MyStorageVol1

Import the volume "MyStorageVol1" from the "3ParSys1" Storage System using the pipeline.

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

Get-HPOVStorageSystem -Name 3ParSys1 | Add-HPOVStorageVolume -StorageDeviceName ClusterSharedVol1 -VolumeName ClusterSharedVol1 -Shared

Import a volume using the storage device name "ClusterSharedVol1" on the "3ParSys1" Storage System.

HPE OneView 4.20 Library

Add-HPOVStorageVolume

Import an existing Storage Volume resource.

Syntax

Add-HPOVStorageVolume [-StorageSystem] <Object> [-StorageDeviceName] <String> [-VolumeName] <String> [-VolumeID] <String> [-Description] <String> [[-Shared] <SwitchParameter>] [[-Scope] <HPOneView.Appliance.ScopeCollection>] [-ApplianceConnection] <Object> [<CommonParameters>]

Description

This cmdlet will help add an existing storage volume that was provisioned on the Storage System. The volume should not be exported or assigned to a server or groups of servers. The Storage Volume also must reside in the Managed Domain of the Stroage System that the appliance managed. The Storage Volume"s WWN will be needed.

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	Appliance
Required?	true
Position?	named
Default value	(${Global:ConnectedSessions} \| ? Default)
Accept pipeline input?	true (ByPropertyName)
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

-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

-StorageDeviceName <String>

The Storage Systems" Device Name of the volume. This can be found in either the 3PAR IMC, CLI or HPE SSMC by looking at the provisionined volume and copying the "Name" property.

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

-StorageSystem <Object>

The Storage System where the volume will be imported from. Volume to be imported must be provisioned to the same Managed Domain as the Storage System.

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

-VolumeID <String>

Aliases [-volid, -id, -wwn] The 128bit WWN FC address of the volume to be imported. Address must be in the following format: AA:BB:CC:DD:EE:AA:BB:CC:DD:EE:AA:BB:CC:DD:EE:AA

Aliases	volid, id, wwn
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-VolumeName <String>

Aliases [-name] Specify the Storage Volume Name.

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

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

Storage Pool resource object

Return Values

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

Async create task

Examples

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

Add-HPOVStorageVolume -StorageSystem 3ParSys1 -VolumeID 50:00:2A:C0:03:1E:15:2C -VolumeName "MyStorageVol1"

Import the volume "50:00:2A:C0:03:1E:15:2C" from the "3ParSys1" Storage System.

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

Get-HPOVStorageSystem 3ParSys1 | Add-HPOVStorageVolume -VolumeID 50:00:2A:C0:03:1E:15:2C -VolumeName "MyStorageVol1"

Import the volume "50:00:2A:C0:03:1E:15:2C" from the "3ParSys1" Storage System.

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

Get-HPOVStorageSystem 3ParSys1 | Add-HPOVStorageVolume -StorageDeviceName "MyStorageVolName1" -VolumeName "MyStorageVol1"

Import a volume using the storage device name "MyStorageVolName1" on the "3ParSys1" Storage System.

HPE OneView 4.10 Library

Add-HPOVStorageVolume

Import an existing Storage Volume resource.

Syntax

Add-HPOVStorageVolume [-StorageSystem] <Object> [-StorageDeviceName] <String> [-VolumeName] <String> [-VolumeID] <String> [-Description] <String> [[-Shared] <SwitchParameter>] [[-Scope] <HPOneView.Appliance.ScopeCollection>] [-ApplianceConnection] <Object> [<CommonParameters>]

Description

This cmdlet will help add an existing storage volume that was provisioned on the Storage System. The volume should not be exported or assigned to a server or groups of servers. The Storage Volume also must reside in the Managed Domain of the Stroage System that the appliance managed. The Storage Volume"s WWN will be needed.

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	Appliance
Required?	true
Position?	named
Default value	(${Global:ConnectedSessions} \| ? Default)
Accept pipeline input?	true (ByPropertyName)
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

-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

-StorageDeviceName <String>

The Storage Systems" Device Name of the volume. This can be found in either the 3PAR IMC, CLI or HPE SSMC by looking at the provisionined volume and copying the "Name" property.

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

-StorageSystem <Object>

The Storage System where the volume will be imported from. Volume to be imported must be provisioned to the same Managed Domain as the Storage System.

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

-VolumeID <String>

Aliases [-volid, -id, -wwn] The 128bit WWN FC address of the volume to be imported. Address must be in the following format: AA:BB:CC:DD:EE:AA:BB:CC:DD:EE:AA:BB:CC:DD:EE:AA

Aliases	volid, id, wwn
Required?	true
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-VolumeName <String>

Aliases [-name] Specify the Storage Volume Name.

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