New HPOVServerProfileAssign - HewlettPackard/POSH-HPEOneView GitHub Wiki

HPE OneView 4.10 Library

New-HPOVServerProfileAssign

Unassign or Reassign an existing Server Profile.

SYNTAX

New-HPOVServerProfileAssign [-ServerProfile] <Object> [-Server] <Object>[ [-Force] <SwitchParameter>][ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object> [-WhatIf] <> [-Confirm] <> [<CommonParameters>]
New-HPOVServerProfileAssign [-ServerProfile] <Object>[ [-Unassigned] <SwitchParameter>][ [-Force] <SwitchParameter>][ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object> [-WhatIf] <> [-Confirm] <> [<CommonParameters>]

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

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

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

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

Aliases cf
Required?
Position? named
Default value
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

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

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

-ServerProfile <Object>

Aliases [-Profile]

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

-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

-WhatIf <>

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

Return Values

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

Examples

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

Get-HPOVServerProfile "Profile 1" | New-HPOVServerProfileAssign -Server "Encl1, Bay 10" | Wait-HPOVTaskComplete

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

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

Get-HPOVServerProfile "Profile 1" | New-HPOVServerProfileAssign -unassign | Wait-HPOVTaskComplete

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

Related Links


Top

HPE OneView 4.00 Library

New-HPOVServerProfileAssign

Unassign or Reassign an existing Server Profile.

SYNTAX

New-HPOVServerProfileAssign [-ServerProfile] <Object> [-Server] <Object>[ [-Force] <SwitchParameter>][ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object> [-WhatIf] <> [-Confirm] <> [<CommonParameters>]
New-HPOVServerProfileAssign [-ServerProfile] <Object>[ [-Unassigned] <SwitchParameter>][ [-Force] <SwitchParameter>][ [-Async] <SwitchParameter>] [-ApplianceConnection] <Object> [-WhatIf] <> [-Confirm] <> [<CommonParameters>]

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

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

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

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

Aliases cf
Required?
Position? named
Default value
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

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

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

-ServerProfile <Object>

Aliases [-Profile]

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

-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

-WhatIf <>

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

Return Values

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

Examples

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

Get-HPOVServerProfile 'Profile 1' | New-HPOVServerProfileAssign -Server 'Encl1, Bay 10' | Wait-HPOVTaskComplete

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

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

Get-HPOVServerProfile 'Profile 1' | New-HPOVServerProfileAssign -unassign | Wait-HPOVTaskComplete

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

Related Links


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