MSFT_SIPESGlobalRegistrarSetting class

MSFT_SIPESGlobalRegistrarSetting

The MSFT_SIPESGlobalRegistrarSetting class specifies preferences for all Live Communications Server 2005 with SP1 Standard Edition and Enterprise Edition servers in the forest, including point-of-presence availability and various expiration settings.

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

class MSFT_SIPESGlobalRegistrarSetting
{
  boolean AllowPollingForPresence;
  uint32 DefPresenceSubscriptionExpiry;
  uint32 DefRegistrationExpiry;
  uint32 DefRoamingDataSubscriptionExpiry;
  boolean EnableBENotify;
  [key] string InstanceID;
  uint32 MaxPresenceSubscriptionExpiry;
  uint32 MaxRegistrationExpiry;
  uint32 MaxRoamingDataSubscriptionExpiry;
  uint32 MaxSubscriptionPerUser;
  uint32 MinPresenceSubscriptionExpiry;
  uint32 MinRegistrationExpiry;
  uint32 MinRoamingDataSubscriptionExpiry;
  uint32 NumOfDevicesPerUser;
  string [] UserDomainList;
};

Methods

This class does not define any methods.

Properties

The MSFT_SIPESGlobalRegistrarSetting class has the following properties.

• AllowPollingForPresence
  Data type: boolean

  If true, presence polling is allowed on the Live Communications Server; if false, it is not.

  "Presence polling" is defined as checking for the presence of users who are not part of the polling user's contact list. For example, a mail client might poll for the presence of people who have sent you mail, but who are not in your contact list.

  The default value is true.

  This property can be updated.

• DefPresenceSubscriptionExpiry
  Data type: uint32

  The default expiry in seconds that a user agent client can request for a presence subscription. If the value requested by the client in the Expires header is less than this value, this value is returned in the response.

  The minimum value for this property is 300 and the maximum value is 86340. The default value is 28800 seconds, or 8 hours.

  This property can be updated.

• DefRegistrationExpiry
  Data type: uint32

  The registration time-out in seconds that a user agent client can request. If the value requested by the client in the Expires header is less than this value, this value is returned in the response.

  The minimum value for this property is 300 and the maximum value is 900. The default value is 600 seconds, or 10 minutes.

  This property can be updated.

• DefRoamingDataSubscriptionExpiry
  Data type: uint32

  The default expiry in seconds that a user agent client can request for roaming data persistence with Live Communications User Services. If the value requested by the client in the Expires header is less than this value, this value is returned in the response.

  The minimum value for this property is 300 and the maximum value is 86340. The default value is 43200 seconds, or 12 hours.

  This property can be updated.

• EnableBENotify
  Data type: boolean

  If true, the server uses the BENOTIFY (best-effort notify) method in response to SUBSCRIBE requests. The BENOTIFY method does not require a response.

  If false, the server does not use the BENOTIFY method. To interoperate with Live Communications Server 2003 third-party applications (which expect the NOTIFY request) deployed on a computer running Live Communications Server 2005 with SP1, an administrator can set this value to false.

  The default value is true.

  This property can be updated.

• InstanceID
  Data type: [key] string

  A GUID value that uniquely identifies the global registrar settings object. The GUID must be encapsulated between the "{" and "}" braces; for example: "{01234567-0123-4567-89AB-CDEF01234567}".

  This property cannot be updated.

• MaxPresenceSubscriptionExpiry
  Data type: uint32

  The maximum expiry in seconds that a user agent client can request for a presence subscription. If the value requested by the client in the Expires header is greater than this value, this value is returned in the response.

  The minimum value for this property is 300 and the maximum value is 86340. The default value is 43200 seconds, or 12 hours.

  This property can be updated.

• MaxRegistrationExpiry
  Data type: uint32

  The registration time-out in seconds that a user agent client can request. If the value requested by the client in the Expires header is greater than this value, this value is returned in the response.

  The minimum value for this property is 300 and the maximum value is 900. The default value is 900 seconds, or 15 minutes.

  This property can be updated.

• MaxRoamingDataSubscriptionExpiry
  Data type: uint32

  The maximum expiry in seconds that a user agent client can request for roaming data persistence with Live Communications User Services. If the value requested by the client in the Expires header is greater than this value, this value is returned in the response.

  The minimum value for this property is 300 and the maximum value is 86340 seconds or 24 hours.

  This property can be updated.

• MaxSubscriptionPerUser
  Data type: uint32

  The maximum number of subscriptions allowed on the home server per user.

  The minimum value for this property is 10 and the maximum value is 3000. The default value is 200.

  This property can be updated.

• MinPresenceSubscriptionExpiry
  Data type: uint32

  The minimum expiry in seconds that a user agent client can request for a presence subscription. If the value requested by the client in the Expires header is less than this value, this value is returned in the response.

  The minimum value for this property is 300 and the maximum value is 86340. The default value is 1200 seconds, or 20 minutes.

  This property can be updated.

• MinRegistrationExpiry
  Data type: uint32

  The registration time-out in seconds that a user agent client can request. If the value requested by the client in the Expires header is less than this value, this value is returned in the response.

  The minimum value for this property is 300 and the maximum value is 900. The default value is 300 seconds, or 5 minutes.

  This property can be updated.

• MinRoamingDataSubscriptionExpiry
  Data type: uint32

  The minimum expiry in seconds that a user agent client can request for roaming data persistence with Live Communications User Services. If the value requested by the client in the Expires header is less than this value, this value is returned in the response.

  The minimum value for this property is 300 and the maximum value is 86340 seconds, or 24 hours. The default value is 900 seconds, or 15 minutes.

  This property can be updated.

• NumOfDevicesPerUser
  Data type: uint32

  The maximum number of endpoints that a registered user can have. If this property is set to 1, only single point-of-presence (SPOP) is available; if it is greater than 1, multiple points-of-presence (MPOP) are available.

  The minimum value for this property is 1 and the maximum value is 64. The default value is 8.

  This property can be updated.

• UserDomainList
  Data type: string []

  A list of distinguished names (DN) of domains that host Live Communications Server users. The user replicator replicates names from all the domains in the list. If the list is empty, the user replicator replicates names from all domains in the forest.

  The default is empty.

  This property can be updated.

Remarks

Only one instance of this class can be present in the forest.

For presence, subscription, and roaming values, the minimum value can be less than or equal to the default value, and the maximum value can be equal to or greater than the default value.

For PutInstance operations only the WBEM_FLAG_UPDATE_ONLY flag is supported

Available actions for an instance of this class:

• Creation: The administrator cannot create instances of this class.
• Updates: The administrator can update instances of this class.
• Deletion: The administrator cannot 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

Live Communications Server WMI Reference