Topic Last Modified: 2011-05-13
This topic provides the information you need to successfully migrate user and client settings from Microsoft Office Communications Server 2007 to Microsoft Lync Server 2010.
In Lync Server 2010, most of the group policy settings used in previous versions of Office Communications Server are now controlled by server-based, or in-band provisioning, client policies. In addition, certain Group Policy settings are used for client bootstrapping.
This topic contains information about the following settings:
- Group Policy settings used for client bootstrapping
- Obsolete or superseded Microsoft Office Communicator 2007 group
policies
- Lync Server 2010 in-band provisioning setting and Windows
PowerShell cmdlet equivalents for Office Communicator 2007 Group
Policy settings
- Selected new Lync Server 2010 user and client settings
Group Policy Settings for Client Bootstrapping
Because Office Communicator 2007 client bootstrapping policies are also used by Microsoft Lync 2010, it is only necessary to configure them if you want to change existing policies or if you want to set new policies. If you do not plan to configure client bootstrapping policies, or you want legacy client bootstrapping policies to remain in effect, no action is necessary.
Group Policy Settings for Client Bootstrapping
Group Policy setting | Description |
---|---|
ConfigurationMode |
Specifies how Lync 2010 identifies the transport and server to use during sign in. If you enable this policy setting, you must specify ServerAddressInternal, ServerAddressExternal, and Transport. |
ConfigurationMode\ServerAddressExternal |
If you enable ConfigurationMode, you must configure this setting, which specifies the server name used by clients and federated contacts when connecting from outside the external firewall. |
ConfigurationMode\ServerAddressInternal |
If you enable ConfigurationMode, you must configure this setting, which specifies the server name used when clients connect from inside the organization’s firewall. |
ConfigurationMode\Transport |
If you enable ConfigurationMode, you must specify Transport Layer Security (TLS). Transmission Control Protocol (TCP) is no longer supported. |
ConfiguredServerCheckValues |
Specifies a list of server version names separated by semi-colons that Lync Server 2010 will log on to, in addition to the server versions that are supported by default. |
DisableHttpConnect |
During sign in, Lync Server 2010 attempts to connect to the server using TLS. If the attempt is not successful, Lync tries to connect using HTTP. Use this policy to disable the fallback HTTP connection attempt. |
DisableNTCredentials |
Requires the user to provide logon credentials for Lync rather than automatically using the Windows credentials during sign in to a Session Initiation Protocol (SIP) server. |
DisableServerCheck |
By default, Lync checks the server name and version before signing in. Set this policy to 1 in order to bypass the server version check. |
EnableBitsForGalDownload |
Allows Lync 2010 to use Background Intelligent Transfer Service (BITS) to download the Address Book services files. |
EnableSIPHighSecurityMode |
Enables Lync to send and receive instant messages more securely.
This policy has no effect on Microsoft .NET Framework or Microsoft
Exchange Server services. |
EnableStrictDNSNaming |
When set to False, allows Lync to automatically detect and more securely communicate with SIP servers that have non-standard fully qualified domain names (FQDNs). |
EnableTracing |
Turns on tracing for Lync, primarily for use to assist customer problem solving. |
FirstRunLaunchMode |
Defines the behavior of the Lync First Run user experience. This setting determines whether the First Run is enabled, and whether it runs automatically. |
HelpMenuText |
Specifies the text to display to the user in the Help menu for the Help website. |
HelpMenuURL |
Specifies which website to open when the user selects the Help menu text item in the Help menu. Both HelpMenuText and HelpMenuURL need to be specified in order for the Help menu item to appear in Lync. |
PreventRun |
Prevents users from running Lync. You can configure this policy setting under both Computer Configuration and User Configuration, but the policy setting under Computer Configuration takes precedence. |
SavePassword |
Enables Lync to store passwords. |
SipCompression |
Defines when to turn on SIP compression. By default, SIP compression is enabled based on adapter speed. Note that setting this policy might cause an increase in sign-in time. |
Obsolete Group Policies
The following table lists the Office Communicator 2007 Group Policy settings that are either obsolete or superseded in Lync Server 2010.
Obsolete Group Policies
Obsolete Group Policy | Lync Server 2010 in-band provisioning setting | Windows PowerShell cmdlet |
---|---|---|
AbsUseFallback |
None |
|
DisablePC2PCVideo |
EnableP2PVideo |
Set-CsConferencingPolicy |
EnableUPNP |
ucEnableSipSecurityMode |
|
MaxAudioVideoBitRate |
AudioBitRate ucMaxVideoRateAllowed |
Set-CsConferencingPolicy Set-CsMediaConfiguration |
Configuring Clients by Using Windows PowerShell
In Lync Server 2010, client policies, except for those required for bootstrapping, are configured by using Windows PowerShell cmdlets or the Lync Server Control Panel. This section summarizes the Windows PowerShell cmdlets and parameters which correspond to Office Communicator 2007 Group Policy settings.
CsClientPolicy
The majority of Group Policy settings from previous versions of Office Communications Server can be configured by using the Windows PowerShell cmdlets New-CsClientPolicy or Set-CsClientPolicy. For details, see the Lync Server Management Shell documentation.
Most CsClientPolicy parameters have the same name as the equivalent Office Communicator 2007 Group Policy. This overview section summarizes the renamed, unchanged, and new policies that can be set by using CsClientPolicy.
Policies Renamed in Lync Server 2010
Office Communicator 2007 Group Policy | Lync Server 2010 in-band provisioning setting / CsClientPolicy parameter | Description |
---|---|---|
AllowUnencryptedFileTransfer |
EnableUnencryptedFileTransfer |
When set to True, users will be allowed to exchange files with external users whose instant messaging software does not support encrypted file transfers. When set to False, users will only be able to exchange files with external users who have software that supports encrypted file transfers. |
CallLogAutoArchivingPolicy |
EnableCallLogAutoArchiving |
Enables/disables automatic archiving of call logs to Microsoft Outlook mailbox. |
DGRefreshPeriod |
DGRefreshInterval |
Indicates the amount of time Lync 2010 waits before automatically refreshing the membership list of any distribution group that has been "expanded" in the Contacts list. (Expanding a distribution group means displaying all the members in that group.) DGRefreshInterval can be set to any integer value between 30 seconds and 28,800 seconds (8 hours), inclusive. The default value is 28,800 seconds. |
IMAutoArchivingPolicy |
EnableIMAutoArchiving |
Enables/disables automatic archiving of IM conversations to the Microsoft Outlook mailbox. |
NotificationsForNewSubscribers |
EnableNotificationForNewSubscribers |
When set to True, any time you are added to someone’s Contacts list, you will receive notification that you have been added to the list. In addition, the notification dialog box will provide options for you to add this person to your Contacts list, or to block them from viewing your presence information. When set to False, you will not be notified if you are added to someone’s Contacts list. |
The following table summarizes the unchanged policies that can be set by using CsClientPolicy.
Unchanged Client Policy Names
Lync Server 2010 in-band provisioning setting / CsClientPolicy parameter | Description |
---|---|
AutoDiscoveryRetryInterval |
After a failed connection attempt, specifies the amount of time Lync 2010 waits before trying again to connect to Lync Server. The AutoDiscoveryRetryInterval can be set to any integer value between 1 second and 60 minutes, inclusive. The default value is 30 minutes. |
BlockConversationFromFederatedContacts |
Blocks conversation from federated contacts. |
CalendarStatePublicationInterval |
Sets time interval to publish calendar data to presence. |
CustomStateURL |
Sets custom presence states URL. |
DisableCalendarPresence |
Disables calendar presence. |
DisableEmailComparisonCheck |
Disables email comparison check for Outlook public IM connectivity integration. |
DisableEmoticons |
Disables emoticons in instant messages. |
DisableFederatedPromptDisplayName |
Prevents showing the display name of federated contacts in the notification dialog box (does not include contacts who use public IM connectivity). |
DisableFreeBusyInfo |
Disables publishing free/busy information. |
DisableHandsetOnLockedMachine |
Configures handset use on locked computer. |
DisableInkIM |
Prevents Ink in instant messages. |
DisableMeetingSubjectAndLocation |
Disables publishing meeting subject and location information. |
DisableOneNote12Integration |
Disables Microsoft OneNote integration. |
DisableOnlineContextualSearch |
Disables online contextual search. |
DisablePhonePresence |
Disables call presence. |
DisablePICPromptDisplayName |
Prevents showing the display name of public IM connectivity contacts in the notification dialog box. |
DisablePresenceNote |
Disables presence note. |
DisableRTFIM |
Prevents rich text in instant messages. |
DisableSavingIM |
Prevents users from saving instant messages. |
EnableAppearOffline |
Enables the state Appear Offline. |
EnableEventLogging |
Turns on event logging for Lync 2010. |
EnableSQMData |
Specifies instrumentation. |
EnableTracing |
Turns on tracing for Lync 2010. |
EnableURL |
Allows hyperlinks in instant messages. |
MAPIPollInterval |
Specifies how often Lync 2010 retrieves MAPI data from the Exchange public folders. MAPIPollInterval can be set to any integer value between 5 minutes and 480 minutes (8 hours); inclusive. The default value is 30 minutes. |
MaximumNumberOfContacts |
Indicates the maximum number of contacts a user is allowed to have. The maximum contacts can be set to any integer value between 0 and 1000, inclusive. When set to 0, prevents the user from having any contacts. |
WebServicePollInterval |
For users of Microsoft Exchange Server 2007 or Microsoft Exchange Server 2010, WebServicePollInterval specifies how often Lync 2010 retrieves data from Exchange Web Services. WebServicePollInterval can be set to any integer value between 5 minutes and 480 minutes (8 hours); inclusive. The default value is 30 minutes. |
The following table summarizes new policies that were unavailable in Office Communications Server 2007. These policies can be set by using CsClientPolicy.
New Lync Server 2010 Client Policies
Lync Server 2010 in-band provisioning setting / CsClientPolicy parameter | Description |
---|---|
AbsUsage (in-band) / AddressBookAvailability (Windows PowerShell) |
Can be set to download the Address Book only, use Address Book web search only, or use both. |
AttendantSafeTransfer |
Enables Microsoft Lync 2010 Attendant to operate in "safe transfer" mode; this means that transferred calls that do not reach the intended recipient will reappear in the incoming area along with a "Failed Transfer" notice. |
ConferenceIMIdleTimeout |
Indicates the number of minutes that a user can remain in an instant messaging session without either sending or receiving an instant message. |
CustomizedHelpURL |
Replaces the default Lync 2010 help link with the location of your organization-specific Help. Use in conjunction with EnableEnterpriseCustomizedHelp. |
CustomLinkInErrorMessages |
URL for a website that can be added to error messages in Lync 2010. |
DisableContactCardOrganizationTab |
Enables or disables the contact card organization tab. |
DisableFeedsTab |
Enables or disables the activity feeds tab. |
DisableHTMLIM |
Prevents HTML text in instant messages. |
DisablePoorDeviceWarnings |
Disables device warnings that appear whenever a faulty or obsolete device is detected. |
DisablePoorNetworkWarnings |
Disables network quality warnings that may appear during a conversation. |
DisplayPhoto |
Determines whether or not photos (of both the user and his or her contacts) are displayed. |
DisplayPublishedPhotoDefault |
Sets the default for display of other contacts’ published photos. Can be overridden by users. |
EnableClientMusicOnHold |
Enables music to be played any time a caller is placed on hold. This setting also applies to Lync 2010 Attendant |
EnableDelegation |
Enables the call delegation. See also EnableExchangeDelegationSync in this table. |
EnableDiagnosticsLogsCollection |
Enables or disables the Collect Logs button, which is used to collect logs for the investigation of audio, video, or connectivity issues. This feature allows the user to capture the necessary logs and metrics and compress them into a .cab file. The user then manually uploads logs per the administrator’s instructions. The administrator then sends the logs to Microsoft for troubleshooting purposes. |
EnableEnterpriseCustomizedHelp |
Allows you to replace the default Lync 2010 Help link with the location of your organization-specific Help. Use in conjunction with CustomizedHelpURL. |
EnableExchangeContactSync |
When enabled, Lync 2010 creates a corresponding personal contact in Microsoft Outlook for each person on a user’s Contacts list. |
EnableExchangeDelegateSync |
When enabled, the client retrieves the Exchange calendar delegates (users who have authoring and editing rights on the manager’s calendar), and uses these settings to update delegates in Lync Server 2010. Use this setting in conjunction with the EnableDelegation setting, which is configurable in the CsVoicePolicy cmdlets or in Lync Server Control Panel. |
EnableFullScreenVideo |
When set to True, this parameter does two things: 1) enables full-screen video (with the correct aspect ratio) for Lync 2010 calls; and, 2) disables video preview for Lync 2010 calls. When set to False, full-screen video is not available in Lync 2010, but video preview is available. |
EnableHotdesking |
When enabled, a user can log on to a phone running Lync 2010 Phone Edition in a shared workspace by using his or her Lync Server 2010 account. |
EnableVOIPCallDefault |
When enabled, a Lync 2010 call is placed any time a user employs the click-to-call feature. |
ExcludedContactFolders |
Indicates which Microsoft Outlook contact folders (if any) should not be searched any time Lync 2010 searches for new contacts. |
HotdeskingTimeout |
Timeout interval for a user logged on to a hot-desk phone. |
MaximumDGsAllowedInContactList |
Indicates the maximum number of distribution groups that a user can configure as a contact. |
MaxPhotoSizeKB |
Set this policy to 0 to remove photos from Lync 2010 and disable the photo user interface. Default: 10. |
MusicOnHoldAudioFile |
Path to the audio file to be played when a caller is placed on hold. If a value is configured for this property then music on hold will be enabled and users will not be allowed to disable the feature. If no value is configured for this property, then users can specify their own music-on-hold file, assuming that EnableClientMusicOnHold is set to True. |
P2PAppSharingEncryption |
Indicates whether or not desktop and application sharing data exchanged during a peer-to-peer conversation is encrypted. |
PhotoUsage |
Enables or disables display of photos. |
PlayAbbreviatedDialTone |
When set to True, a 3-second dial tone will be played any time a Lync 2010-compatible handset is taken off the hook. (A Lync 2010 handset looks like a standard telephone, but plugs into a USB port on your computer and is used to make Lync 2010 calls rather than ordinary phone calls.) When set to True, a 30-second dial tone is played any time a Lync 2010-compatible handset is taken off the hook. |
PolicyEntry |
Provides a way to add settings not covered by the default parameters. |
SearchPrefixFlags |
Represents the Address Book attributes that should be searched any time a user searches for a new contact. |
ShowManagePrivacyRelationships |
Enables or disables the Manage Privacy Relationships option in the View by menu. |
ShowRecentContacts |
Shows or hides the Recent Contacts option in the Display Options menu. |
ShowSharepointPhotoEditLink |
Controls whether users see the Edit in Mysite selection in their My Picture options. Edit in Mysite allows users to show a picture from Microsoft SharePoint MySite. |
SPSearchCenterExternalURL |
External URL for the SharePoint site used for keyword searches (also known as expert searches). This URL will appear at the bottom any of keyword search results that appear in Lync 2010. If the user clicks this URL, his or her web browser will open up to the SharePoint site, giving the user the opportunity to conduct searches using SharePoint’s search capabilities. |
SPSearchCenterInternalURL |
Internal URL for the SharePoint site used for keyword searches (also known as expert searches). This URL will appear at the bottom any of keyword search results that appear in Lync 2010. If the user clicks this URL, his or her web browser will open up to the SharePoint site, giving the user the opportunity to conduct searches using SharePoint’s search capabilities. |
SPSearchExternalURL |
Internal URL for the SharePoint site used for keyword searches (also known as expert searches). Lync 2010 will use the SharePoint site located at this URL any time an external user (that is, a user who has access the system from outside the organization’s firewall) conducts a keyword search. |
SPSearchInternalURL |
Lync 2010 will use the SharePoint site located at this URL any time an internal user (that is, a user who has logged on from inside the organization’s firewall) conducts a keyword search. |
For details, see the following topics:
- Set-CsClientPolicy
in the Lync Server Management Shell documentation
- Overview of
Client Policies and Settings
- Lync 2010
New Features
Additional Client Policies
The following table lists the Lync Server 2010 in-band provisioning settings and Windows PowerShell cmdlets that are either not configurable through Windows PowerShell or configured by using a Windows PowerShell cmdlet other than CsClientPolicy. Most of these settings correspond to Office Communications Server 2007 Group Policy settings that have been renamed in Lync Server 2010.
Additional New or Renamed Client Policies
Office Communications Server 2007 Group Policy setting | Lync Server 2010 in-band provisioning setting | Windows PowerShell cmdlet | Cmdlet parameters |
---|---|---|---|
(New in Lync Server 2010) |
AllowCallForwarding |
Set-CsVoicePolicy |
AllowCallForwarding |
AbsInsideURL |
AbsInternalServerUrl |
None |
None |
AbsOutsideURL |
AbsExternalServerUrl |
None |
None |
Portrange\MaxMediaPort |
ucMaxMediaPort |
CsConferencingConfiguration |
ClientMediaPortRange (indicates the total number of ports available for client media; default is 40) |
Portrange\MinMediaPort |
ucMinMediaPort |
CsConferencingConfiguration |
ClientMediaPort (represents the starting port number to use for client media) |
Portrange\Enabled |
ucPortRangeEnabled |
CsConferencingConfiguration |
ClientMediaPortRangeEnabled |
DisableApplicationSharingControl |
AllowParticipantControl |
CsConferencingPolicy |
AllowExternalUserControl |
DisableDataConferencing |
EnableDataCollaboration |
CsConferencingPolicy |
EnableDataCollaboration |
DisableAVConferencing |
AllowIPAudio, AllowIPVideo |
CsConferencingPolicy; CsUser |
AllowIPAudio, AllowIPVideo; AudioVideoDisabled |
DisableFileTransfer |
AllowFileTransfer |
CsFileTransferFilterConfiguration (Lync 2010) CsConferencingPolicy (Web conferencing) |
CsFileTransferFilterConfiguration parameter is Enable. CsConferencingPolicy parameter is EnableFileTransfer |
IMWarning |
IMWarning |
CsIMFilterConfiguration |
WarnMessage |
MRASServerURI |
mrasURI |
None |
None |
PC2PCAVEncryption |
ucPC2PCAVEncryption |
CsMediaConfiguration |
EncryptionLevel |
msRTCLine |
line |
CsUser |
LineURI |
TelephonyMode |
TelephonyMode |
CsUser |
UCEnabled, RemoteCallControlTelephonyEnabled |
ExUMEnabled |
ExUMEnabled |
CsUser |
MCSVoiceMail |
DisableSimultaneousRinging |
AllowSimultaneousRinging |
CsVoicePolicy |
AllowSimulRing |
VoicemailURI |
VoicemailURI |
None |
None |