Skip to main content

Add-LXCARackItem

This cmdlet adds a managed device to a specific rack. The managed device can be a chassis, rack server, a scalable complex, or a filler. The rack location information is applied to the specified device.

Note
You cannot pipe objects to this cmdlet.

Syntax​

Add-LXCARackItem [-Connection LXCAConnection] 
                  -Chassis
                  -RackUuid String
                  -ItemUuid String
                  -ItemName String
                  -ItemLowestRackUnit Int
                 [CommonParameter]

Add-LXCARackItem [-Connection LXCAConnection] 
                  -ComplexSystem
                  -ComplexSystemId String
                  -RackUuid String
                  -ItemLowestRackUnit Int
                 [CommonParameter]

Add-LXCARackItem [-Connection LXCAConnection] 
                  -Server
                  -RackUuid String
                  -ItemUuid String
                  -ItemName String
                  -ItemLowestRackUnit Int
                 [CommonParameter]

Add-LXCARackItem [-Connection LXCAConnection] 
                  -Placeholder
                  -RackUuid String
                  -ItemName String
                  -ItemHeight String
                  -ItemLowestRackUnit Int
                 [CommonParameter]

Add-LXCARackItem [-Connection LXCAConnection] 
                  -PlaceholderType String
                  -RackUuid String
                  -ItemName String
                  -ItemLowestRackUnit Int
                 [CommonParameter]

Add-LXCARackItem [-Connection LXCAConnection] 
                  -Storage
                  -RackUuid String
                  -ItemUuid String
                  -ItemName String
                  -ItemLowestRackUnit Int
                 [CommonParameter]

Add-LXCARackItem [-Connection LXCAConnection] 
                  -Switch
                  -RackUuid String
                  -ItemUuid String
                  -ItemName 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.
–Chassis
If specified, this cmdlets adds a chassis to the rack.
–ComplexSystem
If specified, this cmdlets adds a scalable-complex device to the rack.
–ComplexSystemId String
Specifies the ID of a scalable complex system to be added to the rack.
–ItemLowestRackUnit Int
Specifies the lowest rack unit position of the managed device in the target rack.
–ItemHeight String
Specifies the height of the managed device in rack units.
–ItemName String
Specifies the name of the managed device. The name is displayed in the rack.
–ItemUuid String
Specifies the UUID of the managed device to be added to the rack.
Note
The –ItemUuid is not required for a placeholder.
–Placeholder
If specified, this cmdlets adds a generic placeholder to the rack.
–PlaceholderType PlaceholderType
If specified, this cmdlets adds a placeholder of specified type to the rack. This can be one of the following values.

  • 1U_Filler

  • 2U_Filler

  • 4U_Filler

  • 3U_PureStorage

  • IBM_Storwize_Control_Enclosure

  • IBM_Storwize_Expansion_Enclosure

  • Lenovo_RackSwitch

  • Juniper_RackSwitch

  • Lenovo_B300_FC_SAN_Switch

  • Lenovo_6505_FC_SAN_Switch

  • Lenovo_6510_FC_SAN_Switch

  • ThinkSystem_DB610S_32Gb_FC_SAN_Switch

  • ThinkSystem_DB620S_32Gb_FC_SAN_Switch

  • ThinkSystem_DB400D_32Gb_FC_SAN_Director

  • ThinkSystem_DB800D_32Gb_FC_SAN_Director

  • 2U_Lenovo_Storage_Controller_Enclosure

  • 2U_Lenovo_Storage_Expansion_Enclosure

  • 2U_NetApp_FAS_Disk_Shelf

  • 2U_NetApp_FAS_Controller

  • 3U_NetApp_FAS_Controller

  • 4U_NetApp_FAS_Disk_Shelf

  • 4U_NetApp_FAS_Controller

  • 6U_NetApp_FAS_Controller

  • 1U_EMC_VNX_Standbay_Power_Supply

  • 1U_EMC_VNX_Control_Station

  • 2U_EMC_VNX_Data_Mover_Enclosure

  • 2U_EMC_VNX_Disk_Array_Enclosure

  • 2U_EMC_VNX_Disk_Processor_Enclosure

  • 2U_EMC_VNX_Standby_Power_Supply

  • 2U_EMC_VNX_Storage_Processor_Enclosure

  • 3U_EMC_VNX_Disk_Array_Enclosure

  • 3U_EMC_VNX_Disk_Processor_Enclosure

  • 4U_EMC_VNX_Disk_Array_Enclosure

  • 4U_EMC_VNX_Storage_Processor_Enclosure

–RackUuid c
Specifies the UUID of target rack.
–Server
If specified, this cmdlets adds a rack server to the rack.
–Storage
If specified, this cmdlets adds a storage device to the rack.
–Switch
If specified, this cmdlets adds a top-of-rack switch to the rack.
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 does not return an object.

Examples​

  • The following example adds a System x server into the rack.

    $cred = Get-Credential
    Connect-LXCA -Host "192.0.2.0" -Credential $Cred –SkipCertificateCheck

    Add-LXCARackItem -RackUuid "EEEEEEEE-1111-2222-3333-FFFFFFFFFFFF" -Server -ItemLowestRackUnit 10`
                     -ItemUuid "BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB" 

    Disconnect-LXCA
  • The following example adds a generic placeholder into the rack.
    $cred = Get-Credential
    Connect-LXCA -Host "192.0.2.0" -Credential $Cred -SkipCertificateCheck

    Add-LXCARackItem -RackUuid "EEEEEEEE-1111-2222-3333-FFFFFFFFFFFF" -Placeholder -ItemName "Switch"`
                     -ItemLowestRackUnit 19 -ItemHeight 1

    Disconnect-LXCA
  • The following example adds a placeholder for a ThinkSystem DB800D 32Gb FC SAN Director to the rack.
    $cred = Get-Credential
    Connect-LXCA -Host "192.0.2.0" -Credential $Cred -SkipCertificateCheck

    Add-LXCARackItem -RackUuid "EEEEEEEE-1111-2222-3333-FFFFFFFFFFFF"
                     -PlaceholderType ThinkSystem_DB800D_32Gb_FC_SAN_Director -ItemName "DB800D SAN Director"`
                     -ItemLowestRackUnit 20

    Disconnect-LXCA