Skip to main content

Remove-LXCAManagedDevice

This cmdlet removes one or more devices (including chassis, rack and tower servers, rack switches, and rack storage devices from management by the Lenovo XClarity Administrator server (unmanages the device).

Chassis components (CMMs, compute nodes, storage devices, and Flex switches) are unmanaged when you unmanage the chassis.

Note
You cannot pipe objects to this cmdlet.

Syntax​

Remove-LXCAManagedDevice [-Connection LXCAConnection] 
                         [-ChassisUuid String[]]
                         [-ServerUuid String[]]
                         [-ThinkServerUuid String[]]
                         [-RackSwitchUuid String[]]
                         [-StorageUuid String[]]
                         [-ForceUnmanage]
                         [-AsJob]
                         [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.
-ChassisUuid String[]
Specifies the UUIDs of one or more chassis to be unmanaged. The chassis must be managed by XClarity Administrator.
-ServerUuid String[]
Specifies the UUIDs of one or more Converged, NeXtScale, and System x servers to be unmanaged. The server must be managed by XClarity Administrator.
-ThinkServerUuid String[]
Specifies the UUIDs of one or more ThinkServer servers to be unmanaged. The server must be managed by XClarity Administrator.
-RackSwitchUuid String[]
Specifies the UUIDs of one or more RackSwitch switches to be unmanaged. The RackSwitch switch must be managed by XClarity Administrator.
-StorageUuid String[]
Specifies the UUIDs of one or more rack storage devices to be unmanaged. The storage device must be currently managed by XClarity Administrator.
-ForceUnmanage
If specified, the cmdlet unmanages the device even if the device is not reachable.
-Asjob
If specified, the cmdlet runs as a background job and returns a Job object immediately. Otherwise, the cmdlet runs in synchronous mode.
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 unmanages the specified devices. If the -Asjob parameter is specified, this cmdlet returns a Job object. If the --Asjob parameter is not specified, no object is returned.

Examples​

  • The following example unmanages all managed chassis.

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

    $managedchassis = Get-LXCAChassis
    $chassisUuids = @()
    Foreach($chassis in $managedchassis)
    {
       $chassisUuids += $chassis.Uuid
    }
    Remove-LXCAManagedDevice -ChassisUuid $chassisUuids

    Disconnect-LXCA

  • The following example unmanages a specific managed chassis as a job that runs in the background.

    Note
    You can view the status of the job as it is running.
    $cred = Get-Credential
    Connect-LXCA -Host192.0.2.0 -Port 8044 -Credential $cred

    $chassis = Get-LXCAChassis
    $job = Remove-LXCAManagedDevice -ChassisUuid $chassis[0].Uuid -AsJob
    while ($job.State -eq "Running")
    {
       Start-Sleep -Seconds 5
    }

    Disconnect-LXCA