Migrating User Settings to Lync Server 2010

 

Topic Last Modified: 2012-08-17

This topic provides the information you need to successfully migrate user and client settings from Microsoft Office Communications Server 2007 R2 to Lync Server 2010.

In Microsoft 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 required for client bootstrapping

• Obsolete or superseded Office Communicator 2007 R2 group policies

• Lync Server 2010 in-band provisioning setting and Windows PowerShell command-line interface cmdlet equivalents for Office Communicator 2007 R2 Group Policy settings

• Selected new Lync Server 2010 user and client settings

Group Policy Settings for Client Bootstrapping

Because Office Communicator 2007 R2 client bootstrapping policies are also used by 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 Policies Needed for Client Bootstrapping

Group Policy setting	Description
ConfigurationMode	Specify how Microsoft 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 Microsoft Lync Server 2010 will log on to, in addition to the server versions that are supported by default.
DisableHttpConnect	During sign-in, Lync 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	This policy 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 Windows .NET or Microsoft Exchange Server services. If you do not configure this policy setting, Lync can use any transport. But if it does not use TLS and if the server authenticates users, Lync must use either NTLM or Kerberos authentication.
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	Turn on tracing for Lync, primarily for use to assist customer problem solving.
FirstRunLaunchMode	This policy 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 R2 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
AutoDiscoveryRetryInterval	None	Set-CsClientPolicy
DisablePC2PCVideo	EnableP2PVideo	Set-CsConferencingPolicy
DisableRCCForwarding	AllowCallForwarding	Set-CsVoicePolicy
EnableUPNP	ucEnableSipSecurityMode
MaxAudioVideoBitRate	AudioBitRate VideoBitRate 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 Communications Server 2007 R2 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 Communications Server 2007 R2 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 Communications Server 2007 R2 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.
EnableFullScreenVideoPreviewDisabled	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 then full screen video is not available in Lync 2010, but video preview is available.
IMAutoArchivingPolicy	EnableIMAutoArchiving	Enables/disables automatic archiving of IM conversations to Outlook mailbox.
MusicOnHoldAudioFile	MusicOnHoldAudioFile	Enables/disables ability for the user to specify the Music On Hold file.
MusicOnHoldDisabled	EnableClientMusicOnHold	Enables/disables Music On Hold. Note that the corresponding Group Policy setting is DisableClientMusicOnHold. These settings also apply to Microsoft Lync 2010 Attendant.
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.
PC2PCASEncryption	P2PAppSharingEncryption	Enables or disables application sharing encryption in peer-to-peer (two users) conversations.
PlayAbbrDialTone	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 "regular" 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.
SafeTransfer	AttendantSafeTransfer	Attendant - Safe Transfer

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
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 (does not include contact who use public IM connectivity).
DisableFreeBusyInfo	Disables publishing free/busy information.
DisableHandsetOnLockedMachine	Configures handset use on locked computer.
DisableHTMLIM	Prevents HTML text in instant messages.
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, that 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 the new policies that 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.
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.
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.
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, who 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.
EnableHotdesking	When enabled, a user can log on to a Lync 2010 Phone Edition phone in a shared workspace 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.
PhotoUsage	Enables or disables display of photos.
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 New-CsClientPolicy or Set-CsClientPolicy. Many of these settings correspond to Communications Server 2007 R2 Group Policy settings and have been renamed in Lync Server 2010.

Communications Server 2007 R2 Group Policy Equivalents

Office Communications Server 2007 R2 Group Policy setting	Lync Server 2010 in-band provisioning setting	Windows PowerShell cmdlet	Cmdlet parameters
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)	--
IMWarning	IMWarning	CsIMFilterConfiguration	WarnMessage
MRASServerURI	mrasURI	None	None
PC2PCAVEncryption	ucPC2PCAVEncryption	CsMediaConfiguration	EncryptionLevel
msRTCLine	line	CsUser	LineURI
TelephonyMode	TelephonyMode	CsUser	EnterpriseVoiceEnabled, RemoteCallControlTelephonyEnabled
ExUMEnabled	ExUMEnabled	CsUser	MCSVoiceMail
DisableSimultaneousRinging	AllowSimultaneousRinging	CsVoicePolicy	AllowSimulRing
VoicemailURI	VoicemailURI	None	None