Convert HPOVServerProfileTemplate - HewlettPackard/POSH-HPEOneView GitHub Wiki

HPE OneView 4.10 Library

Convert-HPOVServerProfileTemplate

Migrate Server Profile Template.

SYNTAX

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

Detailed Description

Use this Cmdlet to change the Server Hardware Type and/or Enclosure Group set within the Server Profile Template. 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 for HPE Synergy 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.

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.ServerProfileTemplate object from Get-HPOVServerProfileTemplate.

Aliases	ServerProfileTemplate, SPT
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 <SwitchParameter>

default content

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

The Server Profile Template 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 --------------------------

$SPT = Get-HPOVServerProfileTemplate -Name "My Template Name" -ErrorAction Stop $NewServerHardwareType = Get-HPOVServerHardwareType -Name "SY480 Gen10 2" -ErrorAction Stop Convert-HPOVServerProfileTemplate -InputObject $SPT -ServerHardwareType $NewServerHardwareType

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

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

$SPT = Get-HPOVServerProfileTemplate -Name "My Template Name" -ErrorAction Stop $NewEnclosureGroup = Get-HPOVEnclosureGroup -Name "Dev EG 1" -ErrorAction Stop Convert-HPOVServerProfileTemplate -InputObject $SPT -EnclosureGroup $NewEnclosureGroup

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

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

$SPT = Get-HPOVServerProfileTemplate -Name "My Template Name" -ErrorAction Stop $NewEnclosureGroup = Get-HPOVEnclosureGroup -Name "Dev EG 1" -ErrorAction Stop $NewServerHardwareType = Get-HPOVServerHardwareType -Name "BL460 Gen9 3" -ErrorAction Stop Convert-HPOVServerProfileTemplate -InputObject $SPT -EnclosureGroup $NewEnclosureGroup -ServerHardwareType $NewServerHardwareType

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

HPE OneView 4.00 Library