New-OVServerProfileAssign

Syntax

New-OVServerProfileAssign
    [-ServerProfile] <Object>
    [-Server] <Object>
    [-Force]
    [-Async]
    [-ApplianceConnection] <Object>
    [<CommonParameters>]

New-OVServerProfileAssign
    [-ServerProfile] <Object>
    [-Unassigned]
    [-Force]
    [-Async]
    [-ApplianceConnection] <Object>
    [<CommonParameters>]

Description

This Cmdlet is used to unassign or reassign an existing HPE OneView Server Profile. The destination Server and its Server Hardware Type does not need to match the original Server Hardware Type defined in the Server Profile. The Server Profile will be updated accordingly.

Examples

Example 1

Get-OVServerProfile -Name "Profile 1" | New-OVServerProfileAssign -Server "Encl1, Bay 10" | Wait-OVTaskComplete

Get "Profile 1" Server Profile and assign it to "Encl1, Bay 10", then wait for the async task to complete.

Example 2

Get-OVServerProfile -Name "Profile 1" | New-OVServerProfileAssign -unassign | Wait-OVTaskComplete

Get "Profile 1" Server Profile and unassign it, then wait for the async task to complete.

Parameters

-ServerProfile <Object>

The name or object of the server profile resource to modify assignment.

Aliases	Profile
Required?	True
Position?	Named
Default value
Accept pipeline input?	true (ByValue)
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-OVServer" call, and the Server state property should be "NoProfileApplied". Can also be the Server Hardware [name.s]

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

-Unassigned <SwitchParameter>

Siwtch parameter to unassign a Server Profile.

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

-ApplianceConnection <Object>

Specify one [HPEOneView.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?	True
Position?	Named
Default value	(${Global:ConnectedSessions} | ? Default)
Accept pipeline input?	true (ByPropertyName)
Accept wildcard characters?	False

-Scope <HPEOneView.Appliance.ScopeCollection[]>

Provide an [HPEOneView.Appliance.ScopeCollection] resource object to initially associate with. Resource can also be added to scope using the Add-OVResourceToScope Cmdlet.

Aliases
Required?	False
Position?	Named
Default value	False
Accept pipeline input?
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

-Force <SwitchParameter>

Use to force add the Server Profile if there are any async task validation failures, like server hardware is in a Warning or Failed state, or SAN attach volume only have a single path configured.

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.Management.Automation.PSCustomObject

Server Profile resource object from Get-OVServerProfile

Return Values

HPEOneView.Appliance.TaskResource [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

Related Links