Home Reference WMI Reference root CIMV2 Win32_ComputerSystem
 

Win32_ComputerSystem

The Win32_ComputerSystem class represents a computer system operating in a Win32 environment.

Quick Start

Properties

Most WMI properties are read-only. You can only read values but not change them. Few properties are also writeable. You can assign new values to those properties.

Writeable properties are marked with this icon:   

AdminPasswordStatus

Data type UInt16

The AdminPasswordStatus property identifies the system-wide hardware security settings for Administrator Password Status.

  AutomaticManagedPagefile

Data type Boolean

The AutomaticManagedPagefile property determines whether the system managed pagefile is enabled. This capability is notAvailable on windows server 2003,XP and lower versions.

Values: $true or $false. If $true, the automatic managed pagefile is enabled.

  AutomaticResetBootOption

Data type Boolean

The AutomaticResetBootOption property determines whether the automatic reset boot option is enabled, i.e. whether the machine will try to reboot after a system failure.

Values: $true or $false. If $true, the automatic reset boot option is enabled.

AutomaticResetCapability

Data type Boolean

The AutomaticResetCapability property determines whether the auto reboot feature is available with this machine. This capability is available on Windows NT but not on Windows 95.

Values: $true or $false. If $true, the automatic reset is enabled.

BootOptionOnLimit

Data type UInt16

Boot Option on Limit. Identifies the system action to be taken when the Reset Limit is reached.

BootOptionOnWatchDog

Data type UInt16

The BootOptionOnWatchDog Property indicates the type of re-boot action to be taken after the time on the watchdog timer has elapsed.

BootROMSupported

Data type Boolean

The BootROMSupported property determines whether a boot ROM is supported.

Values are $true or $false. If BootROMSupported equals $true, then a boot ROM is supported.

BootupState

Data type String

The BootupState property specifies how the system was started. Fail-safe boot (also called SafeBoot) bypasses the user’s startup files.

Constraints: Must have a value.

Caption

Data type String

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

ChassisBootupState

Data type UInt16

The ChassisBootupState property indicates the enclosure’s bootup state.

$ChassisBootupState_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='Safe'
    4='Warning'
    5='Critical'
    6='Non-recoverable'
}

CreationClassName

Data type String

The CreationClassName property 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.

  CurrentTimeZone

Data type SInt16

The CurrentTimeZone property indicates the amount of time the unitary computer system is offset from Coordinated Universal Time.

DaylightInEffect

Data type Boolean

The DaylightInEffect property specifies if the daylight savings is in effect.

Values: $true or $false. If $true, daylight savings is presently being observed. In most cases this means that the current time is one hour earlier than the standard time.

Description

Data type String

The Description property provides a textual description of the object.

DNSHostName

Data type String

The DNSHostName property indicates the DNS host name of the local computer.

Domain

Data type String

The Domain property indicates the name of the domain to which the computer belongs.

DomainRole

Data type UInt16

The DomainRole property indicates the role this computer plays within its assigned domain-workgroup. The domain-workgroup is a collection of computers on the same network. For example, the DomainRole property may show this computer is a “Member Workstation” (value of [1]).

  EnableDaylightSavingsTime

Data type Boolean

The EnableDaylightSavingsTime property indicates whether Daylight Savings Time is recognized on this machine. $false – time does not move an hour ahead or behind in the year. NULL – the status of DST is unknown on this system

FrontPanelResetStatus

Data type UInt16

The FrontPanelResetStatus property identifies the hardware security settings for the reset button on the machine.

HypervisorPresent

Data type Boolean

The HypervisorPresent property determines whether the system is running under a hypervisor that follows the industry standard convention for reporting a hypervisor is present.

Values: $true or $false. If $true, a hypervisor is present.

InfraredSupported

Data type Boolean

The InfraredSupported property determines whether an infrared (IR) port exists on the computer system.

Values are $true or $false. If InfraredSupported equals $true, then an IR port exists.

InitialLoadInfo

Data type String

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

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.

KeyboardPasswordStatus

Data type UInt16

The KeyboardPasswordStatus property identifies the system-wide hardware security settings for Keyboard Password Status.

LastLoadInfo

Data type String

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.

Manufacturer

Data type String

The Manufacturer property indicates the name of the computer manufacturer.

Example: Acme

Model

Data type String

The Model property indicates the product name of the computer given by the manufacturer.

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.

NameFormat

Data type String

The CIM_ComputerSystem object and its derivatives are Top Level Objects of CIM. They provide the scope for numerous components. Having unique CIM_System keys is required. A heuristic is defined to create the CIM_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 computer system name is generated, using a heuristic. The heuristic is outlined, in detail, in the CIM V2 Common Model specification. 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 computer system name. Several rules do map to the same Value.

Note that the CIM_ComputerSystem Name 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.

'IP','Dial','HID','NWA','HWA','X25','ISDN','IPX','DCC','ICD','E.164','SNA','OID/OSI','Other'

NetworkServerModeEnabled

Data type Boolean

The NetworkServerModeEnabled property determines whether Network Server Mode is enabled.

Values: $true or $false. If $true, Network Server Mode is enabled.

NumberOfLogicalProcessors

Data type UInt32

The NumberOfLogicalProcessors property indicates the number of logical processors currently available on the system.

NumberOfProcessors

Data type UInt32

The NumberOfProcessors property indicates the number of physical processors currently available on the system. This is the number of processors whose status is “enabled” – versus simply the number of processors for the computer system. The former can be determined by enumerating the number of processor instances associated with the computer system object, using the Win32_ComputerSystemProcessor association.

OEMLogoBitmap

Data type UInt8

The OEMLogoBitmap array holds the data for a bitmap created by the OEM.

OEMStringArray

Data type String

This structure contains free form strings defined by the OEM. Examples of this are: Part Numbers for Reference Documents for the system, contact information for the manufacturer, etc.

PartOfDomain

Data type Boolean

The PartOfDomain property indicates whether the computer is part of a domain or workgroup. If $true, the computer is part of a domain. If $false, the computer is part of a workgroup. If NULL, the computer is not part of a network group, or is unknown.

PauseAfterReset

Data type SInt64

The PauseAfterReset property identifies the time delay before the reboot is initiated. It is used after a system power cycle, system reset (local or remote), and automatic system reset. A value of -1 indicates that the pause value is unknown

PCSystemType

Data type UInt16

The PCSystemType property indicates the nature of the PC a user is working with like Laptop, Desktop, Tablet-PC etc.

$PCSystemType_ReturnValue = 
@{
    0='Unspecified'
    1='Desktop'
    2='Mobile'
    3='Workstation'
    4='Enterprise Server'
    5='SOHO Server'
    6='Appliance PC'
    7='Performance Server'
    8='Maximum'
}

PCSystemTypeEx

Data type UInt16

$PCSystemTypeEx_ReturnValue = 
@{
    0='Unspecified'
    1='Desktop'
    2='Mobile'
    3='Workstation'
    4='Enterprise Server'
    5='SOHO Server'
    6='Appliance PC'
    7='Performance Server'
    8='Slate'
    9='Maximum'
}

PowerManagementCapabilities

Data type UInt16

Indicates the specific power-related capabilities of a computer system and its associated running operating system. 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 parameter set to 5 (“Power Cycle”). “Timed Power On Supported” (7) indicates that the SetPowerState method can be invoked with the PowerState parameter set to 5 (“Power Cycle”) and the Time parameter set to a specific date and time, or interval, for power-on.

PowerManagementSupported

Data type Boolean

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.

PowerOnPasswordStatus

Data type UInt16

The PowerOnPasswordStatus property identifies the system-wide hardware security settings for Power On Password Status.

PowerState

Data type UInt16

Indicates the current power state of the computer system and its associated operating system. Regarding the power saving states, these are defined as follows: Value 4 (Unknown) indicates that the system is known to be in a power save mode, but its exact status in this mode is unknown; 2 (Low Power Mode) indicates that the system is in a power save state but still functioning, and may exhibit degraded performance; 3 (Standby) describes that the system is not functioning but could be brought to full power ‘quickly’; and value 7 (Warning) indicates that the computerSystem is in a warning state, though also in a power save mode.

$PowerState_ReturnValue = 
@{
    1='Unknown'
    2='Full Power'
    3='Power Save - Low Power Mode'
    4='Power Save - Standby'
    5='Power Save - Unknown'
    6='Power Cycle'
}

PowerSupplyState

Data type UInt16

The PowerSupplyState identifies the state of the enclosure’s power supply (or supplies) when last booted.

$PowerSupplyState_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='Safe'
    4='Warning'
    5='Critical'
    6='Non-recoverable'
}

PrimaryOwnerContact

Data type String

A string that provides information on how the primary system owner can be reached (e.g. phone number, email address, …).

PrimaryOwnerName

Data type String

The name of the primary system owner.

ResetCapability

Data type UInt16

If enabled (value = 4), the unitary computer system 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).

$ResetCapability_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='Disabled'
    4='Enabled'
    5='Not Implemented'
}

ResetCount

Data type SInt16

The ResetCount property indicates the number of automatic resets since the last intentional reset. A value of -1 indicates that the count is unknown.

ResetLimit

Data type SInt16

The ResetLimit property indicates the number of consecutive time the system reset will be attempted. A value of -1 indicates that the limit is unknown

  Roles

Data type String

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’.

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'

SupportContactDescription

Data type String

The SupportContactDescription property is an array that indicates the support contact information for the Win32 computer system.

  SystemStartupDelay

Data type UInt16

The SystemStartupDelay property indicates the time to delay before starting the operating system

Note: The SE_SYSTEM_ENVIRONMENT privilege is required on IA64bit machines. This privilege is not required for 32bit systems.

  SystemStartupOptions

Data type String

The SystemStartupOptions property array indicates the options for starting up the computer system. Note that this property is not writable on IA64 bit machines.

Constraints: Must have a value.

Note: The SE_SYSTEM_ENVIRONMENT privilege is required on IA64bit machines. This privilege is not required for other systems.

  SystemStartupSetting

Data type UInt8

The SystemStartupSetting property indicates the index of the default start profile. This value is ‘calculated’ so that it usually returns zero (0) because at write-time, the profile string is physically moved to the top of the list. (This is how Windows NT determines which value is the default.)

Note: The SE_SYSTEM_ENVIRONMENT privilege is required on IA64bit machines. This privilege is not required for 32bit systems.

SystemType

Data type String

The SystemType property indicates the type of system running on the Win32 computer.

Constraints: Must have a value

'X86-based PC','MIPS-based PC','Alpha-based PC','Power PC','SH-x PC','StrongARM PC','64-bit Intel PC','x64-based PC','Unknown','X86-Nec98 PC'

ThermalState

Data type UInt16

The ThermalState property identifies the enclosure’s thermal state when last booted.

$ThermalState_ReturnValue = 
@{
    1='Other'
    2='Unknown'
    3='Safe'
    4='Warning'
    5='Critical'
    6='Non-recoverable'
}

Time

Data type DateTime

TotalPhysicalMemory

Data type UInt64

The TotalPhysicalMemory property indicates the total size of physical memory.

Example: 67108864

UserName

Data type String

The UserName property indicates the name of the currently-logged-on user.

Constraints: Must have a value.

Example: johnsmith

WakeUpType

Data type UInt16

The WakeUpType property indicates the event that caused the system to power up.

  Workgroup

Data type String

The Workgroup property contains the name of the workgroup. This value is only valid if the PartOfDomain property is $false.

Methods

Examples

See Also

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:09:07 (UTC).

Facebooktwittergoogle_pluspinterestlinkedinFacebooktwittergoogle_pluspinterestlinkedin