DESCRIPTION

This cmdlet is used to create or import an HP OneView Server Profile. A server profile is the configuration for a server instance. Server profiles capture the entire server configuration in one place, enabling you to consistently replicate new server
profiles and to rapidly modify them to reflect changes in your data center. A server profile includes: ? Basic server identification information ? Connectivity settings for Ethernet networks, network sets, and Fibre Channel networks ? Firmware versions ? Local
storage settings ? SAN storage settings ? BIOS settings ? Boot order ? Physical or virtual UUIDs, MAC addresses, and WWN addresses You can create an unassigned server profile that serves as a template. Typically, you capture best-practice configurations in
a server profile template, and then copy and deploy instances as individual server profiles. Similar to virtual machine (VM) templates, profiles enable you to create a provisioning baseline for server hardware types in an enclosure. When you create a server
profile, it is designated for a server hardware type and enclosure group (for server blades), whether the profile is assigned or unassigned.

PARAMETERS

-name <String>

The name of the server profile resource to be created.

Aliases

None

Required?

true

Position?

1

Default value

<none>

Accept pipeline input?

false

Accept wildcard characters?

false

-server [<Object>]

The server hardware resource where the new profile is to be applied. This is normally retrieved with a 'Get-HPOVServer' call, and the Server state property should be "NoProfileApplied". Can also be the Server Hardware name or URI.

Aliases

None

Required?

false

Position?

2

Default value

unassigned

Accept pipeline input?

true (ByValue)

Accept wildcard characters?

false

-description [<String>]

Optional description for this server profile.

Aliases

None

Required?

false

Position?

3

Default value

<none>

Accept pipeline input?

false

Accept wildcard characters?

false

-connections [<Array>]

The network connections that are to be part of this new server profile. This an array of profile conneciton objects which may be created with 'New-HPOVProfileConnection'.

BIOS Settings that are to be managed. You can get the BIOS settings available from Get-HPOVServerHarwareType and the returned biosSettings property.

Aliases

None

Required?

false

Position?

named

Default value

@()

Accept pipeline input?

false

Accept wildcard characters?

false

-boot [<SwitchParameter>]

Enable Boot Order Management. Also required for Connection boot enablement. If this is disabled, then PXE or FC BfS settings are disabled within the entire Server Profile.

Aliases

None

Required?

false

Position?

named

Default value

True

Accept pipeline input?

false

Accept wildcard characters?

false

-bootOrder [<Array>]

Boot Order settings to be managed. Must be an array with the following values:

? PXE

? HardDisk

? CD

? Floppy

? USB

Aliases

None

Required?

false

Position?

named

Default value

@(?CD?,?Floppy?,?USB?,?HardDisk?,?PXE?)

Accept pipeline input?

false

Accept wildcard characters?

false

-localstorage [<SwitchParameter>]

Enable local storage settings to be managed on the server. Will only enable embedded Smart Array controller management.

Aliases

None

Required?

false

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-Initialize [<SwitchParameter>]

Indicates whether the local storage controller should be reset to factory defaults before applying the local storage settings from the server profile.

************* *************

***WARNING*** Setting this will overwrite an existing logical disk if present, and without further warning. ***WARNING***

************* *************

Aliases

None

Required?

false

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-Bootable [<SwitchParameter>]

Indicates if the logical drive is bootable or not.

Aliases

None

Required?

false

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-RaidLevel [<String>]

RAID level of the logical drive. Local Smart Array controller must support the required RAID level with the appropriate amount of drives.

Allowed parameter values:

? None

? Raid0

? Raid1

Aliases

None

Required?

false

Position?

named

Default value

<none>

Accept pipeline input?

false

Accept wildcard characters?

false

-SANStorage <SwitchParameter>

Optional. Enable SAN Storage Management within the Server Profile.

Aliases

None

Required?

true

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-HostOStype <String>

Aliases [-OS]

Optional. Specify the Host OS type, which will set the Host OS value when HP OneView created the Host object on the Storage System. 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

None

Required?

true

Position?

named

Default value

<none>

Accept pipeline input?

false

Accept wildcard characters?

false

-StorageVolume <Object>

Optional. Array of Storage Volume resources to attach. Can be created by using the New-HPOVProfileAttachVolume cmdlet. This parameter does not accept a Storage Volume resource from the Get-HPOVStorageVolume cmdlet.

The format of the Storage Volume resource should be a PsCustomObject PowerShell resource with the following keys and values:

[PsCustomObject]@{

[System.Int]id - Valid Host LUN ID 0-254

[System.String]lunType - Auto or Manual

[System.String]volumeUri - URI to Storage Volume that has been created and not assigned to another

In a server profile, the Affinity control sets the remove-and-replace behavior for blade servers. If you apply a server profile to a blade server and the server is subsequently removed from the device bay, the Affinity setting controls whether the server
profile is reapplied when you insert a server blade into the empty bay. Server profiles for rack servers do not have affinity.

Accepted values are either 'DeviceBay' or 'DeviceBay+SH'. Default is 'DeviceBay'.

Aliases

None

Required?

false

Position?

named

Default value

DeviceBay

Accept pipeline input?

false

Accept wildcard characters?

false

-macAssignment [<String>]

Optional setting for MAC address assignment. May be Virtual or Physical.

Aliases

None

Required?

false

Position?

named

Default value

Virtual

Accept pipeline input?

false

Accept wildcard characters?

false

-wwnAssignment [<String>]

Optional setting for WWN assignment. May be Virtual or Physical.

Aliases

None

Required?

false

Position?

named

Default value

Virtual

Accept pipeline input?

false

Accept wildcard characters?

false

-snAssignment [<String>]

Optional setting for serial number and UUID assignment. May be Virtual or Physical.

Default: Virtual serial number and UUID assignment

Aliases

None

Required?

false

Position?

named

Default value

Virtual

Accept pipeline input?

false

Accept wildcard characters?

false

-Import <SwitchParameter>

Switch to import Server Profile JSON object or file.

Aliases

None

Required?

true

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-ProfileObj <Object>

Aliases [-location, -file]

Source Server Profile JSON object or file.

Aliases

None

Required?

true

Position?

named

Default value

<none>

Accept pipeline input?

true (ByValue)

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).

INPUTS

System.String

The full path to the Server Profile JSON export file.

System.Management.Automation.PSCustomObject

Server Profile resource object from Get-Content by reading from a JSON file.

OUTPUTS

System.Management.Automation.PSCustomObject

If successful returns a task resource which may be polled to follow the progress of the profile creation. Otherwise, a request validation error will be returned.

The server hardware resource where the new profile is to be applied. This is normally retrieved with a 'Get-HPOVServer' call, and the Server state property should be "NoProfileApplied". Can also be the Server Hardware name or URI. Default:
Unassigned

Aliases

None

Required?

false

Position?

named

Default value

unassigned

Accept pipeline input?

false

Accept wildcard characters?

false

-description [<String>]

Optional description for this server profile.

Aliases

None

Required?

false

Position?

named

Default value

<none>

Accept pipeline input?

false

Accept wildcard characters?

false

-connections [<Array>]

The network connections that are to be part of this new server profile. This an array of profile conneciton objects which may be created with 'New-HPOVProfileConnection'. Default: No connections

Aliases

None

Required?

false

Position?

named

Default value

@()

Accept pipeline input?

false

Accept wildcard characters?

false

-enclosureGroup [<Object>]

Alias [-eg] The Enclosure Group resource the Server Profile will be bound to. Only required when Server value is "Unassigned".

Aliases

None

Required?

false

Position?

named

Default value

<none>

Accept pipeline input?

false

Accept wildcard characters?

false

-serverHardwareType [<Object>]

Alias [-sht] The Server Hardware Type reource the Server Profile will be bound to. Only required when Server value is "Unassigned".

Aliases

None

Required?

false

Position?

named

Default value

<none>

Accept pipeline input?

false

Accept wildcard characters?

false

-firmware [<SwitchParameter>]

Boolean value to enable Firmware Management. Default: False

Aliases

None

Required?

false

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-baseline [<Object>]

Firmware baseline to assign. Can be either Baseline Name or URI.

Aliases

None

Required?

false

Position?

named

Default value

<none>

Accept pipeline input?

false

Accept wildcard characters?

false

-bios [<SwitchParameter>]

Boolean value to enable BIOS Settings Management. Default: False

Aliases

None

Required?

false

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-biosSettings [<Array>]

BIOS Settings that are to be managed. You can get the BIOS settings available from Get-HPOVServerHarwareType and the returned biosSettings property.

Aliases

None

Required?

false

Position?

named

Default value

@()

Accept pipeline input?

false

Accept wildcard characters?

false

-boot [<SwitchParameter>]

Boolean value to enable Boot Order Management. Also required for connection boot enablement. If this is disabled, then PXE or FC BfS settings are disabled within the entire Server Profile. Default: True

Aliases

None

Required?

false

Position?

named

Default value

True

Accept pipeline input?

false

Accept wildcard characters?

false

-bootOrder [<Array>]

Boot Order settings to be managed. Must be an array with the following values: PXE HardDisk CD Floppy USB

Aliases

None

Required?

false

Position?

named

Default value

@(?CD?,?Floppy?,?USB?,?HardDisk?,?PXE?)

Accept pipeline input?

false

Accept wildcard characters?

false

-localstorage [<SwitchParameter>]

Local storage settings to be configured on the server. *** REQUIRES APPLIANCE VERSION 1.05 or newer ***

Aliases

None

Required?

false

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-Initialize [<SwitchParameter>]

Indicates whether the local storage controller should be reset to factory defaults before applying the local storage settings from the server profile. *** REQUIRES APPLIANCE VERSION 1.05 or newer *** ***WARNING*** Setting this will overwrite an
existing logical disk if present, and without further warning. ***WARNING***

Aliases

None

Required?

false

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-Bootable [<SwitchParameter>]

Indicates if the logical drive is bootable or not. *** REQUIRES APPLIANCE VERSION 1.05 or newer ***

Aliases

None

Required?

false

Position?

named

Default value

False

Accept pipeline input?

false

Accept wildcard characters?

false

-RaidLevel [<String>]

RAID level of the logical drive. Local Smart Array controller must support the required RAID level with the appropriate amount of drives. *** REQUIRES APPLIANCE VERSION 1.05 or newer ***