This documentation is archived and is not being maintained.

MSFT_SIPRoutingTableData class

Office 2003
 
Microsoft Office Live Communications Server 2005 with SP1

MSFT_SIPRoutingTableData

The MSFT_SIPRoutingTableData class defines a single static route entry in the Live Communications Server routing table.

The following syntax is simplified from MOF code and includes all inherited properties.

class MSFT_SIPRoutingTableData
{
  [key] string Backend;
  boolean DropRouteHeaders;
  boolean Enabled;
  [key] string InstanceID;
  string MatchURI;
  string NextHop;
  uint32 NextHopPort;
  string NextHopTransport;
  boolean ReplaceHostInRequestURI;
  uint8 [] TLSCertIssuer;
  uint8 [] TLSCertSN;
  boolean TreatAllConnectionsAsServer;
  boolean TreatAllConnetionsAsTrusted;
};

Methods

This class does not define any methods.

Properties

The MSFT_SIPRoutingTableData class has the following properties.

Backend
Data type: [key] string

The computer name (either the FQDN or NetBIOS name) and SQL Server instance name of the Microsoft® Office Live Communications Server 2005 with SP1, Back-End Database (configuration data is stored in the same SQL instance as user data, but in a different database). Indicates where this class is stored, which varies depending on the server role.

Server RoleAcceptable Values
Enterprise EditionBackend_FQDN\SQL_Instance_Name
Standard Edition(local)\rtc
Access Proxy and Proxy serversEmpty string

This property cannot be updated.

DropRouteHeaders
Data type: boolean

Drop all Route headers from messages arriving at this listening address.

ValueDescription
falseDo not drop Route headers.
trueDrop Route headers.

The value cannot be NULL. This property is required on creation and can be updated.

Enabled
Data type: boolean

If true, this route entry is enabled and any message that matches the URI pattern in MatchURI will be routed to the IP address/port specified by NextHop and NextHopPort. If false, the route is not enabled. This property cannot be NULL.

This property is required on creation and can be updated.

InstanceID
Data type: [key] string

A GUID value that uniquely identifies this routing table entry. The GUID must be encapsulated between the "{" and "}" braces; for example: "{01234567-0123-4567-89AB-CDEF01234567}".

This property is optional on creation and cannot be updated.

MatchURI
Data type: string

A pattern that is matched against the Request-URI header of a SIP message. A valid value is any match pattern of the form sip:<user name>@<host address>[;<uri parameters>]. For example, sip:*@*.example.net is a valid match pattern. The maximum string length is 454. This property cannot be NULL.

This property is required on creation and can be updated.

NextHop
Data type: string

The address of the immediate destination for the routed message, as an IP address of the form "xxx.xxx.xxx.xxx" or as a fully qualified domain name. The domain name "*" is not valid, nor is the IP address "0.0.0.0". Multicast addresses in the ranges from 224.0.0.0 to 239.255.255.255 are also not valid. This property cannot be NULL.

This property is required on creation and can be updated.

NextHopPort
Data type: uint32

The port number for the next hop in the route. Valid values range from 1 to 65535. This property cannot be NULL.

This property is required on creation and can be updated.

NextHopTransport
Data type: string

The transport protocol used by the next hop in the route. This property is required on creation and can be updated. This property cannot be NULL.

ValueDescription
"TCP"The transport protocol for the next hop in the route is TCP.
"TLS"The transport protocol for the next hop in the route is TLS.
ReplaceHostInRequestURI
Data type: boolean

If true, the host name portion of the Request-URI header value is replaced with the address specified in NextHop. If false, it is not changed. This property cannot be NULL.

This property is required on creation and can be updated.

TLSCertIssuer
Data type: uint8 []

The certificate authority that issued the certificate as a byte array.

If MTLS is specified, this property must contain the fully qualified domain name of the certificate server. This value must be NULL for TCP connections, and can be not NULL for TLS connections.

This property is optional on creation and can be updated.

TLSCertSN
Data type: uint8 []

The serial number of the certificate as a byte array.

This value must be NULL for TCP connections, and can be not NULL for TLS connections

This property is optional on creation and can be updated.

TreatAllConnectionsAsServer
Data type: boolean

Treat all connections on this listening address as originating from a server.

ValueDescription
falseDo not treat all connections as server connections.
trueTreat all connections as server connections.

The value cannot be NULL. This property is required on creation and can be updated.

TreatAllConnetionsAsTrusted
Data type: boolean

Treat all connections as trusted connections.

ValueDescription
falseDo not treat all connections as trusted.
trueTreat all connections as trusted.

The value cannot be NULL. This property is required on creation and can be updated.

Remarks

Available actions for an instance of this class:

  • Creation: The administrator can create instances of this class.
  • Updates: The administrator can update instances of this class.
  • Deletion: The administrator can delete instances of this class.

Requirements

Server: Installed on Windows Server 2003 with Live Communications Server 2005 with SP1.
Namespace: Defined in \root\cimv2.

See Also

MSFT_SIPRoutingSetting, Live Communications Server WMI Reference

  
  What did you think of this topic?
  © 2008 Microsoft Corporation. All rights reserved.

 

Show: