CIM_SwitchService class

Generic switch (bridging) service class. Additional switching functions are incorporated as subordinate services related to this class via ServiceComponent associations.

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 the inherited properties.

Syntax

class CIM_SwitchService : CIM_ForwardingService
{
  string OtherProtocolType;
  uint16 ProtocolType;
  string Keywords;
  string ServiceURL;
  string StartupConditions;
  string StartupParameters;
  string BridgeAddress;
  uint16 NumPorts;
  uint8  BridgeType;
  uint16 BridgeAddressType;
};

Members

The CIM_SwitchService class has these types of members:

  • Properties

Properties

The CIM_SwitchService class has these properties.

BridgeAddress

Data type: string

Access type: Read-only

Qualifiers: MaxLen ( 32)

Address used by this SwitchService when it must be uniquely identified. For an ethernet bridge, the MAC Address serves as the BridgeAddress. When concatenated with a SpanningTreeService Priority, a unique bridge identifier results. The MAC address is formatted as twelve hexadecimal digits (for example, "010203040506"), with each pair representing one of the six octets of the MAC address in "canonical" bit order according to RFC 2469. In other scenarios, like IPv6, the address is formatted as "ffff:ffff:ffff:ffff".

BridgeAddressType

Data type: uint16

Access type: Read-only

BridgeAddressType defines the type of addressing scheme used for this Bridge and its BridgeAddress property.

Other (1)

IPv4 (2)

IPv6 (3)

MAC (4)

MAC + Spanning Tree Priority (5)

BridgeType

Data type: uint8

Access type: Read-only

Indicates what type of switching service can be performed.

Unknown (1)

Transparent-only (2)

SourceRoute-only (3)

SRT (4)

Keywords

Data type: string

Access type: Read-only

This is a free-form array of strings that provide descriptive words and phrases that can be used in queries. To date, this property has not been implemented, because it is not standardized. Also, if this were a necessary query construct, then it would be required higher in the inheritance hierarchy. The latter has not proven necessary. Therefore, this property is deprecated.

NumPorts

Data type: uint16

Access type: Read-only

The number of switch ports controlled by this switching service.

OtherProtocolType

Data type: string

Access type: Read-only

Qualifiers: MaxLen ( 32)

The type of protocol forwarded when the value of ProtocolType is 1("Other"). This provides for extensibility.

ProtocolType

Data type: uint16

Access type: Read-only

The type of protocol forwarded.

Unknown (0)

Other (1)

IPv4 (2)

IPv6 (3)

IPv4/IPv6 (4)

IPX (5)

AppleTalk (6)

DECnet (7)

SNA (8)

CONP (9)

CLNP (10)

VINES (11)

XNS (12)

ATM (13)

Frame Relay (14)

Ethernet (15)

TokenRing (16)

FDDI (17)

Infiniband (18)

Fibre Channel (19)

ServiceURL

Data type: string

Access type: Read-only

This is a URL that provides the protocol, network location, and other service-specific information required to access the service. It is deprecated with the recommendation that ServiceAccessURI be instantiated instead. This new class correctly positions the semantics of the service access, and clarifies the format of the information.

StartupConditions

Data type: string

Access type: Read-only

This is a free-form array of strings that specify any specific preconditions that must be met for this service to start correctly. It was expected that subclasses would refine the inherited StartService() method to suit their specific needs. To date, this refinement has not been necessary. Also, the property is not very useful because it is not standardized. If this were a necessary construct, then it would be required higher in the inheritance hierarchy (on Service). The latter has not proven true. Therefore, the property is deprecated.

StartupParameters

Data type: string

Access type: Read-only

This is a free-form array of strings that specify any specific parameters that must be supplied to the StartService() method for this service to start correctly. It was expected that subclasses would refine the inherited StartService() methods to suit their specific needs. To date, this refinement has not been necessary. If the method were refined, then its parameters would more formally convey this information. Therefore, the property is deprecated.

Requirements

Namespace

Root\CIMV2

See also

CIM_ForwardingService