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. |
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
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 |