A presence policy is a set of limits and restrictions that affect presence. By default, the Default Policyand Service: Mediumpresence policies are installed when you deploy Office Communications Server 2007 R2. You can create additional presence policies or modify the settings of an existing presence policy.

Note:
We recommend that you not modify the settings on the Default Policyand Service: Mediumpresence policies.

Using ConfigurePolicies.wsf

The Microsoft Office Communications Server 2007 R2 Configure Global Policies script (ConfigurePolicies.wsf) is a Windows Management Instrumentation (WMI) script that is used to add, update, assign, and delete policies. ConfigurePolicies.wsf can be downloaded from the Microsoft Script Center at http://go.microsoft.com/fwlink/?LinkId=139853 .

You must be a member of the RTCUniversalServerAdmins group in order to run the ConfigurePolicies.wsf script. The script can be run from any computer that has Office Communications Server 2007 R2 or the Office Communications Server 2007 R2 administrative tools installed.

Syntax

Copy Code
cscript ConfigurePolicies.wsf /Action:<value>
[/PolicyType:<value>] [/DataFile:<value>]
[/PolicyName:<value>]

The following table describes the available options.

Table 1. Command-Line Options

Option Description

Action

The action to take. Valid values are AddUpdate, Assign, UseUserPolicy, or Delete.

PolicyType

The policy type. Valid values are Presence, Meeting, or OC.

DataFile

The name of the file that contains the policy settings. This option is used with the AddUpdateaction.

PolicyName

The name of the policy. This option is used with the Assignor Deleteaction.

Creating, Updating, and Deleting Policies

You can create additional presence policies, modify the settings of an existing presence policy, or delete a presence policy. The AddUpdateaction creates a new policy or replaces an existing policy with the policy properties and settings included in the specified data file.

Note:
For details about presence policy settings, see Presence Policy Settings.

The data file used in the /DataFileoption must be in ANSI or Unicode format and have the following format:

PropertyName:=PropertyValue

The following is an example of a data file:

Name:=Presence Policy 1

CategorySubscriptions:=2000

DefaultPolicy:=False

PromptedSubscribers:=200

Type:=presence

Using the data file from above, the following example creates a new presence policy called Presence Policy 1. If you already have a presence policy called Presence Policy 1, the same command updates that policy.

Copy Code
cscript ConfigurePolicies.wsf /Action:AddUpdate
/PolicyType:Presence /DataFile:PresencePolicy1.txt

The following example deletes the presence policy called Presence Policy 1.

Copy Code
cscript ConfigurePolicies.wsf /Action:Delete /PolicyType:Presence
/PolicyName:”Presence Policy 1”

Choosing Between Global or Per-User Policy Modes

There are two ways to configure policies at the global level. You can choose the global policy mode, which assigns the same policy to all users. Or, you can use the per-user policy mode. With the per-user policy mode, you can assign a policy that is assigned to users by default, but you still have the option to assign a different policy to one or more users.

Using Global Policy Mode

You can use the Assignaction to specify which presence policy to use as the global policy. The following example specifies the Default Policypresence policy as the global policy.

Copy Code
cscript ConfigurePolicies.wsf /Action:Assign /PolicyType:Presence
/PolicyName:”Default Policy”

Using Per-User Policy Mode

Use the per-user policy mode if you want to be able to assign a different presence policy to specific users. The following example enables per-user policy. Users are assigned the Default Policypresence policy by default.

Copy Code
cscript ConfigurePolicies.wsf /Action:UseUserPolicy
/PolicyType:Presence /PolicyName:”Default Policy”

You can now assign a different presence policy to specific users. This is performed using the LCSEnableConfigureUsers.wsf script. The LCSEnableConfigureUsers.wsf script has the following syntax.

Copy Code
cscript LCSEnableConfigureUsers.wsf /UsersFile:<value>
/ConfigFile:<value>
Note:
The LCSEnableConfigureUsers.wsf and OCSGetTemplateFromUser.wsf scripts can be downloaded from the Microsoft Script Center at http://go.microsoft.com/fwlink/?LinkId=139853 .

To assign a policy to a user or a group of users

  1. Create the users file.

    The users file is a text file that contains a list of the SIP URI address of the users that you want to modify. The following is an example of a users file.

    Copy Code
    sip:user2@contoso.com
    sip:user3@contoso.com
    
  2. Create the configuration settings file.

    The configuration settings file is a text file that contains the settings that will be assigned to the list of users. The following is an example of a configuration settings file.

    Copy Code
    AllowOrganizeMeetingWithAnonymousParticipants:=False
    ArchiveFederatedCommunications:=False
    ArchiveInternalCommunications:=False
    Enabled:=True
    EnabledForEnhancedPresence:=True
    EnabledForFederation:=False
    EnabledForInternetAccess:=False
    PoolName:=SERVER
    IPPBXSoftPhoneRoutingEnabled:=False
    PresencePolicy:=Presence Policy 1
    PublicNetworkEnabled:=False
    RemoteCallControlTelephonyEnabled:=False
    UCEnabled:=True
    
    Note:
    You can use the OCSGetTemplateFromUser.wsf script to create a template settings file: cscript OCSGetTemplateFromUser.wsf /sipuri:user1@contoso.com >>ConfigSettings.txt. This creates a file that contains the configuration settings of user1. You can then modify the settings in the file as needed.
  3. Run the LCSEnableConfigureUsers.wsf script to assign a policy to the users.

See Also