CIM_UnitaryComputerSystem class
A class derived from ComputerSystem that represents a Desktop, Mobile, NetPC, Server or other type of a single node Computer System.
The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.
Syntax
[Abstract, UUID("{903487A9-1E55-4489-9389-4CEE0AE6B236}"), AMENDMENT]
class CIM_UnitaryComputerSystem : CIM_ComputerSystem
{
string Caption;
string Description;
datetime InstallDate;
string Status;
string CreationClassName;
string Name;
string PrimaryOwnerContact;
string PrimaryOwnerName;
string Roles[];
string NameFormat;
string OtherIdentifyingInfo[];
string IdentifyingDescriptions[];
uint16 Dedicated[];
string InitialLoadInfo[];
string LastLoadInfo;
uint16 ResetCapability;
boolean PowerManagementSupported;
uint16 PowerManagementCapabilities[];
uint16 PowerState;
};
Members
The CIM_UnitaryComputerSystem class has these types of members:
Methods
The CIM_UnitaryComputerSystem class has these methods.
| Method | Description |
|---|---|
| SetPowerState | SetPowerState defines the desired power state of a ComputerSystem and its running OperatingSystem, and when the system should be put into that state. The PowerState parameter is specified as one of the valid integer values defined for the property, PowerState. The Time parameter (for all state changes but 5, "Power Cycle") indicates when the power state should be set, either as a regular date-time value or as an interval value (where the interval begins when the method invocation is received). When the PowerState parameter is equal to 5, "Power Cycle", the Time parameter indicates when the system should power on again. Power off is immediate. SetPowerState should return 0 if successful, 1 if the specified State and Time request is not supported, and some other value if any other error occurred. |
Properties
The CIM_UnitaryComputerSystem class has these properties.
-
Caption
-
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64)
The Caption property is a short textual description (one-line string) of the object.
This property is inherited from CIM_ManagedSystemElement.
-
-
CreationClassName
-
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.
This property is inherited from CIM_System.
-
Dedicated
-
-
Data type: uint16 array
-
Access type: Read-only
Enumeration indicating whether the ComputerSystem is a special-purpose System (ie, dedicated to a particular use), versus being 'general purpose'. For example, one could specify that the System is dedicated to "Print" (value=11) or acts as a "Hub" (value=8).
This property is inherited from CIM_ComputerSystem.
-
-
Not Dedicated (0)
-
Unknown (1)
-
Other (2)
-
Storage (3)
-
Router (4)
-
Switch (5)
-
Layer 3 Switch (6)
-
Central Office Switch (7)
-
Hub (8)
-
Access Server (9)
-
Firewall (10)
-
Print (11)
-
I/O (12)
-
Web Caching (13)
Description
-
Data type: string
-
Access type: Read-only
The Description property provides a textual description of the object.
This property is inherited from CIM_ManagedSystemElement.
IdentifyingDescriptions
-
Data type: string array
-
Access type: Read-only
-
Qualifiers: ArrayType ("Indexed"), ModelCorrespondence ("CIM_ComputerSystem.OtherIdentifyingInfo")
An array of free-form strings providing explanations and details behind the entries in the OtherIdentifyingInfo array. Note, each entry of this array is related to the entry in OtherIdentifyingInfo that is located at the same index.
This property is inherited from CIM_ComputerSystem.
InitialLoadInfo
-
Data type: string array
-
Access type: Read-only
This object contains the data needed to find either the initial load device (its key) or the boot service to request the operating system to start up. In addition, the load parameters (ie, a pathname and parameters) may also be specified.
InstallDate
-
Data type: datetime
-
Access type: Read-only
-
Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5")
A datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.
This property is inherited from CIM_ManagedSystemElement.
LastLoadInfo
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MappingStrings ("MIB.IETF|HOST-RESOURCES-MIB.hrSystemInitialLoadDevice", "MIB.IETF|HOST-RESOURCES-MIB.hrSystemInitialLoadParameters")
This object contains the data identifying either the initial load device (its key) or the boot service that requested the last operating system load. In addition, the load parameters (ie, a pathname and parameters) may also be specified.
Name
The inherited Name serves as key of a System instance in an enterprise environment.
This property is inherited from CIM_System.
NameFormat
-
Data type: string
-
Access type: Read-only
The ComputerSystem object and its derivatives are Top Level Objects of CIM. They provide the scope for numerous components. Having unique System keys is required. A heuristic is defined to create the ComputerSystem Name to attempt to always generate the same Name, independent of discovery protocol. This prevents inventory and management problems where the same asset or entity is discovered multiple times, but can not be resolved to a single object. Use of the heuristic is optional, but recommended.
The NameFormat property identifies how the ComputerSystem Name is generated, using a heuristic. The heuristic is outlined, in detail, in the CIM V2 System Model spec. It assumes that the documented rules are traversed in order, to determine and assign a Name. The NameFormat Values list defines the precedence order for assigning the ComputerSystem Name. Several rules do map to the same Value.
Note that the ComputerSystem Name calculated using the heuristic is the System's key value. Other names can be assigned and used for the ComputerSystem, that better suit a business, using Aliases.
This property is inherited from CIM_ComputerSystem.
("Other")
("IP")
("Dial")
("HID")
("NWA")
("HWA")
("X25")
("ISDN")
("IPX")
("DCC")
("ICD")
("E.164")
("SNA")
("OID/OSI")
OtherIdentifyingInfo
-
Data type: string array
-
Access type: Read-only
-
Qualifiers: MaxLen (256), ArrayType ("Indexed"), ModelCorrespondence ("CIM_ComputerSystem.IdentifyingDescriptions")
OtherIdentifyingInfo captures additional data, beyond System Name information, that could be used to identify a ComputerSystem. One example would be to hold the Fibre Channel World-Wide Name (WWN) of a node. Note that if only the Fibre Channel name is available and is unique (able to be used as the System key), then this property would be NULL and the WWN would become the System key, its data placed in the Name property.
This property is inherited from CIM_ComputerSystem.
PowerManagementCapabilities
-
Data type: uint16 array
-
Access type: Read-only
-
Qualifiers: MappingStrings ("MIF.DMTF|System Power Controls|001.2")
Indicates the specific power-related capabilities of a ComputerSystem and its associated running OperatingSystem. The values, 0="Unknown", 1="Not Supported", and 2="Disabled" are self-explanatory. The value, 3="Enabled" indicates that the power management features are currently enabled but the exact feature set is unknown or the information is unavailable. "Power Saving Modes Entered Automatically" (4) describes that a system can change its power state based on usage or other criteria. "Power State Settable" (5) indicates that the SetPowerState method is supported. "Power Cycling Supported" (6) indicates that the SetPowerState method can be invoked with the PowerState input variable set to 5 ("Power Cycle"). "Timed Power On Supported" (7) indicates that the SetPowerState method can be invoked with the PowerState input variable set to 5 ("Power Cycle") and the Time parameter set to a specific date and time, or interval, for power-on.
Unknown (0)
Not Supported (1)
Disabled (2)
Enabled (3)
Power Saving Modes Entered Automatically (4)
Power State Settable (5)
Power Cycling Supported (6)
Timed Power On Supported (7)
PowerManagementSupported
-
Data type: boolean
-
Access type: Read-only
Boolean indicating that the ComputerSystem, with its running OperatingSystem, supports power management. This boolean does not indicate that power management features are currently enabled, or if enabled, what features are supported. Refer to the PowerManagementCapabilities array for this information. If this boolean is false, the integer value 1 for the string, "Not Supported", should be the only entry in the PowerManagementCapabilities array.
PowerState
-
Data type: uint16
-
Access type: Read-only
Indicates the current power state of the ComputerSystem and its associated OperatingSystem. Regarding the Power Save states, these are defined as follows: Value 4 ("Power Save - Unknown") indicates that the System is known to be in a power save mode, but its exact status in this mode is unknown; 2 ("Power Save - Low Power Mode") indicates that the System is in a power save state but still functioning, and may exhibit degraded performance; 3 ("Power Save - Standby") describes that the System is not functioning but could be brought to full power 'quickly'; and value 7 ("Power Save - Warning") indicates that the ComputerSystem is in a warning state, though also in a power save mode.
Unknown (0)
Full Power (1)
Power Save - Low Power Mode (2)
Power Save - Standby (3)
Power Save - Unknown (4)
Power Cycle (5)
Power Off (6)
Power Save - Warning (7)
PrimaryOwnerContact
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (256), MappingStrings ("MIF.DMTF|General Information|001.3")
A string that provides information on how the primary system owner can be reached (e.g. phone number, email address, ...).
This property is inherited from CIM_System.
PrimaryOwnerName
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64), MappingStrings ("MIF.DMTF|General Information|001.4")
The name of the primary system owner.
This property is inherited from CIM_System.
ResetCapability
-
Data type: uint16
-
Access type: Read-only
-
Qualifiers: MappingStrings ("MIF.DMTF|System Hardware Security|001.4")
If enabled (value = 4), the UnitaryComputerSystem can be reset via hardware (e.g. the power and reset buttons). If disabled (value = 3), hardware reset is not allowed. In addition to Enabled and Disabled, other Values for the property are also defined - "Not Implemented" (5), "Other" (1) and "Unknown" (2).
Other (1)
Unknown (2)
Disabled (3)
Enabled (4)
Not Implemented (5)
Roles
-
Data type: string array
-
Access type: Read-only
An array (bag) of strings that specify the roles this System plays in the IT-environment. Subclasses of System may override this property to define explicit Roles values. Alternately, a Working Group may describe the heuristics, conventions and guidelines for specifying Roles. For example, for an instance of a networking system, the Roles property might contain the string, 'Switch' or 'Bridge'.
This property is inherited from CIM_System.
Status
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (10)
A string indicating the current status of the object. Various operational and non-operational statuses are defined. Operational statuses are "OK", "Degraded", "Stressed" and "Pred Fail". "Stressed" indicates that the Element is functioning, but needs attention. Examples of "Stressed" states are overload, overheated, etc. The condition "Pred Fail" (failure predicted) indicates that an Element is 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", "NonRecover", "Starting", "Stopping" and "Service". "NonRecover" indicates that a non-recoverable error has occurred. "Service" describes an Element being configured, maintained or cleaned, or otherwise administered. This status could apply during mirror-resilvering of a disk, reload of a user permissions list, or other administrative task. Not all such work is on-line, yet the Element is neither "OK" nor in one of the other states.
This property is inherited from CIM_ManagedSystemElement.
("OK")
("Error")
("Degraded")
("Unknown")
("Pred Fail")
("Starting")
("Stopping")
("Service")
("Stressed")
("NonRecover")
Requirements
| Minimum supported client |
None supported |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\MSCluster |
| MOF |
|
| DLL |
|