Add HPOVStorageVolume

ℹ️ Note: This Wiki is no longer the source for HPE OneView PowerShell Library documentation. The new location is here.

Please update your local offline help system using Get-Help <ModuleName> to dwonload the latest offline help contents.

Library Version 5.00

Library Version 4.20

Library Version 4.10

HPE OneView

Library

5.00

Add-HPOVStorageVolume

Syntax

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

Description

A volume represents a logical disk provisioned from a storage pool on a storage system.

A volume can be used by a single server (private) or can be used by multiple servers (shared).

You can attach volumes to one or more servers by configuring a volume attachment in the server profile. The volume attachment manages volume presentation on the storage system (StoreServ port selection, host and vLUN creation) as well as SAN zoning on SANs (with automatic zoning enabled) that connect the server and storage system.

Using volume templates, you can create multiple volumes with the same configuration.

You can increase (grow) the capacity of a volume by editing it. You cannot decrease the capacity of a volume.

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.

Minimum required 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.

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

Library

4.20

Add-HPOVStorageVolume

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

Library

4.10

Add-HPOVStorageVolume

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