Skip to main content

Add-LXCACabinetItem

This cmdlet adds an item, such as a chassis, rack server, scalable complex system, or a placeholder, to a cabinet (rack) instance on the Lenovo XClarity Administrator server. The cabinet location information is applied to the item.

Note
You cannot pipe objects to this cmdlet.

Syntax​

Add-LXCACabinetItem [-Connection LXCAConnection] 
                     -CabinetUuid String 
                     -ItemUuid String
                     -ItemName String 
                     -ItemLowestRackUnit Int
                     -Chassis
                    [CommonParameter]

Add-LXCACabinetItem [-Connection LXCAConnection] 
                     -CabinetUuid String 
                     -ItemUuid String
                     -ItemName String 
                     -ItemLowestRackUnit Int
                     -RackServer
                    [CommonParameter]

Add-LXCACabinetItem [-Connection LXCAConnection] 
                     -CabinetUuid String 
                     -ItemName String
                     -ItemHeight Int 
                     -ItemLowestRackUnit Int
                     -Placeholder
                    [CommonParameter]

Add-LXCACabinetItem [-Connection LXCAConnection] 
                     -CabinetUuid String 
                     -ComplexId String
                     -ItemLowestRackUnit Int
                    [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.
-CabinetUuid String
Specifies the UUID of the cabinet.
-ItemUuid String
Specifies the UUID of the item, such as a rack server or a chassis.
ComplexId
Specifies the ID of a scalable complex system to be added to the cabinet.
-ItemName String
Specifies the name of the item, such as a rack server or a chassis.
-ItemHeight Int
Specifies the height of the item in rack units.
-ItemLowestRackUnit Int
Specifies the lowest rack unit position of the item in the cabinet on the XClarity Administrator server.
-Chassis
Specifies that the item to be added is a chassis.
-RackServer
Specifies that the item to be added is a rack server.
-Placeholder
Specifies that the item to be added is a placeholder
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​

The cmdlet adds the specified item to the specified cabinet on the XClarity Administrator server. No object is returned.

Examples​

The following example adds a rack server to a cabinet.

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

Add-LXCACabinetItem -CabinetUuid $rack -ItemUuid $node  -ItemName MyItem`
                    -ItemLowestRackUnit 10 -RackServer

Disconnect-LXCA