Convert HPOVServerProfile - HewlettPackard/POSH-HPEOneView GitHub Wiki

HPE OneView 4.10 Library

Convert-HPOVServerProfile

Migrate Server Profile.

SYNTAX

Convert-HPOVServerProfile [-InputObject] <Object>[ [-ServerHardwareType] <Object>][ [-EnclosureGroup] <Object>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Array>] [-WhatIf] <>[ [-Confirm] <SwitchParameter>] [<CommonParameters>]

Detailed Description

Use this Cmdlet to change the Server Hardware Type and/or Enclosure Group set within the Server Profile. Changing to a different server hardware type may change the capabilities available to the server profile. Changing the enclosure group may change the connections which are available for the profile.

* The server hardware field will be set to "unassigned", requiring re-seletion of server hardware.
* It may also cause incompatibilities with the current configuration.
* All deployed connections will have their port assignment set to "Auto".
* Any incompatibilities will be flagged when the server profile is committed.
* If the new server hardware type does not support the local storage configuration, some storage may be lost.
* If the enclosure group is changed, mezzanine storage is lost and the disk drives are released.
* To prevent data loss, cancel this operation and backup data before applying the profile.
* Any change in the server hardware type will lead to the associated volume loss.
* If the server profile is associated with a server profile template, the server profile will become inconsistent with the template.  The server profile should be unassociated with the template before or after the migration.

Required Permissions: Infrastructure administrator or Server administrator.

Parameters

-ApplianceConnection <Array>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s).

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

-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

-Confirm <SwitchParameter>

Override confirmation prompt.

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

-EnclosureGroup <Object>

Specify the target HPOneView.EnclosureGroup resource object. By changing the Enclosure Group, assigned Networks with Connections that do not exist on in the associated Logical Interconnect Group(s), the Connection may not be assigned to an available FlexNIC.

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

-InputObject <Object>

The HPOneView.ServerProfile object from Get-HPOVServerProfile.

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

-ServerHardwareType <Object>

Specify the HPOneView.ServerHardwareType object to transform to. BIOS Settings will be reset to defaults, and Connection FlexNIC assignment will be reset back to Auto.

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

-WhatIf <>

Aliases	wi
Required?
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.ServerProfile

The Server Profile resource object to transform.

Return Values

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

Async Task resource to monitor progress of the Server Profile transformation.

Examples

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

$ServerProfile = Get-HPOVServerProfile -Name "Prod Server 1" -ErrorAction Stop $NewServerHardwareType = Get-HPOVServerHardwareType -Name "BL460 Gen9 3" -ErrorAction Stop Convert-HPOVServerProfile -InputObject $ServerProfile -ServerHardwareType $NewServerHardwareType

Transform the specified server profile object to a different server hardware type resource.

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

$ServerProfile = Get-HPOVServerProfile -Name "Prod Server 1" -ErrorAction Stop $NewEnclosureGroup = Get-HPOVEnclosureGroup -Name "Dev EG 1" -ErrorAction Stop Convert-HPOVServerProfile -InputObject $ServerProfile -EnclosureGroup $NewEnclosureGroup

Transform the specified server profile object to a different enclosure group resource.

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

$ServerProfile = Get-HPOVServerProfile -Name "Prod Server 1" -ErrorAction Stop $NewEnclosureGroup = Get-HPOVEnclosureGroup -Name "Dev EG 1" -ErrorAction Stop $NewServerHardwareType = Get-HPOVServerHardwareType -Name "BL460 Gen9 3" -ErrorAction Stop Convert-HPOVServerProfile -InputObject $ServerProfile -EnclosureGroup $NewEnclosureGroup -ServerHardwareType $NewServerHardwareType

Transform the specified server profile object to a different enclosure group and server hardware type resource.

HPE OneView 4.00 Library