• Article

Using WMI to Configure Address Book Server Settings

Microsoft Office Communications Server 2007 and Microsoft Office Communications Server 2007 R2 will reach end of support on January 9, 2018. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

Using WMI (Windows Management Instrumentation) to configure Address Book Server settings includes the following:

  • Configuring Address Book Server WMI Settings

  • Modifying WMI Settings Using Windows Management Instrumentation Tester (wbemtest)

  • Modifying WMI Settings Using VBScript

The following sections describe the WMI classes and how to use WMI to change settings.

Configuring Address Book Server WMI Settings

Address Book Server local WMI settings are stored as properties in the MSFT_SIPAddressBookSetting WMI class in the root\CIMV2 namespace. Table 5 describes these properties.

Table 5. WMI Properties

Property Name Type Default Value Description

MaxDeltaFileSizePercentage

Integer

1250

Delta file is not created if percent change is greater than this number.

OutputLocation

String

None

File location, a valid folder.

RunTime

Integer

(0 to 2359)

130

Service start time.

SynchronizedPollingIntervalSecs

Integer

300

Number of seconds between checks for synchronization.

UseNormalizationRules

Boolean

True

Flag to perform normalization or not.

PartitionOutputByOU

Boolean

False

Flag to partition data by organizational unit (OU).

IgnoreGenericRules

Boolean

False

Flag that determines whether or not to use the built-in generic rules.

The static Address Book Server settings that are compile-time constants in the code are as follows:

  • Output file extension = .lsabs

  • NumberOfDaysToKeep = 30

Modifying WMI Settings Using Windows Management Instrumentation Tester (wbemtest)

You can use Windows Management Instrumentation Tester (wbemtest), which ships with the Windows 2000 Server and Windows Server 2003 operating systems, to modify WMI settings for the Address Book Server.

To use wbemtest to modify WMI settings

  1. Log on to the server running the Address Book service as a member of the RTCUniversalServerAdmins group or an account with equivalent user rights.

  2. Click Start, and then click Run.

  3. In the Open box, type wbemtest.

  4. In the Windows Management Instrumentation Tester dialog box, click Connect.

  5. In the Connect dialog box, type root\cimv2 in the Namespace box.

    27e7feec-ae94-4768-a4b8-31d5ec539898

  6. Click Connect.

  7. Click Open Instance.

  8. In the Get Object Path box, type MSFT_SIPAddressBookSetting, and then click OK.

  9. In the Object Editor for MSFT_SIPAddressBookSetting dialog box, click Instances.

  10. Double-click MSFT_SIPAddressBookSetting=@.

  11. Edit the properties that you want to modify.

  12. Close the Windows Management Instrumentation Tester dialog box.

  13. To verify that the change applied, open Event Viewer, and then look for Office Communications Server event ID 21057.

Modifying WMI Settings Using VBScript

You can use the following sample script written in the Microsoft Visual Basic® Scripting Edition (VBScript) language to modify the WMI settings that you want to change.

Sub CommitChange

  Dim objLocator
  Dim objService
  Dim objInstances
  Dim objInstance

  Wscript.Echo "Connecting to local WMI store..."

  Set objLocator = CreateObject("WbemScripting.SWbemLocator")
  Set objService = objLocator.ConnectServer(".", "root\cimv2")

  Wscript.Echo "select * from MSFT_SIPAddressBookSetting"
  Set objInstances = objService.ExecQuery("select * from MSFT_SIPAddressBookSetting")

  If IsNull(objInstances) Or (objInstances.Count = 0) Then
    Wscript.Echo "Error: No instance"

  Else

    For Each objInstance in objInstances

      objInstance.Properties_.Item("MaxDeltaFileSizePercentage").Value = 1500
      objInstance.Properties_.Item("RunTime").Value = 200
      objInstance.Properties_.Item("OutputLocation").Value = \\server\ABServer"
      objInstance.Properties_.Item("SynchronizePollingIntervalSecs").Value = 500
      objInstance.Properties_.Item("UseNormalizationRules").Value = "True"
      objInstance.Put_
      wscript.Echo "Done"
    Exit For
    Next

  End If

  Wscript.Echo ""
End Sub