Share via


CIM_VLANEndpoint class

An endpoint on a switch or endstation which is assigned to a given VLAN or accepts traffic from one or more VLANs. As defined by the property, OperationalEndpointMode, the endpoint may be configured as trunking or nontrunking. Note that an endpoint may dynamically be converted to/from a trunking mode. When this occurs, simply update the OperationalEndpointMode property. This class is associated with a DataLink or IPProtocol Endpoint - as another aspect of that endpoint - using the LogicalIdentity relationship. In this case, the VLANEndpoint takes the role of SameElement.

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_VLANEndpoint : CIM_ProtocolEndpoint
{
  uint16 DesiredEndpointMode;
  string OtherEndpointMode;
  uint16 OperationalEndpointMode;
  uint16 DesiredVLANTrunkEncapsulation;
  string OtherTrunkEncapsulation;
  uint16 OperationalVLANTrunkEncapsulation;
  uint16 GVRPStatus;
};

Members

The CIM_VLANEndpoint class has these types of members:

  • Properties

Properties

The CIM_VLANEndpoint class has these properties.

DesiredEndpointMode

Data type: uint16

Access type: Write-only

The desired VLAN mode that is requested for use. (Note that the current mode is given by the OperationalEndpointMode property.) The following values are defined: - Access: Puts the endpoint/switch port into permanent nontrunking mode and negotiates to convert the link into a nontrunk link. The endpoint becomes a nontrunk interface. - Dynamic Auto: Makes the endpoint able to convert the link to a trunk link. The endpoint becomes a trunk interface if the neighboring interface is set to trunk or desirable mode. - Dynamic Desirable: Makes the endpoint actively attempt to convert the link to a trunk link. The endpoint becomes a trunk interface if the neighboring interface is set to trunk, desirable, or auto mode. The default switch-port mode for all Ethernet interfaces is 'dynamic desirable.' - Trunk: Puts the endpoint into permanent trunking mode and negotiates to convert the link into a trunk link. The endpoint becomes a trunk interface even if the neighboring interface is not a trunk interface. - Dot1Q Tunnel: Configures the interface as a tunnel (nontrunking) endpoint/port to be connected in an asymmetric link with an 802.1Q trunk port. 802.1Q tunneling is used to maintain customer VLAN integrity across a service provider network.

DMTF Reserved (0)

Other (1)

Access (2)

Dynamic Auto (3)

Dynamic Desirable (4)

Trunk (5)

Dot1Q Tunnel (6)

DMTF Reserved (7..32767)

Vendor Reserved (.. )

DesiredVLANTrunkEncapsulation

Data type: uint16

Access type: Write-only

The type of VLAN encapsulation that is requested for use. (Note that the encapsulation currently in use is given by the OperationalVLANTrunkEncapsulation property.) Note that this property is only applicable when the endpoint is operating in a trunking mode (see the OperationalEndpointMode property for additional details). This property is either 'not applicable' (that is, the endpoint will never be placed in a trunking mode), a particular type (802.1q or Cisco ISL), or 'negotiate' (that is, the result of the negotiation between this interface and its neighbor). The value, 'Negotiate' is not allowed if the endpoint does not support negotiation. This capability is hardware and vendor dependent. Refer to the associated VLANEndpointCapabilities.doesTrunkEncapsulationNegotiation property to validate whether a particular endpoint (port) supports encapsulation negotiation.

DMTF Reserved (0)

Other (1)

Not Applicable (2)

802.1q (3)

Cisco ISL (4)

Negotiate (5)

DMTF Reserved (6..32767)

Vendor Reserved (32768.. )

GVRPStatus

Data type: uint16

Access type: Write-only

Indicates whether GARP VLAN Registration Protocol (GVRP) is enabled or disabled on the trunk endpoint/port. This property is 'not applicable' unless GVRP is supported by the endpoint. This is indicated in the Capabilities property, VLANEndpointCapabilities.Dot1QTagging. This property is applicable only when the endpoint is operating in trunking mode (determined by examining the SwitchEndpointMode property).

Unknown (0)

Not Applicable (2)

Enabled (3)

Disabled (4)

OperationalEndpointMode

Data type: uint16

Access type: Write-only

The configuration mode for the VLAN endpoint. The following values are defined: /n - Unknown: If the endpoint is not VLAN aware. /n - Access: Puts the endpoint into permanent nontrunking mode and negotiates to convert the link into a nontrunk link. The endpoint becomes a nontrunk interface. - Dynamic Auto: Makes the endpoint able to convert the link to a trunk link. The endpoint becomes a trunk interface if the neighboring interface is set to trunk or desirable mode. - Dynamic Desirable: Makes the endpoint actively attempt to convert the link to a trunk link. The endpoint becomes a trunk interface if the neighboring interface is set to trunk, desirable, or auto mode. The default switch-port mode for all Ethernet interfaces is 'dynamic desirable.' - Trunk: Puts the endpoint into permanent trunking mode and negotiates to convert the link into a trunk link. The endpoint becomes a trunk interface even if the neighboring interface is not a trunk interface. - Dot1Q Tunnel: Configures the interface as a tunnel (nontrunking) endpoint/port to be connected in an asymmetric link with an 802.1Q trunk port. 802.1Q tunneling is used to maintain customer VLAN integrity across a service provider network.

DMTF Reserved (0)

Other (1)

Access (2)

Dynamic Auto (3)

Dynamic Desirable (4)

Trunk (5)

Dot1Q Tunnel (6)

DMTF Reserved (7..32767)

Vendor Reserved (.. )

OperationalVLANTrunkEncapsulation

Data type: uint16

Access type: Write-only

The type of VLAN encapsulation in use on a trunk endpoint/port. This property is either 'not applicable' (that is, the endpoint is not operating in trunking mode), a particular type (802.1q or Cisco ISL), 'negotiating' (that is, the endpoints are negotiating the encapsulation type). Note that this property is only applicable when the endpoint is operating in a trunking mode (see the OperationalEndpointMode property for additional details).

Unknown (0)

Other (1)

Not Applicable (2)

802.1q (3)

Cisco ISL (4)

Negotiating (5)

DMTF Reserved (6..32767)

Vendor Reserved (32768.. )

OtherEndpointMode

Data type: string

Access type: Write-only

A string describing the type of VLAN endpoint model that is supported by this VLANEndpoint, when the value of the mode property is set to 1 (that is, "Other"). This property should be set to NULL when the mode property is any value other than 1.

OtherTrunkEncapsulation

Data type: string

Access type: Write-only

A string describing the type of VLAN encapsulation that is supported by this VLANEndpoint, when the value of the encapsulation property is set to 1 (that is, "Other"). This property should be set to NULL when the desired encapsulation property is any value other than 1.

Requirements

Namespace

Root\CIMV2