Skip to main content

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

Get-LXCAConfigProfile