Remove-LXCAConfigProfileFromSystem

This cmdlet removes (deactivates) assignment of a server profile from the associated server. The server profile is still available on the Lenovo XClarity Administrator server.

Note: You can pipe a ConfigProfile object to this cmdlet.

Syntax

Remove-LXCAConfigProfileFromSystem [-Connection LXCAConnection] 
                                    -Profile ConfigProfile
                                   [-Force]
                                   [CommonParameter]

Remove-LXCAConfigProfileFromSystem [-Connection LXCAConnection] 
                                    -ProfileID String
                                   [-Force]
                                   [CommonParameter]

Parameters

-Connection LXCAConnection
Specifies the connection to the Lenovo XClarity Administrator server. If no connection is specified, the result from the last Connect-LXCA cmdlet is used.
-Profile ConfigProfile
The server profile object. You can obtain a server profile object using the Get-LXCAConfigProfile cmdlet.
-ProfileID String
The server profile ID. You can obtain a list of all server profile IDs using the Get-LXCAConfigProfile cmdlet.
-Force
Forces removal (deactivation) of the profile even if the target device is not reachable.
CommonParameters
This cmdlet supports the following common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -WarningAction, -WarningVariable, -OutBuffer, -PipelineVariable, -OutVariable. For detailed information about each common parameter, see the Microsoft PowerShell Common Parameters webpage.

Results

This cmdlet removes the server profile from assignment. No objects are returned.

Examples

The following example deactivates the server profile from a specified server.

$cred = Get-Credential
Connect-LXCA -Host 192.0.2.0 -Credential $cred

$profiles = Get-LXCAConfigProfile | where{$_.status -eq "ASSIGNED"}
Remove-LXCAConfigProfileFromSystem -ProfileId $profiles[0].Id

Disconnect-LXCA

Related links

Get-LXCAConfigProfile