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.


Remove-LXCAConfigProfileFromSystem [-Connection LXCAConnection] 
                                    -Profile ConfigProfile

Remove-LXCAConfigProfileFromSystem [-Connection LXCAConnection] 
                                    -ProfileID String


-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.
Forces removal (deactivation) of the profile even if the target device is not reachable.
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.


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


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

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

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


Related links