wmi Win32_ComputerSystem reference for Network Programming in .NET with C# & Visual Basic .NET (VB.NET)

WMI class ' Win32_ComputerSystem ' reference for C# and VB.NET

MOF Reference

[Description("The Win32_ComputerSystem class represents a computer system operating in a Win32 environment."): ToSubClass, AMENDMENT, LOCALE(1033)]
class Win32_ComputerSystem : CIM_UnitaryComputerSystem
{
	[Description("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.\nValues: TRUE or FALSE. If TRUE, the automatic reset boot option is enabled."): ToSubClass] boolean AutomaticResetBootOption;
	[Description("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.\nValues: TRUE or FALSE. If TRUE, the automatic reset is enabled."): ToSubClass] boolean AutomaticResetCapability;
	[Description("The BootROMSupported property determines whether a boot ROM is supported.\nValues are TRUE or FALSE. If BootROMSupported equals TRUE, then a boot ROM is supported."): ToSubClass] boolean BootROMSupported;
	[Description("The BootupState property specifies how the system was started. Fail-safe boot (also called SafeBoot) bypasses the user's startup files. \nConstraints: Must have a value."): ToSubClass, Values{"Normal boot", "Fail-safe boot", "Fail-safe with network boot"}: ToSubClass] string BootupState;
	[Description("The CurrentTimeZone property  indicates the amount of time the unitary computer system is offset from Coordinated Universal Time."): ToSubClass] sint16 CurrentTimeZone;
	[Description("The Domain property indicates the name of the domain to which the computer belongs."): ToSubClass] string Domain;
	[Description("The InfraredSupported property determines whether an infrared (IR) port exists on the computer system.\nValues are TRUE or FALSE. If InfraredSupported equals TRUE, then an IR port exists."): ToSubClass] boolean InfraredSupported;
	[Description("The Manufacturer property indicates the name of the computer manufacturer.\nExample: Acme"): ToSubClass] string Manufacturer;
	[Description("The Model property indicates the product name of the computer given by the manufacturer."): ToSubClass] string Model;
	[Description("The NetworkServerModeEnabled property determines whether Network Server Mode is enabled.\nValues: TRUE or FALSE.  If TRUE, Network Server Mode is enabled."): ToSubClass] boolean NetworkServerModeEnabled;
	[Description("The OEMLogoBitmap array holds the data for a bitmap created by the OEM."): ToSubClass] uint8 OEMLogoBitmap[];
	[Description("The SupportContactDescription property is an array that indicates the support contact information for the Win32 computer system."): ToSubClass] string SupportContactDescription[];
	[Description("The SystemStartupDelay property indicates the time to delay before starting the operating system\n\nNote:  The SE_SYSTEM_ENVIRONMENT_NAME privilege is required on IA64bit machines. This privilege is not required for 32bit systems."): ToSubClass] uint16 SystemStartupDelay;
	[Description("The SystemStartupOptions property array indicates the options for starting up the computer system. Note that this property is not writable on IA64 bit machines. \nConstraints: Must have a value.\n\nNote:  The SE_SYSTEM_ENVIRONMENT_NAME privilege is required on IA64bit machines. This privilege is not required for other systems."): ToSubClass] string SystemStartupOptions[];
	[Description("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.)\n\nNote:  The SE_SYSTEM_ENVIRONMENT_NAME privilege is required on IA64bit machines. This privilege is not required for 32bit systems."): ToSubClass] uint8 SystemStartupSetting;
	[Description("The SystemType property indicates the type of system running on the Win32 computer.\nConstraints: Must have a value"): ToSubClass, Values{"X86-based PC", "MIPS-based PC", "Alpha-based PC", "Power PC", "SH-x PC", "StrongARM PC", "64-bit Intel PC", "64-bit Alpha PC", "Unknown", "X86-Nec98 PC"}: ToSubClass] string SystemType;
	[Description("The UserName property indicates the name of the currently-logged-on user.\nConstraints: Must have a value. \nExample: johnsmith"): ToSubClass] string UserName;
	[Description("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])."): ToSubClass, Values{"Standalone Workstation", "Member Workstation", "Standalone Server", "Member Server", "Backup Domain Controller", "Primary Domain Controller"}: ToSubClass] uint16 DomainRole;
	[Description("The WakeUpType property indicates the event that caused the system to power up."): ToSubClass, Values{"Reserved", "Other", "Unknown", "APM Timer", "Modem Ring", "LAN Remote", "Power Switch", "PCI PME#", "AC Power Restored"}: ToSubClass] uint16 WakeUpType;
	[Description("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."): ToSubClass] string OEMStringArray[];
	[Description("Boot Option on Limit. Identifies the system action to be taken when the Reset Limit is reached."): ToSubClass, Values{"Reserved", "Operating system", "System utilities", "Do not reboot"}: ToSubClass] uint16 BootOptionOnLimit;
	[Description("The BootOptionOnWatchDog Property indicates the type of re-boot action to be taken after the time on the watchdog timer has elapsed."): ToSubClass, Values{"Reserved", "Operating system", "System utilities", "Do not reboot"}: ToSubClass] uint16 BootOptionOnWatchDog;
	[Description("The ResetCount property indicates the number of automatic resets since the last intentional reset.  A value of -1 indicates that the count is unknown."): ToSubClass] sint16 ResetCount;
	[Description("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"): ToSubClass] sint16 ResetLimit;
	[Description("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"): ToSubClass] sint64 PauseAfterReset;
	[Description("The PowerOnPasswordStatus property identifies the system-wide hardware security settings for Power On Password Status."): ToSubClass, Values{"Disabled", "Enabled", "Not Implemented", "Unknown"}: ToSubClass] uint16 PowerOnPasswordStatus;
	[Description("The KeyboardPasswordStatus property identifies the system-wide hardware security settings for Keyboard Password Status."): ToSubClass, Values{"Disabled", "Enabled", "Not Implemented", "Unknown"}: ToSubClass] uint16 KeyboardPasswordStatus;
	[Description("The AdminPasswordStatus property identifies the system-wide hardware security settings for Administrator Password Status."): ToSubClass, Values{"Disabled", "Enabled", "Not Implemented", "Unknown"}: ToSubClass] uint16 AdminPasswordStatus;
	[Description("The FrontPanelResetStatus property identifies the hardware security settings for the reset button on the machine."): ToSubClass, Values{"Disabled", "Enabled", "Not Implemented", "Unknown"}: ToSubClass] uint16 FrontPanelResetStatus;
	[Description("The ChassisBootupState property indicates the enclosure's bootup state."): ToSubClass, Values{"Other", "Unknown", "Safe", "Warning", "Critical", "Non-recoverable"}: ToSubClass] uint16 ChassisBootupState;
	[Description("The PowerSupplyState identifies the state of the enclosure's power supply (or supplies) when last booted."): ToSubClass, Values{"Other", "Unknown", "Safe", "Warning", "Critical", "Non-recoverable"}: ToSubClass] uint16 PowerSupplyState;
	[Description("The ThermalState property identifies the enclosure's thermal state when last booted."): ToSubClass, Values{"Other", "Unknown", "Safe", "Warning", "Critical", "Non-recoverable"}: ToSubClass] uint16 ThermalState;
	[Description("The DaylightInEffect property specifies if the daylight savings is in effect. \nValues: 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."): ToSubClass] boolean DaylightInEffect;
	[Description("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"): ToSubClass] boolean EnableDaylightSavingsTime;
	[Description("The NumberOfProcessors property indicates the number of 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."): ToSubClass] uint32 NumberOfProcessors;
	[Description("The TotalPhysicalMemory property indicates the total size of physical memory.\nExample: 67108864"): ToSubClass] uint64 TotalPhysicalMemory;
	[Description("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."): ToSubClass] boolean PartOfDomain;
	[Description("The Workgroup property contains the name of the workgroup.  This value is only valid if the PartOfDomain property is FALSE."): ToSubClass] string Workgroup;
	[Description("Renaming a computer can be performed only by a member of the Administrators local group on the computer. You cannot call this Rename function remotely for domain computers. \nPassword and Username must use a high authentication level (i.e. no less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY) when they connect to winmgmt (i.e. in the call to obtain the IWbemServices interface) or SetProxyBlanket on their IWbemServices ptr. If they are local to winmgmt then this is not a concern because their authentication level is as good as RPC_C_AUTHN_LEVEL_PKT_PRIVACY as well as their client request never goes over the wire to get to the winmgmt. \nIf Password and Username are left null, the provider does not care. \nIf the provider determines that the authentication level is too low and a Password or Username has been specified then WBEM_E_ENCRYPTED_CONNECTION_REQUIRED will be returned. \nThe method can return the following values:  \n0 - Success. Reboot required. \nOther - For integer values other than those listed above, refer to Win32 error code documentation."): ToSubClass, Values{"Success", "Other"}: ToSubClass] uint32 Rename([In, Description("The Name parameter specifies the new name. The name cannot include control characters, leading or trailing spaces, or any of the following characters:  / \\ [ ] : | < > + = ; , ? "): ToSubClass] string Name, [In, Description("If the UserName parameter specifies an account name, the Password parameter must point to the password to use when connecting to the domain controller. Otherwise, this parameter must be NULL. \nPassword and Username must use a high authentication level (i.e. no less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY) when they connect to winmgmt (i.e. in the call to obtain the IWbemServices interface) or SetProxyBlanket on their IWbemServices ptr. If they are local to winmgmt then this is not a concern because their authentication level is as good as RPC_C_AUTHN_LEVEL_PKT_PRIVACY as well as their client request never goes over the wire to get to the winmgmt. \nIf Password and Username are left null, the provider does not care. \nIf the provider determines that the authentication level is too low and a Password or Username has been specified then WBEM_E_ENCRYPTED_CONNECTION_REQUIRED will be returned. \nThis parameter is only used for domain renames on Windows 2000 platforms and beyond. "): ToSubClass] string Password, [In, Description("The Username parameter is a pointer to a constant null-terminated character string that specifies the account name to use when connecting to the domain controller. The string must specify either a domain NetBIOS name and user account (for example, \"REDMOND\\user\") or the user principal name (UPN) of the user in the form of an Internet-style login name (for example, \"someone@microsoft.com\"). If this parameter is NULL, the caller's context is used. \nPassword and Username must use a high authentication level (i.e. no less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY) when they connect to winmgmt (i.e. in the call to obtain the IWbemServices interface) or SetProxyBlanket on their IWbemServices ptr. If they are local to winmgmt then this is not a concern because their authentication level is as good as RPC_C_AUTHN_LEVEL_PKT_PRIVACY as well as their client request never goes over the wire to get to the winmgmt. \nIf Password and Username are left null, the provider does not care. \nIf the provider determines that the authentication level is too low and a Password or Username has been specified then WBEM_E_ENCRYPTED_CONNECTION_REQUIRED will be returned. \nThis parameter is only used for domain renames on Windows 2000 platforms and beyond. "): ToSubClass] string UserName);
	[Description("The JoinDomainOrWorkgroup method joins computer systems to a domain or workgroup.  This method is only available on Windows 2000 platforms and beyond. The method can return the following values:\n0 - Success.\nOther - For integer values other than those listed above, refer to Win32 error code documentation.\nPassword and Username must use a high authentication level (i.e. no less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY) when they connect to winmgmt (i.e. in the call to obtain the IWbemServices interface) or SetProxyBlanket on their IWbemServices ptr. If they are local to winmgmt then this is not a concern because their authentication level is as good as RPC_C_AUTHN_LEVEL_PKT_PRIVACY as well as their client request never goes over the wire to get to the winmgmt. \nIf Password and Username are left null, the provider does not care. \nIf the provider determines that the authentication level is too low and a Password or Username has been specified then WBEM_E_ENCRYPTED_CONNECTION_REQUIRED will be returned. "): ToSubClass, Values{"Success", "Other"}: ToSubClass] uint32 JoinDomainOrWorkgroup([In, Description("The Name parameter specifies the domain or workgroup to join. This parameter cannot be NULL."): ToSubClass] string Name, [In, Description("If the UserName parameter specifies an account name, the Password parameter must point to the password to use when connecting to the domain controller. Otherwise, this parameter must be NULL. \nPassword and Username must use a high authentication level (i.e. no less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY) when they connect to winmgmt (i.e. in the call to obtain the IWbemServices interface) or SetProxyBlanket on their IWbemServices ptr. If they are local to winmgmt then this is not a concern because their authentication level is as good as RPC_C_AUTHN_LEVEL_PKT_PRIVACY as well as their client request never goes over the wire to get to the winmgmt. \nIf Password and Username are left null, the provider does not care. \nIf the provider determines that the authentication level is too low and a Password or Username has been specified then WBEM_E_ENCRYPTED_CONNECTION_REQUIRED will be returned. "): ToSubClass] string Password, [In, Description("The Username parameter is a pointer to a constant null-terminated character string that specifies the account name to use when connecting to the domain controller. The string must specify either a domain NetBIOS name and user account (for example, \"REDMOND\\user\") or the user principal name (UPN) of the user in the form of an Internet-style login name (for example, \"someone@microsoft.com\"). If this parameter is NULL, the caller's context is used. \nPassword and Username must use a high authentication level (i.e. no less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY) when they connect to winmgmt (i.e. in the call to obtain the IWbemServices interface) or SetProxyBlanket on their IWbemServices ptr. If they are local to winmgmt then this is not a concern because their authentication level is as good as RPC_C_AUTHN_LEVEL_PKT_PRIVACY as well as their client request never goes over the wire to get to the winmgmt. \nIf Password and Username are left null, the provider does not care. \nIf the provider determines that the authentication level is too low and a Password or Username has been specified then WBEM_E_ENCRYPTED_CONNECTION_REQUIRED will be returned. "): ToSubClass] string UserName, [In, Description("The AccountOU optionally specifies the pointer to a constant null-terminated character string that contains the RFC 1779 format name of the organizational unit (OU) for the computer account. If you specify this parameter, the string must contain a full path, for example, OU=testOU, DC=domain, DC=Domain,DC=com. Otherwise, this parameter must be NULL. "): ToSubClass] string AccountOU, [In, Description("The FJoinOptions parameter contains a set of bit flags defining the join options. This parameter can be one or more of the following values: \nJoin Domain -  Joins the computer to a domain. If this value is not specified, joins the computer to a workgroup. 0 bit - Join Domain - If not present, a workgroup is joined. \n1 bit - Acct Create - Creates the account on the domain. \n2 bit - Acct Delete - Delete the account when a domain is left. \n4 bit - Win9X Upgrade - The join operation is occurring as part of an upgrade of Windows 95/98 to Windows NT/Windows 2000.  \n5 bit - Domain Join If Joined - Allows a join to a new domain even if the computer is already joined to a domain. \n6 bit - Join Unsecure -  Performs an unsecured join.\n7 bit - Machine Password Passed - Indicates that the machine (not user) password is passed. This option is only valid for unsecure joins \n8 bit - Deferred SPN Set - Specifies that writing SPN and DnsHostName attributes on the computer object should be deferred until the rename that will follow the join. \n18 bit - Install Invocation - The APIs were invoked during install. \n\nThe method returns a 0 if no options are involved."): ToSubClass, BitValues{"Join Domain", "Acct Create", "Acct Delete", "Win9X Upgrade", "Domain Join If Joined", "Join Unsecure", "Machine Password Passed", "Deferred SPN Set", "Install Invocation"}: ToSubClass] uint32 FJoinOptions);
	[Description("The UnjoinDomainOrWorkgroup method un-joins or removes a computer system from a domain or workgroup.  This method is only available on Windows 2000 platforms and beyond. The method can return the following values:\n0 - Success.\nOther - For integer values other than those listed above, refer to Win32 error code documentation.\nPassword and Username must use a high authentication level (i.e. no less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY) when they connect to winmgmt (i.e. in the call to obtain the IWbemServices interface) or SetProxyBlanket on their IWbemServices ptr. If they are local to winmgmt then this is not a concern because their authentication level is as good as RPC_C_AUTHN_LEVEL_PKT_PRIVACY as well as their client request never goes over the wire to get to the winmgmt. \nIf Password and Username are left null, the provider does not care. \nIf the provider determines that the authentication level is too low and a Password or Username has been specified then WBEM_E_ENCRYPTED_CONNECTION_REQUIRED will be returned. "): ToSubClass, Values{"Success", "Other"}: ToSubClass] uint32 UnjoinDomainOrWorkgroup([In, Description("If the UserName parameter specifies an account name, the Password parameter must point to the password to use when connecting to the domain controller. Otherwise, this parameter must be NULL. \nPassword and Username must use a high authentication level (i.e. no less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY) when they connect to winmgmt (i.e. in the call to obtain the IWbemServices interface) or SetProxyBlanket on their IWbemServices ptr. If they are local to winmgmt then this is not a concern because their authentication level is as good as RPC_C_AUTHN_LEVEL_PKT_PRIVACY as well as their client request never goes over the wire to get to the winmgmt. \nIf Password and Username are left null, the provider does not care. \nIf the provider determines that the authentication level is too low and a Password or Username has been specified then WBEM_E_ENCRYPTED_CONNECTION_REQUIRED will be returned. "): ToSubClass] string Password, [In, Description("The Username parameter is a pointer to a constant null-terminated character string that specifies the account name to use when connecting to the domain controller. The string must specify either a domain NetBIOS name and user account (for example, \"REDMOND\\user\") or the user principal name (UPN) of the user in the form of an Internet-style login name (for example, \"someone@microsoft.com\"). If this parameter is NULL, the caller's context is used. Blank password is passed by using an empty string \nPassword and Username must use a high authentication level (i.e. no less than RPC_C_AUTHN_LEVEL_PKT_PRIVACY) when they connect to winmgmt (i.e. in the call to obtain the IWbemServices interface) or SetProxyBlanket on their IWbemServices ptr. If they are local to winmgmt then this is not a concern because their authentication level is as good as RPC_C_AUTHN_LEVEL_PKT_PRIVACY as well as their client request never goes over the wire to get to the winmgmt. \nIf Password and Username are left null, the provider does not care. \nIf the provider determines that the authentication level is too low and a Password or Username has been specified then WBEM_E_ENCRYPTED_CONNECTION_REQUIRED will be returned. "): ToSubClass] string UserName, [In, Description("The FUnjoinOptions parameter specifies the unjoin options. If this parameter is NETSETUP_ACCT_DELETE, the account is disabled when the unjoin occurs. Note that this option does not delete the account. Currently, there are no other unjoin options defined.  \n\n2 bit - Acct Delete - Delete the account when a domain is left. \nThe method returns a 0 if no options are involved."): ToSubClass, BitValues{"Acct Delete"}: ToSubClass] uint32 FUnjoinOptions);
};

Class properties:

Win32_ComputerSystem.AdminPasswordStatus
Win32_ComputerSystem.AutomaticResetBootOption
Win32_ComputerSystem.AutomaticResetCapability
Win32_ComputerSystem.BootOptionOnLimit
Win32_ComputerSystem.BootOptionOnWatchDog
Win32_ComputerSystem.BootROMSupported
Win32_ComputerSystem.BootupState
Win32_ComputerSystem.Caption
Win32_ComputerSystem.ChassisBootupState
Win32_ComputerSystem.CreationClassName
Win32_ComputerSystem.CurrentTimeZone
Win32_ComputerSystem.DaylightInEffect
Win32_ComputerSystem.Description
Win32_ComputerSystem.Domain
Win32_ComputerSystem.DomainRole
Win32_ComputerSystem.EnableDaylightSavingsTime
Win32_ComputerSystem.FrontPanelResetStatus
Win32_ComputerSystem.InfraredSupported
Win32_ComputerSystem.InitialLoadInfo
Win32_ComputerSystem.InstallDate
Win32_ComputerSystem.KeyboardPasswordStatus
Win32_ComputerSystem.LastLoadInfo
Win32_ComputerSystem.Manufacturer
Win32_ComputerSystem.Model
Win32_ComputerSystem.Name
Win32_ComputerSystem.NameFormat
Win32_ComputerSystem.NetworkServerModeEnabled
Win32_ComputerSystem.NumberOfProcessors
Win32_ComputerSystem.OEMLogoBitmap
Win32_ComputerSystem.OEMStringArray
Win32_ComputerSystem.PartOfDomain
Win32_ComputerSystem.PauseAfterReset
Win32_ComputerSystem.PowerManagementCapabilities
Win32_ComputerSystem.PowerManagementSupported
Win32_ComputerSystem.PowerOnPasswordStatus
Win32_ComputerSystem.PowerState
Win32_ComputerSystem.PowerSupplyState
Win32_ComputerSystem.PrimaryOwnerContact
Win32_ComputerSystem.PrimaryOwnerName
Win32_ComputerSystem.ResetCapability
Win32_ComputerSystem.ResetCount
Win32_ComputerSystem.ResetLimit
Win32_ComputerSystem.Roles
Win32_ComputerSystem.Status
Win32_ComputerSystem.SupportContactDescription
Win32_ComputerSystem.SystemStartupDelay
Win32_ComputerSystem.SystemStartupOptions
Win32_ComputerSystem.SystemStartupSetting
Win32_ComputerSystem.SystemType
Win32_ComputerSystem.ThermalState
Win32_ComputerSystem.TotalPhysicalMemory
Win32_ComputerSystem.UserName
Win32_ComputerSystem.WakeUpType
Win32_ComputerSystem.Workgroup

WMI is a huge subject, so therefore it is practically impossible to provide a comprehensive example program that covers anything. However, the book �Network programming in .NET� (Buy at Amazon UK) (Buy at Amazon US) covers a much wider scope of WMI, and explains how to leverage it to access the bounty of information held within this vast, yet simple object model.

Articles

Contact us

Please use FireFox to view this page

WMI class ' Win32_ComputerSystem ' reference for C# and VB.NET

MOF Reference

Class properties: