Partager via


Win32_PhysicalMedia class

The Win32_PhysicalMedia class represents any type of documentation or storage medium, such as tapes, CD ROMs, and so on. To obtain the characteristics of the media in a CD drive, such as whether it is writeable, use Win32_CDROMDrive and the Capabilities property.

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

Syntax

[Dynamic, Provider("CIMWin32a"), UUID("{BF253431-1E4D-4F57-00E7-64B2CACC801E}"), AMENDMENT]
class Win32_PhysicalMedia : CIM_PhysicalMedia
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   CreationClassName;
  string   Manufacturer;
  string   Model;
  string   SKU;
  string   SerialNumber = NULL;
  string   Tag = NULL;
  string   Version;
  string   PartNumber;
  string   OtherIdentifyingInfo;
  boolean  PoweredOn;
  boolean  Removable;
  boolean  Replaceable;
  boolean  HotSwappable;
  uint64   Capacity;
  uint16   MediaType;
  string   MediaDescription;
  boolean  WriteProtectOn;
  boolean  CleanerMedia;
};

Members

The Win32_PhysicalMedia class has these types of members:

Properties

The Win32_PhysicalMedia class has these properties.

Capacity

Data type: uint64

Access type: Read-only

Qualifiers: Units ("bytes")

Number of bytes that can be read from or written to this physical media component. This property does not apply to "Hard Copy" or cleaner media. Data compression should not be assumed as it would increase the value of this property. For tapes, it should be assumed that no filemarks or blank space areas are recorded on the media.

For more information about using uint64 values in scripts, see Scripting in WMI.

This property is inherited from CIM_PhysicalMedia.

Caption

Data type: string

Access type: Read-only

Short, one-line textual description of the object.

This property is inherited from CIM_PhysicalMedia.

CleanerMedia

Data type: boolean

Access type: Read-only

If TRUE, the physical media is used for cleaning purposes and not data storage.

This property is inherited from CIM_PhysicalMedia.

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 this class, CreationClassName allows all instances of this class and its subclasses to be uniquely identified.

This property is inherited from CIM_PhysicalMedia.

Description

Data type: string

Access type: Read-only

Textual description of the object.

This property is inherited from CIM_PhysicalMedia.

HotSwappable

Data type: boolean

Access type: Read-only

If TRUE, this physical media component can be replaced with a physically different but equivalent one while the containing package has the power applied. For example, a fan component may be designed to be hot-swapped. All components that can be hot-swapped are inherently removable and replaceable.

This property is inherited from CIM_PhysicalMedia.

InstallDate

Data type: datetime

Access type: Read-only

When the object was installed. This property does not require a value to indicate that the object is installed.

This property is inherited from CIM_PhysicalMedia.

Manufacturer

Data type: string

Access type: Read-only

Name of the organization responsible for producing the physical element. This can be the entity from whom the element is purchased, but this is not necessarily the case as this information is contained in the Vendor property.

This property is inherited from CIM_PhysicalMedia.

MediaDescription

Data type: string

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_PhysicalMedia.MediaType")

Additional detail related to the MediaType property. For example, if MediaType has the value 3 (QIC Cartridge) the MediaDescription property can indicate whether the tape is wide or quarter inch.

This property is inherited from CIM_PhysicalMedia.

MediaType

Data type: uint16

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_PhysicalMedia.MediaDescription")

The type of the media, as an enumerated integer. The MediaDescription property provides a more explicit definition of the media type.

This property is inherited from CIM_PhysicalMedia.

The following list lists the possible values.

Unknown (0)

Other (1)

Tape Cartridge (2)

QIC Cartridge (3)

AIT Cartridge (4)

DTF Cartridge (5)

DAT Cartridge (6)

8mm Tape Cartridge (7)

19mm Tape Cartridge (8)

DLT Cartridge (9)

Half-Inch Magnetic Tape Cartridge (10)

Cartridge Disk (11)

JAZ Disk (12)

ZIP Disk (13)

SyQuest Disk (14)

Winchester Removable Disk (15)

CD-ROM (16)

CD ROM

CD-ROM/XA (17)

CD ROM/XA

CD-I (18)

CD Recordable (19)

WORM (20)

Magneto-Optical (21)

DVD (22)

DVD+RW (23)

DVD-RAM (24)

DVD-ROM (25)

DVD-Video (26)

Divx (27)

Floppy/Diskette (28)

Hard Disk (29)

Memory Card (30)

Hard Copy (31)

Clik Disk (32)

CD-RW (33)

CD-DA (34)

CD+ (35)

DVD Recordable (36)

DVD-RW (37)

DVD-Audio (38)

DVD-5 (39)

DVD-9 (40)

DVD-10 (41)

DVD-18 (42)

Magneto-Optical Rewriteable (43)

Magneto-Optical Write Once (44)

Magneto-Optical Rewriteable (LIMDOW) (45)

Phase Change Write Once (46)

Phase Change Rewriteable (47)

Phase Change Dual Rewriteable (48)

Ablative Write Once (49)

Near Field Recording (50)

MiniQic (51)

Travan (52)

8mm Metal Particle (53)

8mm Advanced Metal Evaporate (54)

NCTP (55)

LTO Ultrium (56)

LTO Accelis (57)

9 Track Tape (58)

18 Track Tape (59)

36 Track Tape (60)

Magstar 3590 (61)

Magstar MP (62)

D2 Tape (63)

Tape - DST Small (64)

Tape - DST Medium (65)

Tape - DST Large (66)

Model

Data type: string

Access type: Read-only

Name by which the physical element is generally known.

This property is inherited from CIM_PhysicalMedia.

Name

Data type: string

Access type: Read-only

Label by which the object is known. When subclassed, the Name property can be overridden to be a Key property.

This property is inherited from CIM_PhysicalMedia.

OtherIdentifyingInfo

Data type: string

Access type: Read-only

Additional data, beyond asset tag information, that can 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, is unique, and it can be used as an element key, this property is NULL and the bar code data used is the class key in the Tag property.

This property is inherited from CIM_PhysicalMedia.

PartNumber

Data type: string

Access type: Read-only

Part number assigned by the manufacturer of the physical element.

This property is inherited from CIM_PhysicalMedia.

PoweredOn

Data type: boolean

Access type: Read-only

If TRUE the physical element is powered on.

This property is inherited from CIM_PhysicalMedia.

Removable

Data type: boolean

Access type: Read-only

If TRUE, the physical component 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 component can still be removable if the power must be "off" to perform the removal. If power can be "on" and the component removed, the element is removable and can be hot-swapped.

This property is inherited from CIM_PhysicalMedia.

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. All removable components are inherently replaceable.

This property is inherited from CIM_PhysicalMedia.

SerialNumber

Data type: string

Access type: Read-only

Qualifiers: Override ("SerialNumber"), MappingStrings ("")

Manufacturer-allocated number used to identify the physical media. The default value is NULL.

Example: WD-WM3493798728

SKU

Data type: string

Access type: Read-only

Stock keeping unit number for this physical element.

This property is inherited from CIM_PhysicalMedia.

Status

Data type: string

Access type: Read-only

Current status of the object. Various operational and nonoperational statuses can be defined. Operational statuses are "OK", "Degraded", and "Pred Fail". "Pred Fail" indicates that an element may function properly at the present, but predicts a failure in the near future. For example, a SMART-enabled hard disk drive. Nonoperational statuses can also be specified. These are, "Error", "Starting", "Stopping," and "Service". The "Service" status applies to administrative work, such as mirror-resilvering of a disk or reload of a user permissions list. 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_PhysicalMedia.

The values are:

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 ("")

Uniquely identifies the physical media in the system.

Example: PHYSICALDRIVE0

Version

Data type: string

Access type: Read-only

Version of the physical element.

This property is inherited from CIM_PhysicalMedia.

WriteProtectOn

Data type: boolean

Access type: Read-only

If TRUE, the media is currently write protected by some kind of physical mechanism, such as a protect tab on a floppy disk.

This property is inherited from CIM_PhysicalMedia.

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\CIMV2
MOF
Wmipcima.mof
DLL
Wmipcima.dll

See also

CIM_PhysicalMedia

Computer System Hardware Classes