Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CIM_ComputerSystem class

A CIM_ComputerSystem class represents a special collection of CIM_ManagedSystemElement instances. This collection provides computer capabilities and serves as an aggregation point to associate one or more of the following elements: file system, operating system, processor and memory (volatile and non-volatile storage). This class is derived from CIM_System.

Important  The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

class CIM_ComputerSystem : CIM_System
{
  string   Caption;
  string   CreationClassName;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   NameFormat;
  string   PrimaryOwnerContact;
  string   PrimaryOwnerName;
  string   Roles[];
  string   Status;
};

Members

The CIM_ComputerSystem class has these types of members:

Properties

The CIM_ComputerSystem class has these properties.

Caption
Data type: string
Access type: Read-only

Short textual description of the object. This property is inherited from CIM_ManagedSystemElement.

CreationClassName
Data type: string
Access type: Read-only

Name of the class or subclass used in the creation of an instance. When used with other key properties of the class, this property allows all instances of the class and its subclasses to be uniquely identified. This property is inherited from CIM_System.

Description
Data type: string
Access type: Read-only

Textual description of the object. This property is inherited from CIM_ManagedSystemElement.

InstallDate
Data type: datetime
Access type: Read-only

Date and time when the object was installed. This property does not need a value to indicate that the object is installed. This property is inherited from CIM_ManagedSystemElement.

Name
Data type: string
Access type: Read-only

Label by which the object is known. When subclassed, this property can be overridden to be a key property. This property is inherited from CIM_ManagedSystemElement.

NameFormat
Data type: string
Access type: Read-only

The CIM_ComputerSystem object and its derivatives are top-level objects of CIM that provide the scope for numerous components and require unique CIM_System keys. A heuristic is defined to create the CIM_ComputerSystem name in an attempt to always generate the same system name, independent of discovery protocol. This prevents inventory and management problems where the same asset or entity is discovered multiple times, but cannot be resolved to a single object. This property identifies how the system name was generated by using the subclass heuristic. The heuristic is outlined in the CIM V2 Common Model specification and assumes that the documented rules are traversed to determine and assign a name. The NameFormat values list defines the precedence order for assigning the system name with several rules mapping to the same value. Note that the CIM_ComputerSystem name that is calculated using the heuristic is the system's key value. Other names can be assigned and used for the CIM_ComputerSystem that better suit the business, using aliases. This property is inherited from CIM_System.

Values include the following:

"IP"
"Dial"
"HID"
"NWA"
"HWA"
"X25"
"ISDN"
"IPX"
"DCC"
"ICD"
"E.164"
"SNA"
"OID/OSI"
"Other"
PrimaryOwnerContact
Data type: string
Access type: Read-only

Information about how to contact the primary system owner (for example, phone number, email address, and so on). This property is inherited from CIM_System.

PrimaryOwnerName
Data type: string
Access type: Read-only

Name of the primary system owner. This property is inherited from CIM_System.

Roles
Data type: string array
Access type: Read/write

Array (bag) of strings that specifies the roles that the system plays in the information technology environment. Subclasses of System may override this property to define explicit Roles values. Alternately, a working group can 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

String that indicates the current status of the object. Operational and non-operational status can be defined. Operational status can include "OK", "Degraded", and "Pred Fail". "Pred Fail" indicates that an element is functioning properly, but is predicting a failure (for example, a SMART-enabled hard disk drive).

Nonoperational status can include "Error", "Starting", "Stopping", and "Service". "Service" can apply during disk mirror-resilvering, reloading a user permissions list, or other administrative work. Not all such work is online, but the managed element is neither "OK" nor in one of the other states. This property is inherited from CIM_ManagedSystemElement.

Values include the following:

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

Remarks

The CIM_ComputerSystem class is derived from CIM_System.

WMI does not implement this class. For more information about classes derived from CIM_ComputerSystem, see Win32 Classes.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Namespace

\root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

 

 

Show:
© 2014 Microsoft