MSFT_PhysicalDisk class

Represents a subsystem drive or spindle.

The following syntax is simplified from Managed Object Format (MOF) code.

Syntax

class MSFT_PhysicalDisk : MSFT_StorageObject
{
  String  DeviceId;
  String  FriendlyName;
  UInt16  Usage;
  UInt16  SupportedUsages[];
  String  Description;
  String  Manufacturer;
  String  Model;
  String  SerialNumber;
  String  PartNumber;
  String  FirmwareVersion;
  String  SoftwareVersion;
  UInt16  OperationalStatus[];
  UInt16  HealthStatus;
  UInt64  Size;
  UInt64  AllocatedSize;
  UInt16  BusType;
  UInt64  PhysicalSectorSize;
  UInt64  LogicalSectorSize;
  UInt32  SpindleSpeed;
  Boolean IsIndicationEnabled;
  String  PhysicalLocation;
  UInt16  EnclosureNumber;
  UInt16  SlotNumber;
  Boolean CanPool;
  UInt16  CannotPoolReason[];
  String  OtherCannotPoolReasonDescription;
  Boolean IsPartial;
  UInt16  MediaType;
};

Members

The MSFT_PhysicalDisk class has these types of members:

Methods

The MSFT_PhysicalDisk class has these methods.

MethodDescription
Maintenance

Performs a maintenance operation on the physical disk.

Reset

Resets the physical disk.

SetAttributes

Updates the attributes of the physical disk.

SetDescription

Sets or changes the description for the physical disk.

SetFriendlyName

Sets or changes the friendly name for the physical disk.

SetUsage

Sets or changes the intended usage for the physical disk within a concrete pool.

 

Properties

The MSFT_PhysicalDisk class has these properties.

AllocatedSize
Data type: UInt64
Access type: Read-only
Qualifiers: Units ("Bytes")

The total amount of used space on this physical disk. This should include usage from all storage pools and other data stored on the disk.

BusType
Data type: UInt16
Access type: Read-only
Qualifiers: Required

The storage bus type of the physical disk.

ValueMeaning
Unknown
0

The bus type is unknown.

SCSI
1

SCSI

ATAPI
2

ATAPI

ATA
3

ATA

1394
4

IEEE 1394

SSA
5

SSA

Fibre Channel
6

Fibre Channel

USB
7

USB

RAID
8

RAID

iSCSI
9

iSCSI

SAS
10

Serial Attached SCSI (SAS)

SATA
11

Serial ATA (SATA)

SD
12

Secure Digital (SD)

MMC
13

Multimedia Card (MMC)

MAX
14

This value is reserved for system use.

File Backed Virtual
15

File-Backed Virtual

Storage Spaces
16

Storage Spaces

Microsoft Reserved
17..

This value is reserved for system use.

 

CannotPoolReason
Data type: UInt16 array
Access type: Read-only
Qualifiers: Required

An array of values specifying the reasons why this physical disk cannot be added to a concrete pool. This property is valid only if the CanPool property is FALSE.

Unknown (0)
Other (1)
In a Pool (2)
Not Healthy (3)
Removable Media (4)
In Use by Cluster (5)
Offline (6)
Insufficient Capacity (7)
Spare Disk (8)
Reserved by subsystem (9)
Microsoft Reserved (..)
Vendor Reserved (..)
CanPool
Data type: Boolean
Access type: Read-only
Qualifiers: Required

TRUE if this physical disk can be added to a concrete pool.

Description
Data type: String
Access type: Read-only

A user-settable description of the physical disk.

DeviceId
Data type: String
Access type: Read-only

An address or other identifier that uniquely names the physical disk.

EnclosureNumber
Data type: UInt16
Access type: Read-only

The number of the enclosure in which the disk physically resides.

FirmwareVersion
Data type: String
Access type: Read-only
Qualifiers: Required

A string representation of the firmware version number.

FriendlyName
Data type: String
Access type: Read-only
Qualifiers: Required

A user-friendly display name for the physical disk. The initial value should be set by the storage provider or subsystem, and can be modified by the user at any point in the object's lifetime.

HealthStatus
Data type: UInt16
Access type: Read-only

The health status of the physical disk.

ValueMeaning
Healthy
0

The physical disk is in a good state. There has been no reported read or write packet loss.

Warning
1

The physical disk may be failing some read requests, but there have been no reported write failures.

Unhealthy
2

The physical disk is failing read and write requests, or is no longer responding to any commands.

Unknown
5

The health status is unknown.

 

IsIndicationEnabled
Data type: Boolean
Access type: Read-only

Indicates whether the physical disk's identification LEDs are active or not. This is typically used in maintenance operations.

IsPartial
Data type: Boolean
Access type: Read-only

TRUE if this physical disk is partially consumed by a system or service outside of normal storage pool operations.

LogicalSectorSize
Data type: UInt64
Access type: Read-only
Qualifiers: Required, Units ("Bytes")

The logical sector size of the physical disk, in bytes. For example: a 4K native disk should report 4096, while a 512-byte emulated disk should report 512.

Manufacturer
Data type: String
Access type: Read-only
Qualifiers: Required

The name of the company responsible for the hardware backing the physical disk. This manufacturer information must match what is reported by the disk's SCSI inquiry data.

MediaType
Data type: UInt16
Access type: Read-only

The media type of the physical disk.

ValueMeaning
0

Unspecified

3

HDD

4

SSD

 

Model
Data type: String
Access type: Read-only
Qualifiers: Required

The model number of the physical disk hardware. This information must match what is reported by the disk's SCSI inquiry data.

OperationalStatus
Data type: UInt16 array
Access type: Read-only
Qualifiers: Required

An array of values that specify the operational status of the physical disk.

ValueMeaning
Unknown
0

The operational status of the physical disk is unknown.

OK
2

The physical disk is responding to commands and is in a normal operating state.

Degraded
3

The physical disk is responding to commands but is not running in an optimal operating state.

Stressed
4

The physical disk is functioning but needs attention. For example, it might be overloaded or overheated.

Predictive Failure
5

The physical disk is functioning nominally, but a failure in the near future is predicted.

Error
6

An error has occurred.

Non-Recoverable Error
7

A nonrecoverable error has occurred.

Starting
8

The physical disk is in the process of starting.

Stopping
9

The physical disk is in the process of stopping.

Stopped
10

The physical disk was stopped or shut down in a clean and orderly fashion.

In Service
11

The physical disk is being configured, maintained, cleaned, or otherwise administered.

No Contact
12

The storage provider has knowledge of the physical disk but has never been able to establish communication with it.

Lost Communication
13

The physical disk is known to exist and has been contacted successfully in the past but is currently unreachable.

Dormant
15

The physical disk is reachable, but it is inactive.

Power Mode
18

This value is reserved for system use.

Microsoft Reserved
..

This value is reserved for system use.

Failed Media
0x8004

This value is reserved for system use.

Split
0x8005

This value is reserved for system use.

Stale Metadata
0x8006

This value is reserved for system use.

IO Error
0x8007

This value is reserved for system use.

Corrupt Metadata
0x8008

This value is reserved for system use.

Microsoft Reserved
0x8009..

This value is reserved for system use.

 

OtherCannotPoolReasonDescription
Data type: String
Access type: Read-only

A string containing the vendor-defined reason why this physical disk cannot be added to a concrete pool. This property must be NULL if the value of the CannotPoolReason property is not Other.

PartNumber
Data type: String
Access type: Read-only
Qualifiers: Required

A string representation of the physical disk's part number or SKU.

PhysicalLocation
Data type: String
Access type: Read-only

A free-form string indicating where the disk physically resides.

PhysicalSectorSize
Data type: UInt64
Access type: Read-only
Qualifiers: Required, Units ("Bytes")

The physical sector size of the physical disk, in bytes. For example: for 4K native and 512-byte emulated disks, the value of this property should be 4096.

SerialNumber
Data type: String
Access type: Read-only
Qualifiers: Required

A string representation of the physical disk's serial number. This information must match what is reported by the disk's SCSI inquiry data.

Size
Data type: UInt64
Access type: Read-only
Qualifiers: Units ("Bytes")

Total physical storage size of the disk, in bytes.

SlotNumber
Data type: UInt16
Access type: Read-only

The number of the enclosure slot in which the disk physically resides.

SoftwareVersion
Data type: String
Access type: Read-only
Qualifiers: Required

A string representation of the software version number.

SpindleSpeed
Data type: UInt32
Access type: Read-only
Qualifiers: Required, Units ("RPM")

The rotational speed of spindle-based physical disks. For solid state devices (SSDs) or other non-rotational media, this member should be set to 0. For rotating media that has an unknown speed, this member should be set to 0xFFFFFFFF (UINT32_MAX).

SupportedUsages
Data type: UInt16 array
Access type: Read-only
Qualifiers: Required

An array of values that specify the supported usages for this physical disk.

ValueMeaning
Unknown
0

The intended usage is not specified.

Data Store
1

This physical disk should only be used for data storage.

Manual-Select
2

This physical disk should only be used if manually selected by an administrator at the time of virtual disk creation. A manual-select disk is selected using the PhysicalDisksToUse parameter to CreateVirtualDisk.

Hot Spare
3

This physical disk should be used as a hot spare.

Retired
4

This physical disk has been retired.

 

Usage
Data type: UInt16
Access type: Read-only
Qualifiers: Required

The intended usage of this physical disk within a concrete pool.

Storage pools are required to follow the assigned policy for a physical disk.

ValueMeaning
Unknown
0

The intended usage is not specified.

Data Store
1

This physical disk should only be used for data storage.

Manual-Select
2

This physical disk should only be used if manually selected by an administrator at the time of virtual disk creation. A manual-select disk is selected using the PhysicalDisksToUse parameter to CreateVirtualDisk.

Hot Spare
3

This physical disk should be used as a hot spare.

Retired
4

This physical disk should be retired from use. At a minimum, no new allocations should go to this disk. If the virtual disks that reside on this disk are repaired, the data should be moved to another active physical disk.

 

Requirements

Minimum supported client

Windows 8 [desktop apps only]

Minimum supported server

Windows Server 2012 [desktop apps only]

Namespace

\\.\Root\Microsoft\Windows\Storage

MOF

Storagewmi.mof

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.