Home Reference WMI Reference root CIMV2 Win32_SystemEnclosure
 

Win32_SystemEnclosure

The Win32_SystemEnclosure class represents the properties associated with a physical system enclosure.

Quick Start

Properties

In this WMI class, all WMI properties are read-only. You can only read values but not change them.

AudibleAlarm

Data type Boolean

Boolean indicating whether the frame is equipped with an audible alarm.

BreachDescription

Data type String

BreachDescription is a free-form string providing more information if the SecurityBreach property indicates that a breach or some other security-related event occurred.

CableManagementStrategy

Data type String

CableManagementStrategy is a free-form string that contains information on how the various cables are connected and bundled for the frame. With many networking, storage-related and power cables, cable management can be a complex and challenging endeavor. This string property contains information to aid in assembly and service of the frame.

Caption

Data type String

The Caption property is a short textual description (one-line string) of the object.

ChassisTypes

Data type UInt16

An enumerated, integer-valued array indicating the type of chassis.

$ChassisTypes_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='Desktop'
    4='Low Profile Desktop'
    5='Pizza Box'
    6='Mini Tower'
    7='Tower'
    8='Portable'
    9='Laptop'
   10='Notebook'
   11='Hand Held'
   12='Docking Station'
   13='All in One'
   14='Sub Notebook'
   15='Space-Saving'
   16='Lunch Box'
   17='Main System Chassis'
   18='Expansion Chassis'
   19='SubChassis'
   20='Bus Expansion Chassis'
   21='Peripheral Chassis'
   22='Storage Chassis'
   23='Rack Mount Chassis'
   24='Sealed-Case PC'
}

CreationClassName

Data type String

CreationClassName indicates the name of the class or the subclass used in the creation of an instance. When used with the other key properties of this class, this property allows all instances of this class and its subclasses to be uniquely identified.

CurrentRequiredOrProduced

Data type SInt16

Current required by the chassis at 120V. If power is provided by the chassis (as in the case of a UPS), this property may indicate the amperage produced, as a negative number.

Depth

Data type Real32

The depth of the physical package in inches.

Description

Data type String

The Description property provides a textual description of the object.

FileName

Data type String

HeatGeneration

Data type UInt16

Amount of heat generated by the chassis in BTU/hour.

Height

Data type Real32

The height of the physical package in inches.

HotSwappable

Data type Boolean

A physical package can be hot swapped if it is possible to replace the element with a physically different but equivalent one while the containing package has power applied to it (i.e., is ‘on’). For example, a disk drive package inserted using SCA connectors is removable and can be hot swapped. All packages that can be hot swapped are inherently removable and replaceable.

InstallDate

Data type DateTime

The InstallDate property is datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.

LockPresent

Data type Boolean

Boolean indicating whether the frame is protected with a lock.

Manufacturer

Data type String

The name of the organization responsible for producing the physical element. This may be the entity from whom the element is purchased, but this is not necessarily $true. The latter information is contained in the Vendor property of CIM_Product.

Model

Data type String

The name by which the physical element is generally known.

Name

Data type String

The Name property defines the label by which the object is known. When subclassed, the Name property can be overridden to be a Key property.

NumberOfPowerCords

Data type UInt16

Integer indicating the number of power cords which must be connected to the chassis, for all the components to operate.

OtherIdentifyingInfo

Data type String

OtherIdentifyingInfo captures additional data, beyond asset tag information, that could be used to identify a physical element. One example is bar code data associated with an element that also has an asset tag. Note that if only bar code data is available and is unique/able to be used as an element key, this property would be NULL and the bar code data used as the class key, in the tag property.

PartNumber

Data type String

The part number assigned by the organization responsible for producing or manufacturing the physical element.

PoweredOn

Data type Boolean

Boolean indicating that the physical element is powered on ($true), or is currently off ($false).

Recursive

Data type Boolean

Removable

Data type Boolean

A physical package is removable if it is designed to be taken in and out of the physical container in which it is normally found, without impairing the function of the overall packaging. A package can still be removable if power must be ‘off’ in order to perform the removal. If power can be ‘on’ and the package removed, then the element is removable and can be hot swapped. For example, an extra battery in a laptop is removable, as is a disk drive package inserted using SCA connectors. However, the latter can be hot swapped. A laptop’s display is not removable, nor is a non-redundant power supply. Removing these components would impact the function of the overall packaging or is impossible due to the tight integration of the package.

Replaceable

Data type Boolean

A physical package is replaceable if it is possible to replace (FRU or upgrade) the element with a physically different one. For example, some computer systems allow the main processor chip to be upgraded to one of a higher clock rating. In this case, the processor is said to be replaceable . Another example is a power supply package mounted on sliding rails. All removable packages are inherently replaceable .

SecurityBreach

Data type UInt16

SecurityBreach is an enumerated, integer-valued property indicating whether a physical breach of the frame was attempted but unsuccessful (value=4) or attempted and successful (5). Also, the values, “Unknown”, “Other” or “No Breach”, can be specified.

$SecurityBreach_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='No Breach'
    4='Breach Attempted'
    5='Breach Successful'
}

SecurityStatus

Data type UInt16

The SecurityStatus property indicates the security setting for external input (such as a keyboard) to this computer.

$SecurityStatus_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='None'
    4='External interface locked out'
    5='External interface enabled'
}

SerialNumber

Data type String

A manufacturer-allocated number used to identify the PhysicalElement.

ServiceDescriptions

Data type String

An array of free-form strings providing more detailed explanations for any of the entries in the ServicePhilosophy array. Note, each entry of this array is related to the entry in ServicePhilosophy that is located at the same index.

ServicePhilosophy

Data type UInt16

ServicePhilosophy is an enumerated, integer-valued array that indicates whether the frame is serviced from the top (value=2), front (3), back (4) or side (5), whether it has sliding trays (6) or removable sides (7), and/or whether the frame is moveable (8), for example, having rollers.

SKU

Data type String

The stock keeping unit number for this physical element.

SMBIOSAssetTag

Data type String

The SMBIOSAssetTag property indicates the asset tag number of the system enclosure.

StartFileName

Data type String

Status

Data type String

The Status property is a string indicating the current status of the object. Various operational and non-operational statuses can be defined. Operational statuses are “OK”, “Degraded” and “Pred Fail”. “Pred Fail” indicates that an element may be functioning properly but predicting a failure in the near future. An example is a SMART-enabled hard drive. Non-operational statuses can also be specified. These are “Error”, “Starting”, “Stopping” and “Service”. The latter, “Service”, could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative work. Not all such work is on-line, yet the managed element is neither “OK” nor in one of the other states.

'OK','Error','Degraded','Unknown','Pred Fail','Starting','Stopping','Service','Stressed','NonRecover','No Contact','Lost Comm'

Tag

Data type String

The Tag property is a string that uniquely identifies the system enclosure.

Example: System Enclosure 1

TypeDescriptions

Data type String

An array of free-form strings providing more information on the ChassisTypes array entries. Note, each entry of this array is related to the entry in ChassisTypes that is located at the same index.

Version

Data type String

A string indicating the version of the physical element.

VisibleAlarm

Data type Boolean

Boolean indicating that the equipment includes a visible alarm.

Weight

Data type Real32

The weight of the physical package in pounds.

Width

Data type Real32

The width of the physical package in inches.

Methods

Examples

Help and Questions

  Community Content

You are cordially invited to add knowledge to this page. If you have sample code or additional information related to this WMI class, please share it. Use the comment form to send your information. We will edit and incorparate it into the reference library. Thank you!

Please do not use the comment form to submit questions. If you have questions or need assistance, visit our free forum: Help me with WMI.

Content last updated: 2013-12-27 12:25:34 (UTC).

Facebooktwittergoogle_pluspinterestlinkedinFacebooktwittergoogle_pluspinterestlinkedin