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
[Dynamic, Provider("CIMWin32"), UUID("{FAF76B99-798C-11D2-AAD1-006008C78BC7}"), AMENDMENT]
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;
uint64 MaxCapacityEx;
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.
| Method | Description |
|---|---|
| IsCompatible | Not implemented. |
Properties
The Win32_PhysicalMemoryArray class has these properties.
-
Caption
-
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64), DisplayName ("Caption")
Short description of the object—a one-line string.
This property is inherited from CIM_ManagedSystemElement.
-
-
CreationClassName
-
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
-
Qualifiers: Units ("inches")
Depth of the physical package—in inches.
This property is inherited from CIM_PhysicalPackage.
-
-
Description
-
-
Data type: string
-
Access type: Read-only
-
Qualifiers: DisplayName ("Description")
Description of the object.
This property is inherited from CIM_ManagedSystemElement.
-
-
Height
-
-
Data type: real32
-
Access type: Read-only
-
Qualifiers: Units ("inches")
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
-
Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Install Date")
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
-
Qualifiers: MappingStrings ("SMBIOS|Type 16|Location")
Physical location of the memory array.
This value comes from the Location member of the Physical Memory Array structure in the SMBIOS information.
-
-
Reserved (0)
-
Other (1)
-
Unknown (2)
-
System board or motherboard (3)
-
ISA add-on card (4)
-
EISA add-on card (5)
-
PCI add-on card (6)
-
MCA add-on card (7)
-
PCMCIA add-on card (8)
-
Proprietary add-on card (9)
-
NuBus (10)
-
PC-98/C20 add-on card (11)
-
PC-98/C24 add-on card (12)
-
PC-98/E add-on card (13)
-
PC-98/Local bus add-on card (14)
Manufacturer
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (256)
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: DEPRECATED, MappingStrings ("SMBIOS|Type 16|Maximum Capacity")
Use the MaxCapacityEx property instead.
This value comes from the Maximum Capacity member of the Physical Memory Array structure in the SMBIOS information.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 and Windows Vista: 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).
MaxCapacityEx
-
Data type: uint64
-
Access type: Read-only
-
Qualifiers: MappingStrings ("SMBIOS|Type 16|Extended Maximum Capacity"), Units ("kilobytes")
Maximum memory size (in kilobytes) installable for this particular memory array. If the size is unknown, the property is given a value of 0 (zero).
This value comes from the Extended Maximum Capacity member of the Physical Memory Array structure in the SMBIOS information.
Windows Server 2012 R2, Windows 8.1, Windows Server 2012, Windows 8, Windows Server 2008 R2, Windows 7, Windows Server 2008 and Windows Vista: This property is not supported.
MemoryDevices
-
Data type: uint16
-
Access type: Read-only
-
Qualifiers: MappingStrings ("SMBIOS|Type 16|Number of Memory Devices")
Number of physical slots or sockets available in this memory array.
This value comes from the Number of Memory Devices member of the Physical Memory Array structure in the SMBIOS information.
MemoryErrorCorrection
-
Data type: uint16
-
Access type: Read-only
-
Qualifiers: MappingStrings ("SMBIOS|Type 16|Memory Error Correction")
Type of error correction used by the memory array.
This value comes from the Memory Error Correction member of the Physical Memory Array structure in the SMBIOS information.
Reserved (0)
Other (1)
Unknown (2)
None (3)
Parity (4)
Single-bit ECC (5)
Multi-bit ECC (6)
CRC (7)
Model
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64)
Name by which the physical element is generally known.
This property is inherited from CIM_PhysicalElement.
Name
-
Data type: string
-
Access type: Read-only
-
Qualifiers: DisplayName ("Name")
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
-
Qualifiers: MaxLen (256)
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
-
Qualifiers: MaxLen (64)
Manufacturer-allocated number used to identify the physical element.
This property is inherited from CIM_PhysicalElement.
SKU
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64)
Stockkeeping unit number for the physical element.
This property is inherited from CIM_PhysicalElement.
Status
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (10), DisplayName ("Status")
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.
Values include the following:
OK ("OK")
Error ("Error")
Degraded ("Degraded")
Unknown ("Unknown")
Pred Fail ("Pred Fail")
Starting ("Starting")
Stopping ("Stopping")
Service ("Service")
Stressed ("Stressed")
NonRecover ("NonRecover")
No Contact ("No Contact")
Lost Comm ("Lost Comm")
Tag
-
Data type: string
-
Access type: Read-only
-
Qualifiers: Key, MaxLen (256), Override ("Tag"), MappingStrings ("WMI")
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
-
Qualifiers: MappingStrings ("SMBIOS|Type 16|Use")
How memory is used in the computer system.
This value comes from the Use member of the Physical Memory Array structure in the SMBIOS information.
Reserved (0)
Other (1)
Unknown (2)
System memory (3)
Video memory (4)
Flash memory (5)
Non-volatile RAM (6)
Nonvolatile RAM
Cache memory (7)
Version
-
Data type: string
-
Access type: Read-only
-
Qualifiers: MaxLen (64)
Version of the physical element.
This property is inherited from CIM_PhysicalElement.
Weight
-
Data type: real32
-
Access type: Read-only
-
Qualifiers: Units ("pounds")
Weight of the physical package in pounds.
This property is inherited from CIM_PhysicalPackage.
Width
-
Data type: real32
-
Access type: Read-only
-
Qualifiers: Units ("inches")
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
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for