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.

Win32_PhysicalMemoryArray class

The Win32_PhysicalMemoryArray WMI class represents details about the computer system physical memory. This includes the number of memory devices, memory capacity available, and memory type—for example, system or video memory.

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

Syntax

[Provider("CIMWin32")]class Win32_PhysicalMemoryArray : CIM_PhysicalPackage
{
  string   Caption;
  string   CreationClassName;
  real32   Depth;
  string   Description;
  real32   Height;
  boolean  HotSwappable;
  datetime InstallDate;
  uint16   Location;
  string   Manufacturer;
  uint32   MaxCapacity;
  uint16   MemoryDevices;
  uint16   MemoryErrorCorrection;
  string   Model;
  string   Name;
  string   OtherIdentifyingInfo;
  string   PartNumber;
  boolean  PoweredOn;
  boolean  Removable;
  boolean  Replaceable;
  string   SerialNumber;
  string   SKU;
  string   Status;
  string   Tag;
  uint16   Use;
  string   Version;
  real32   Weight;
  real32   Width;
};

Members

The Win32_PhysicalMemoryArray class has these types of members:

Methods

The Win32_PhysicalMemoryArray class has these methods.

MethodDescription
IsCompatible

Not implemented.

 

Properties

The Win32_PhysicalMemoryArray class has these properties.

Caption
Data type: string
Access type: Read-only

Short description of the object—a one-line string. This property is inherited from CIM_ManagedSystemElement.

CreationClassName
Data type: string
Access type: Read-only
Qualifiers: Key, MaxLen (256)

Name of the first concrete class that appears in the inheritance chain used in the creation of an instance. When used with the other key properties of the class, the property allows all instances of this class and its subclasses to be identified uniquely. This property is inherited from CIM_PhysicalElement.

Depth
Data type: real32
Access type: Read-only

Depth of the physical package—in inches. This property is inherited from CIM_PhysicalPackage.

Description
Data type: string
Access type: Read-only

Description of the object. This property is inherited from CIM_ManagedSystemElement.

Height
Data type: real32
Access type: Read-only

Height of the physical package—in inches. This property is inherited from CIM_PhysicalPackage.

HotSwappable
Data type: boolean
Access type: Read-only

If TRUE, 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, 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. This property is inherited from CIM_PhysicalPackage.

InstallDate
Data type: datetime
Access type: Read-only

Date and time 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.

Location
Data type: uint16
Access type: Read-only

Physical location of the memory array.

ValueMeaning
0 (0x0)

Reserved

1 (0x1)

Other

2 (0x2)

Unknown

3 (0x3)

System board or motherboard

4 (0x4)

ISA add-on card

5 (0x5)

EISA add-on card

6 (0x6)

PCI add-on card

7 (0x7)

MCA add-on card

8 (0x8)

PCMCIA add-on card

9 (0x9)

Proprietary add-on card

10 (0xA)

NuBus

11 (0xB)

PC-98/C20 add-on card

12 (0xC)

PC-98/C24 add-on card

13 (0xD)

PC-98/E add-on card

14 (0xE)

PC-98/Local bus add-on card

 

Manufacturer
Data type: string
Access type: Read-only

Name of the organization responsible for producing the physical element. This property is inherited from CIM_PhysicalElement.

MaxCapacity
Data type: uint32
Access type: Read-only
Qualifiers: Units (Kilobytes)

Maximum memory size (in bytes) installable for this particular memory array. If the size is unknown, the property is given a value of 0 (zero).

MemoryDevices
Data type: uint16
Access type: Read-only

Number of physical slots or sockets available in this memory array.

MemoryErrorCorrection
Data type: uint16
Access type: Read-only

Type of error correction used by the memory array.

ValueMeaning
0 (0x0)

Reserved

1 (0x1)

Other

2 (0x2)

Unknown

3 (0x3)

None

4 (0x4)

Parity

5 (0x5)

Single-bit ECC

6 (0x6)

Multi-bit ECC

7 (0x7)

CRC

 

Model
Data type: string
Access type: Read-only

Name by which the physical element is generally known. This property is inherited from CIM_PhysicalElement.

Name
Data type: string
Access type: Read-only

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

OtherIdentifyingInfo
Data type: string
Access type: Read-only

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 or 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. This property is inherited from CIM_PhysicalElement.

PartNumber
Data type: string
Access type: Read-only

Part number assigned by the organization responsible for producing or manufacturing the physical element. This property is inherited from CIM_PhysicalElement.

PoweredOn
Data type: boolean
Access type: Read-only

If TRUE, the physical element is powered on. This property is inherited from CIM_PhysicalElement.

Removable
Data type: boolean
Access type: Read-only

If TRUE, 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" 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 nonredundant power supply. Removing these components would affect the function of the overall packaging or is impossible due to the tight integration of the package. This property is inherited from CIM_PhysicalPackage.

Replaceable
Data type: boolean
Access type: Read-only

If TRUE, this physical media component can be replaced 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. This property is inherited from CIM_PhysicalPackage.

SerialNumber
Data type: string
Access type: Read-only

Manufacturer-allocated number used to identify the physical element. This property is inherited from CIM_PhysicalElement.

SKU
Data type: string
Access type: Read-only

Stockkeeping unit number for the physical element. This property is inherited from CIM_PhysicalElement.

Status
Data type: string
Access type: Read-only

Current status of the object. Various operational and nonoperational statuses can be defined. Operational statuses include: "OK", "Degraded", and "Pred Fail" (an element, such as a SMART-enabled hard disk drive, may be functioning properly but predicting a failure in the near future). Nonoperational statuses include: "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 online, yet the managed element is neither "OK" nor in one of the other states. This property is inherited from CIM_ManagedSystemElement.

The values are:

"OK"
"Error"
"Degraded"
"Unknown"
"Pred Fail"
"Starting"
"Stopping"
"Service"
"Stressed"
"NonRecover"
"No Contact"
"Lost Comm"
Tag
Data type: string
Access type: Read-only
Qualifiers: Key, MaxLen (256)

Unique identifier of the physical memory array. This property is inherited from CIM_PhysicalElement.

Example: "Physical Memory Array 1"

Use
Data type: uint16
Access type: Read-only

How memory is used in the computer system.

ValueMeaning
0 (0x0)

Reserved

1 (0x1)

Other

2 (0x2)

Unknown

3 (0x3)

System memory

4 (0x4)

Video memory

5 (0x5)

Flash memory

6 (0x6)

Nonvolatile RAM

7 (0x7)

Cache memory

 

Version
Data type: string
Access type: Read-only

Version of the physical element. This property is inherited from CIM_PhysicalElement.

Weight
Data type: real32
Access type: Read-only

Weight of the physical package in pounds. This property is inherited from CIM_PhysicalPackage.

Width
Data type: real32
Access type: Read-only

Width of the physical package in inches. This property is inherited from CIM_PhysicalPackage.

Remarks

The Win32_PhysicalMemoryArray class is derived from CIM_PhysicalPackage.

Examples

The following PowerShell sample retrieves the number of memory slots and the amount of memory installed on a target computer.


$strComputer = Read-Host "Enter Computer Name"
 $colSlots = Get-WmiObject -Class "win32_PhysicalMemoryArray" -namespace "root\CIMV2" `
 -computerName $strComputer
 $colRAM = Get-WmiObject -Class "win32_PhysicalMemory" -namespace "root\CIMV2" `
 -computerName $strComputer

Foreach ($objSlot In $colSlots){
      "Total Number of DIMM Slots: " + $objSlot.MemoryDevices
 }
 Foreach ($objRAM In $colRAM) {
      "Memory Installed: " + $objRAM.DeviceLocator
      "Memory Size: " + ($objRAM.Capacity / 1GB) + " GB"
 }


The following VBScript code sample returns information about the physical memory installed on a computer.


On Error Resume Next 
 
strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
 
Set colItems = objWMIService.ExecQuery _ 
    ("Select * from Win32_PhysicalMemoryArray") 
 
For Each objItem in colItems 
    Wscript.Echo "Description: " & objItem.Description 
    Wscript.Echo "Maximum Capacity: " & objItem.MaxCapacity 
    Wscript.Echo "Memory Devices: " & objItem.MemoryDevices 
    Wscript.Echo "Memory Error Correction: " & objItem.MemoryErrorCorrection 
Next 

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Namespace

\root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

See also

Computer System Hardware Classes
Win32_MemoryArrayLocation

 

 

Show:
© 2014 Microsoft