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.

CIM_PhysicalLink class

The CIM_PhysicalLink class represents the cabling of physical elements. For example, serial or Ethernet cables and infrared links would be subclasses (if additional properties or associations are defined) or instances of CIM_PhysicalLink. Typically, the numerous physical cables within a physical package or network are not modeled. However, when the cables or links are critical components or tagged assets of the company, the objects can be instantiated using this class or one of its descendent classes.

Important  The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.

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

Syntax

class CIM_PhysicalLink : CIM_PhysicalElement
{
  string   Caption;
  string   CreationClassName;
  string   Description;
  datetime InstallDate;
  real64   Length;
  string   Manufacturer;
  real64   MaxLength;
  uint16   MediaType;
  string   Model;
  string   Name;
  string   OtherIdentifyingInfo;
  string   PartNumber;
  boolean  PoweredOn;
  string   SerialNumber;
  string   SKU;
  string   Status;
  string   Tag;
  string   Version;
  boolean  Wired;
};

Members

The CIM_PhysicalLink class has these types of members:

Properties

The CIM_PhysicalLink class has these properties.

Caption
Data type: string
Access type: Read-only

Short textual description of the object. This property is inherited from CIM_ManagedSystemElement.

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 the class, this property allows all instances of the class and its subclasses to be uniquely identified. This property is inherited from CIM_PhysicalElement.

Description
Data type: string
Access type: Read-only

Textual description of the object. This property is inherited from CIM_ManagedSystemElement.

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.

Length
Data type: real64
Access type: Read-only

Current length of the physical link, in feet. For some connections, especially wireless technologies, this property might not be applicable and should be left uninitialized.

Manufacturer
Data type: string
Access type: Read-only

Name of the organization responsible for producing the physical element. For more information, see the Vendor property of CIM_Product. This property is inherited from CIM_PhysicalElement.

MaxLength
Data type: real64
Access type: Read-only

Maximum length of the physical link in feet.

MediaType
Data type: uint16
Access type: Read-only

Type of media through which transmission signals pass. Common network media include twisted-pair, coaxial, and fiber-optic cable.

ValueMeaning
0

Unknown

1

Other

2

Cat1

3

Cat2

4

Cat3

5

Cat4

6

Cat5

7

50-ohm coaxial

8

75-ohm coaxial

9

100-ohm coaxial

10

Fiber-optic

11

UTP

12

STP

13

Ribbon cable

14

Twinaxial

15

Optical 9um

16

Optical 50um

17

Optical 62.5um

 

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, this 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 can be used to identify a physical element. One example is bar-code data that is associated with an element, which also has an asset tag. Note that if only bar-code data is available, and is unique and able to be used as an element key, this property would be null and the bar-code data would be 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.

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

Stock-keeping 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. This property is inherited from CIM_ManagedSystemElement.

Values include the following:

"OK"
"Error"
"Degraded"
"Unknown"
"Pred Fail"
"Starting"
"Stopping"
"Service"
"Stressed"
"NonRecover"
"No Contact"
"Lost Comm"
Tag
Data type: string
Access type: Read-only

Arbitrary string that uniquely identifies the physical element and serves as the element's key. This property can contain information, such as asset tag or serial number data. The key for CIM_PhysicalElement is placed very high in the object hierarchy to independently identify the hardware or entity, regardless of physical placement in (or on) cabinets, adapters, and so on. For example, a removable component that can be hot-swapped can be taken from its containing (scoping) package and be temporarily unused. The object still continues to exist and can even be inserted into a different scoping container. The key for a physical element is an arbitrary string that is defined independently of placement or location-oriented hierarchy. This property is inherited from CIM_PhysicalElement.

Version
Data type: string
Access type: Read-only

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

Wired
Data type: boolean
Access type: Read-only

If TRUE, the physical link is a cable. Otherwise, it is a wireless connection.

Remarks

The CIM_PhysicalLink class is derived from CIM_PhysicalElement.

WMI does not implement this class.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2003

Namespace

Root\CIMV2

MOF

CIMWin32.mof

DLL

CIMWin32.dll

 

 

Show:
© 2015 Microsoft