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
Log on to the server running the Address Book service as a member of the RTCUniversalServerAdmins group or an account with equivalent user rights.
Click Start, and then click Run.
In the Open box, type wbemtest.
In the Windows Management Instrumentation Tester dialog box, click Connect.
In the Connect dialog box, type root\cimv2 in the Namespace box.
Click Connect.
Click Open Instance.
In the Get Object Path box, type MSFT_SIPAddressBookSetting, and then click OK.
In the Object Editor for MSFT_SIPAddressBookSetting dialog box, click Instances.
Double-click MSFT_SIPAddressBookSetting=@.
Edit the properties that you want to modify.
Close the Windows Management Instrumentation Tester dialog box.
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