New HPOVServerProfileAttachVolume - HewlettPackard/POSH-HPEOneView GitHub Wiki

HPE OneView 4.10 Library

New-HPOVServerProfileAttachVolume

Create volume attachment for a server profile.

SYNTAX

New-HPOVServerProfileAttachVolume [-Volume] <Array> [-VolumeID] <Int32> [-LunIdType] <String>[ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]
New-HPOVServerProfileAttachVolume [-Name] <Object> [-ServerProfile] <Object>[ [-PassThru] <SwitchParameter>] [-VolumeID] <Int32>[ [-VolumeTemplate] <Object>] [-StoragePool] <Object> [-SnapshotStoragePool] <Object> [-StorageSystem] <Object> [-Capacity] <Int64>[ [-ProvisioningType] <String>][ [-Full] <SwitchParameter>][ [-Permanent] <SwitchParameter>][ [-DataProtectionLevel] <String>][ [-EnableAdaptiveOptimization] <Bool>] [-LunIdType] <String> [-LunID] <Int32> [-HostOStype] <String>[ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]
New-HPOVServerProfileAttachVolume [-ServerProfile] <Object> [-Volume] <Array>[ [-PassThru] <SwitchParameter>] [-VolumeID] <Int32> [-LunIdType] <String> [-LunID] <Int32> [-HostOStype] <String>[ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]

Detailed Description

This Cmdlet will assist with creating a Storage Volume object to then attach to a new Server Profile being created (New-HPOVServerProfile), and attach either an existing Storage Volume (Get-HPOVStorageVolume) or new Ephemeral Volume to an existing Server Profile (Get-HPOVServerProfile). If attempting to attach to an existing Server Profile, the HostOSType parameter is required, and will enable SAN Management within the Server Profile, if the Server Hardware resource supports the feature.

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s). 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

-BootVolume <SwitchParameter>

Aliases [-Bootable]

Use to indicate this volume is a bootable device. When using this parameter, the Server Profile"s FC Connection(s) BootVolumeSource parameter set to "ManagedVolume".

This parameter is only applicable with Private volumes.

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

-Capacity <Int64>

The requested Ephemeral Volume storage capacity in GB. e.g. 20 to specify 20GB.

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

-DataProtectionLevel <String>

Specify the StoreVirtual protection level (aka Network RAID) for the volume. Allowed values are:

* NetworkRaid0None
* NetworkRaid5SingleParity
* NetworkRaid10Mirror2Way
* NetworkRaid10Mirror3Way
* NetworkRaid10Mirror4Way
* NetworkRaid6DualParity
Aliases None
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?    False

-EnableAdaptiveOptimization <Bool>

Specify if HPE StoreVirtual volume Adaptive Optimization is enabled.

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

-Full <SwitchParameter>

DEPRECATED. This parameter is replaced by ProvisioningType.

Specify if the Ephemeral Volume provisioning type should be Thick. Default is Thin Volume.

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

-HostOStype <String>

Aliases [-OS]

Specify the Host OS type, which will set the Host OS value when HPE OneView creates the Host object on the Storage System. This parameter is only necessary if the Server Profile object does not have SAN Management enabled.

Accepted values:

* CitrixXen = "Citrix Xen Server 5.x/6.x"
* AIX       = "AIX"
* IBMVIO    = "IBM VIO Server"
* RHEL4     = "RHE Linux (Pre RHEL 5)"
* RHEL3     = "RHE Linux (Pre RHEL 5)"
* RHEL      = "RHE Linux (5.x, 6.x)"
* RHEV      = "RHE Virtualization (5.x, 6.x)"
* VMware    = "ESX 4.x/5.x"
* Win2k3    = "Windows 2003"
* Win2k8    = "Windows 2008/2008 R2"
* Win2k12   = "Windows 2012 / WS2012 R2"
* OpenVMS   = "OpenVMS"
* Egenera   = "Egenera"
* Exanet    = "Exanet"
* Solaris9  = "Solaris 9/10"
* Solaris10 = "Solaris 9/10"
* Solaris11 = "Solaris 11"
* ONTAP     = "NetApp/ONTAP"
* OEL       = "OE Linux UEK (5.x, 6.x)"
* HPUX11iv1 = "HP-UX (11i v1, 11i v2)"
* HPUX11iv2 = "HP-UX (11i v1, 11i v2)"
* HPUX11iv3 = "HP-UX (11i v3)"
* SUSE      = "SuSE (10.x, 11.x)"
* SUSE9     = "SuSE Linux (Pre SLES 10)"
* Inform    = "InForm"
Aliases OS
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?    False

-LunID <Int32>

The Host LUN ID numerical value that will be configured in the Volume export on the Storage System. Accepted range: 0-254

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

-LunIdType <String>

Aliases [-type] Specify Auto or Manual for the LUN ID assignment type. If Manual, use the -LunID parameter and provide a numerical value.

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

-Name <Object>

Ephemeral Storage Volume resource name.

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

-PassThru <SwitchParameter>

Use this parameter to return the modified Server Profile object. In order to save the changes, please use the Save-HPOVServerProfile Cmdlet.

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

-Permanent <SwitchParameter>

Specify if the Ephemeral Volume should be permanent.

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

-ProvisioningType <String>

Specify the volume provisioning type. Supported values:

* Thin
* Full
* ThinDeduplication (only supported with HPE StoreServe)
Aliases None
Required? False
Position? named
Default value Thin
Accept pipeline input? false
Accept wildcard characters?    False

-ServerProfile <Object>

An existing Server Profile resource object from Get-HPOVServerProfile Cmdlet.

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

-SnapshotStoragePool <Object>

The supported Snapshot storage pool for a StoreServ storage system. Snapshot storage pool must originate from the same storage system as the assigned storage pool.

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

-StoragePool <Object>

The Storage Resource Pool object to provision the Ephemeral Volume from.

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

-StorageSystem <Object>

If provided a StoragePool Resource Name, you must provide the StorageSystem name value if there are multiple Storage Pool resources with the same name.

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

-TargetAddresses <Array>

An array of target Port ID(s) or WWN(s). Example: @("1:0:1", "1:2:1", "3:1:1", "4:0:0")

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

-TargetPortAssignment <SwitchParameter>

Define whether host initiator port(s) should be mapped to target storage ports automatically or manually.

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

-Volume <Array>

The Volume Name, URI or Object to attach.

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

-VolumeID <Int32>

Aliases [-id] The numeric identifier for this volume. Does not pertain to exported LUN ID value on array.

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

-VolumeTemplate <Object>

For Ephemeral (private) volumes that should be provisioned from Storage Volume Templates. Provide a valid resource from Get-HPOVStorageVolumeTemplate.

Aliases None
Required? False
Position? named
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

System.String

Storage Volume Name or URI

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

Storage Volume Resource object

Return Values

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

When attaching a one or more Storage Volumes to an existing Server Profile, an Appliance Async Task will be created

HPOneView.Profile.SanVolume [System.Management.Automation.PSCustomObject]

Returns a storage volume attachment object which may be used during profile creation.

Examples

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

$attachVolume = New-HPOVServerProfileAttachVolume -volumeid 1 -volume Volume1

Create a Volume Attach object that maps to the "Volume1" storage volume with an Auto assigned Host LUN ID.

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

$attachVolume = Get-HPOVStorageVolume Volume1 | New-HPOVServerProfileAttachVolume -volumeid 1

Get the "Volume1" Storage Volume via the Get-HPOVStorageVolume Cmdlet, and pipe the resource object to the Get-HPOVServerProfileAttachVolume Cmdlet.

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

$attachVolume = Get-HPOVStorageVolume Volume1 | New-HPOVServerProfileAttachVolume -volumeid 1 -lunidtype manual -lunid 1

Get the "Volume1" Storage Volume via the Get-HPOVStorageVolume Cmdlet, and pipe the resource object to the Get-HPOVServerProfileAttachVolume Cmdlet, providing a manual Host LUN ID.

 -------------------------- EXAMPLE 4 --------------------------

$volume1 = Get-HPOVStorageVolume Volume1 | New-HPOVServerProfileAttachVolume -volumeid 1 $volume2 = Get-HPOVStorageVolume SharedVolume1 | New-HPOVServerProfileAttachVolume -volumeid 2 $attachVolumes = @($volume1,$volume2)

Get the "Volume1" and "SharedVolume1" Storage Volumes via the Get-HPOVStorageVolume Cmdlet, and pipe the resource objects to the Get-HPOVServerProfileAttachVolume Cmdlet, saving to $attachVolumes array.

 -------------------------- EXAMPLE 5 --------------------------

$storagepool = Get-HPOVStoragePool R1_FC $sp = Get-HPOVServerProfile "chef-web01" New-HPOVServerProfileAttachVolume -ServerProfile $sp -Name "Chef Web01 Vol 2" -StoragePool $storagepool | Wait-HPOVTaskComplete

Attach a new 10Gb Ephemeral Volume to an existing Server Profile.

 -------------------------- EXAMPLE 6 --------------------------

$sp = Get-HPOVServerProfile "chef-web01" Get-HPOVStorageVolume "My New Volume 3" | New-HPOVServerProfileAttachVolume -ServerProfile $sp | Wait-HPOVTaskComplete

Attach an existing Storage Volume to a Server Profile.

 -------------------------- EXAMPLE 7 --------------------------

$storagepool = Get-HPOVStoragePool R1_FC $sp = Get-HPOVServerProfile "My Server Profile" New-HPOVServerProfileAttachVolume -Name "My Server Profile Boot Vol" -ServerProfile $sp -StoragePool $storagepool -Bootable | Wait-HPOVTaskComplete

Add a bootable volume to an existing Server Profile.

 -------------------------- EXAMPLE 8 --------------------------

$SVT = Get-HPOVStorageVolumeTemplate -Name StoreServe4-TPDD-SVT -ErrorAction Stop $StorageVolumeObject = New-HPOVServerProfileAttachVolume -Name "Template 3 Private Vol 1" -VolumeTemplate $SVT

Create a new ephemeral storage volume attachment, using a storage volume template.

Related Links


Top

HPE OneView 4.00 Library

New-HPOVServerProfileAttachVolume

Create volume attachment for a server profile.

SYNTAX

New-HPOVServerProfileAttachVolume [-Volume] <Array> [-VolumeID] <Int32> [-LunIdType] <String>[ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]
New-HPOVServerProfileAttachVolume [-Name] <Object>[ [-VolumeTemplate] <Object>] [-ServerProfile] <Object>[ [-PassThru] <SwitchParameter>] [-VolumeID] <Int32> [-Capacity] <Int64>[ [-ProvisioningType] <String>][ [-Full] <SwitchParameter>][ [-Permanent] <SwitchParameter>][ [-DataProtectionLevel] <String>][ [-EnableAdaptiveOptimization] <Bool>] [-LunIdType] <String> [-LunID] <Int32> [-HostOStype] <String>[ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]
New-HPOVServerProfileAttachVolume [-ServerProfile] <Object> [-Name] <Object> [-StoragePool] <Object>[ [-PassThru] <SwitchParameter>] [-VolumeID] <Int32> [-StorageSystem] <Object> [-Capacity] <Int64>[ [-ProvisioningType] <String>][ [-Full] <SwitchParameter>][ [-Permanent] <SwitchParameter>][ [-DataProtectionLevel] <String>][ [-EnableAdaptiveOptimization] <Bool>] [-LunIdType] <String> [-LunID] <Int32> [-HostOStype] <String>[ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]
New-HPOVServerProfileAttachVolume [-ServerProfile] <Object> [-Volume] <Array>[ [-PassThru] <SwitchParameter>] [-VolumeID] <Int32> [-LunIdType] <String> [-LunID] <Int32> [-HostOStype] <String>[ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]
New-HPOVServerProfileAttachVolume [-Name] <Object> [-StoragePool] <Object> [-LunIdType] <String> [-LunID] <Int32> [-VolumeID] <Int32> [-StorageSystem] <Object> [-Capacity] <Int64>[ [-ProvisioningType] <String>][ [-Full] <SwitchParameter>][ [-Permanent] <SwitchParameter>][ [-DataProtectionLevel] <String>][ [-EnableAdaptiveOptimization] <Bool>][ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]
New-HPOVServerProfileAttachVolume [-Name] <Object> [-StoragePool] <Object> [-VolumeID] <Int32> [-StorageSystem] <Object> [-Capacity] <Int64>[ [-ProvisioningType] <String>][ [-Full] <SwitchParameter>][ [-Permanent] <SwitchParameter>][ [-DataProtectionLevel] <String>][ [-EnableAdaptiveOptimization] <Bool>] [-LunIdType] <String>[ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]
New-HPOVServerProfileAttachVolume [-Volume] <Array> [-LunIdType] <String> [-LunID] <Int32> [-VolumeID] <Int32>[ [-BootVolume] <SwitchParameter>][ [-TargetPortAssignment] <SwitchParameter>][ [-TargetAddresses] <Array>] [-ApplianceConnection] <Object> [<CommonParameters>]
New-HPOVServerProfileAttachVolume[ [-Permanent] <SwitchParameter>][ [-EnableAdaptiveOptimization] <Bool>] [<CommonParameters>]
New-HPOVServerProfileAttachVolume[ [-Permanent] <SwitchParameter>][ [-EnableAdaptiveOptimization] <Bool>] [<CommonParameters>]

Detailed Description

This Cmdlet will assist with creating a Storage Volume object to then attach to a new Server Profile being created (New-HPOVServerProfile), and attach either an existing Storage Volume (Get-HPOVStorageVolume) or new Ephemeral Volume to an existing Server Profile (Get-HPOVServerProfile). If attempting to attach to an existing Server Profile, the HostOSType parameter is required, and will enable SAN Management within the Server Profile, if the Server Hardware resource supports the feature.

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s). 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? false
Accept wildcard characters?    False

-BootVolume <SwitchParameter>

Aliases [-Bootable]

Use to indicate this volume is a bootable device. When using this parameter, the Server Profile's FC Connection(s) BootVolumeSource parameter set to 'ManagedVolume'.

This parameter is only applicable with Private volumes.

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

-Capacity <Int64>

The requested Ephemeral Volume storage capacity in GB. e.g. 20 to specify 20GB.

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

-DataProtectionLevel <String>

Specify the StoreVirtual protection level (aka Network RAID) for the volume. Allowed values are:

* NetworkRaid0None
* NetworkRaid5SingleParity
* NetworkRaid10Mirror2Way
* NetworkRaid10Mirror3Way
* NetworkRaid10Mirror4Way
* NetworkRaid6DualParity
Aliases None
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?    False

-EnableAdaptiveOptimization <Bool>

Specify if HPE StoreVirtual volume Adaptive Optimization is enabled.

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

-Full <SwitchParameter>

DEPRECATED. This parameter is replaced by ProvisioningType.

Specify if the Ephemeral Volume provisioning type should be Thick. Default is Thin Volume.

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

-HostOStype <String>

Aliases [-OS]

Specify the Host OS type, which will set the Host OS value when HP OneView creates the Host object on the Storage System. This parameter is only necessary if the Server Profile object does not have SAN Management enabled.

Accepted values:

* CitrixXen = "Citrix Xen Server 5.x/6.x"
* AIX       = "AIX"
* IBMVIO    = "IBM VIO Server"
* RHEL4     = "RHE Linux (Pre RHEL 5)"
* RHEL3     = "RHE Linux (Pre RHEL 5)"
* RHEL      = "RHE Linux (5.x, 6.x)"
* RHEV      = "RHE Virtualization (5.x, 6.x)"
* VMware    = "ESX 4.x/5.x"
* Win2k3    = "Windows 2003"
* Win2k8    = "Windows 2008/2008 R2"
* Win2k12   = "Windows 2012 / WS2012 R2"
* OpenVMS   = "OpenVMS"
* Egenera   = "Egenera"
* Exanet    = "Exanet"
* Solaris9  = "Solaris 9/10"
* Solaris10 = "Solaris 9/10"
* Solaris11 = "Solaris 11"
* ONTAP     = "NetApp/ONTAP"
* OEL       = "OE Linux UEK (5.x, 6.x)"
* HPUX11iv1 = "HP-UX (11i v1, 11i v2)"
* HPUX11iv2 = "HP-UX (11i v1, 11i v2)"
* HPUX11iv3 = "HP-UX (11i v3)"
* SUSE      = "SuSE (10.x, 11.x)"
* SUSE9     = "SuSE Linux (Pre SLES 10)"
* Inform    = "InForm"
Aliases OS
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters?    False

-LunID <Int32>

The Host LUN ID numerical value that will be configured in the Volume export on the Storage System. Accepted range: 0-254

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

-LunIdType <String>

Aliases [-type] Specify Auto or Manual for the LUN ID assignment type. If Manual, use the -LunID parameter and provide a numerical value.

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

-Name <Object>

Ephemeral Storage Volume resource name.

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

-PassThru <SwitchParameter>

Use this parameter to return the modified Server Profile object. In order to save the changes, please use the Save-HPOVServerProfile Cmdlet.

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

-Permanent <SwitchParameter>

Specify if the Ephemeral Volume should be permanent.

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

-ProvisioningType <String>

Specify the volume provisioning type. Supported values:

* Thin
* Full
* ThinDeduplication (only supported with HPE StoreServe)
Aliases None
Required? False
Position? named
Default value Thin
Accept pipeline input? false
Accept wildcard characters?    False

-ServerProfile <Object>

An existing Server Profile resource object from Get-HPOVServerProfile Cmdlet.

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

-StoragePool <Object>

The Storage Resource Pool object to provision the Ephemeral Volume from.

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

-StorageSystem <Object>

If provided a StoragePool Resource Name, you must provide the StorageSystem name value if there are multiple Storage Pool resources with the same name.

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

-TargetAddresses <Array>

An array of target Port ID(s) or WWN(s). Example: @('1:0:1', '1:2:1', '3:1:1', '4:0:0')

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

-TargetPortAssignment <SwitchParameter>

Define whether host initiator port(s) should be mapped to target storage ports automatically or manually.

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

-Volume <Array>

The Volume Name, URI or Object to attach.

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

-VolumeID <Int32>

Aliases [-id] The numeric identifier for this volume. Does not pertain to exported LUN ID value on array.

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

-VolumeTemplate <Object>

For Ephemeral (private) volumes that should be provisioned from Storage Volume Templates. Provide a valid resource from Get-HPOVStorageVolumeTemplate.

Aliases None
Required? False
Position? named
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

System.String

Storage Volume Name or URI

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

Storage Volume Resource object

Return Values

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

When attaching a one or more Storage Volumes to an existing Server Profile, an Appliance Async Task will be created

HPOneView.Profile.SanVolume [System.Management.Automation.PSCustomObject]

Returns a storage volume attachment object which may be used during profile creation.

Examples

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

$attachVolume = New-HPOVServerProfileAttachVolume -volumeid 1 -volume Volume1

Create a Volume Attach object that maps to the 'Volume1' storage volume with an Auto assigned Host LUN ID.

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

$attachVolume = Get-HPOVStorageVolume Volume1 | New-HPOVServerProfileAttachVolume -volumeid 1

Get the 'Volume1' Storage Volume via the Get-HPOVStorageVolume Cmdlet, and pipe the resource object to the Get-HPOVServerProfileAttachVolume Cmdlet.

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

$attachVolume = Get-HPOVStorageVolume Volume1 | New-HPOVServerProfileAttachVolume -volumeid 1 -lunidtype manual -lunid 1

Get the 'Volume1' Storage Volume via the Get-HPOVStorageVolume Cmdlet, and pipe the resource object to the Get-HPOVServerProfileAttachVolume Cmdlet, providing a manual Host LUN ID.

 -------------------------- EXAMPLE 4 --------------------------

$volume1 = Get-HPOVStorageVolume Volume1 | New-HPOVServerProfileAttachVolume -volumeid 1 $volume2 = Get-HPOVStorageVolume SharedVolume1 | New-HPOVServerProfileAttachVolume -volumeid 2 $attachVolumes = @($volume1,$volume2)

Get the 'Volume1' and 'SharedVolume1' Storage Volumes via the Get-HPOVStorageVolume Cmdlet, and pipe the resource objects to the Get-HPOVServerProfileAttachVolume Cmdlet, saving to $attachVolumes array.

 -------------------------- EXAMPLE 5 --------------------------

$storagepool = Get-HPOVStoragePool R1_FC $sp = Get-HPOVServerProfile 'chef-web01' New-HPOVServerProfileAttachVolume -ServerProfile $sp -Name 'Chef Web01 Vol 2' -StoragePool $storagepool | Wait-HPOVTaskComplete

Attach a new 10Gb Ephemeral Volume to an existing Server Profile.

 -------------------------- EXAMPLE 6 --------------------------

$sp = Get-HPOVServerProfile 'chef-web01' Get-HPOVStorageVolume 'My New Volume 3' | New-HPOVServerProfileAttachVolume -ServerProfile $sp | Wait-HPOVTaskComplete

Attach an existing Storage Volume to a Server Profile.

 -------------------------- EXAMPLE 7 --------------------------

$storagepool = Get-HPOVStoragePool R1_FC $sp = Get-HPOVServerProfile 'My Server Profile' New-HPOVServerProfileAttachVolume -Name 'My Server Profile Boot Vol' -ServerProfile $sp -StoragePool $storagepool -Bootable | Wait-HPOVTaskComplete

Add a bootable volume to an existing Server Profile.

 -------------------------- EXAMPLE 8 --------------------------

$SVT = Get-HPOVStorageVolumeTemplate -Name StoreServe4-TPDD-SVT -ErrorAction Stop $StorageVolumeObject = New-HPOVServerProfileAttachVolume -Name 'Template 3 Private Vol 1' -VolumeTemplate $SVT

Create a new ephemeral storage volume attachment, using a storage volume template.

Related Links


Top
⚠️ **GitHub.com Fallback** ⚠️