Share via


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:

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