Set-CsConversationHistoryConfiguration

Modifies the conversation history configuration settings for the organization. These settings manage conversation histories for mobile device users.

Syntax

Set-CsConversationHistoryConfiguration
   [[-Identity] <XdsIdentity>]
   [-Confirm]
   [-EnableServerConversationHistory <Boolean>]
   [-Force]
   [-MaxContinuedConversationRetry <UInt32>]
   [-WhatIf]
   [-EnableDisplayNameResolution <Boolean>]
   [<CommonParameters>]
Set-CsConversationHistoryConfiguration
   [-Confirm]
   [-EnableServerConversationHistory <Boolean>]
   [-Force]
   [-Instance <PSObject>]
   [-MaxContinuedConversationRetry <UInt32>]
   [-WhatIf]
   [-EnableDisplayNameResolution <Boolean>]
   [<CommonParameters>]

Description

Prior to the release of Skype for Business Server, conversation histories were stored exclusively in the Conversation History folder, written by the Skype for Business rich client. Unfortunately, that proved to be a problem for mobile device users, because the Conversation History folder is typically not replicated to mobile devices. With Skype for Business Server, however, conversation histories, missed call notifications, and missed IM notifications can now be stored on the server instead of in client mailboxes; this change makes these items readily available to mobile devices. That also means that administrators can manage the server-side storage of these conversation histories by using the conversation history configuration settings. Keep in mind that a single, global collection of these settings is used to manage conversation history throughout your deployment; there is no option for creating additional conversation history. However, the global settings can be modified by using the Set-CsConversationHistoryConfiguration cmdlet.

Examples

-------------------------- Example 1 --------------------------

Set-CsConversationHistoryConfiguration -Identity "global" -EnableServerConversationHistory $True

In Example 1, the EnableServerConversationHistory property is set to True ($True). In turn, conversation histories, missed call notifications, and missed IM notifications will be stored on the server rather than in client mailboxes.

-------------------------- Example 2 --------------------------

Set-CsConversationHistoryConfiguration -Identity "global" -CachedUserThreshold 2000000

The command shown in Example 2 modifies the global collection of conversation history configuration settings. (Each deployment is limited to a single, global collection of conversation history configuration settings.) In this example, the CachedUserThreshold property is set to 2000000.

Parameters

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-EnableDisplayNameResolution

PARAMVALUE: $true | $false

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-EnableServerConversationHistory

When set to True ($True), conversation histories and related information will be stored on the server. The default value is False, which means that this information is stored in user mailboxes.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-Force

Suppresses the display of any non-fatal error message that might occur when running the command.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-Identity

Unique Identity of the conversation history configuration settings being modified. Because you can only have a single, global instance of these settings, you do not need to specify an Identity when calling the Set-CsConversationHistoryConfiguration cmdlet. However, you can still use the following syntax to reference the global settings:

-Identity "global"

Type:XdsIdentity
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-Instance

Allows you to pass a reference to an object to the cmdlet rather than set individual parameter values.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-MaxContinuedConversationRetry

Specifies the maximum number of times the Skype for Business Server will search for a previous conversation item from Exchange to create a continued conversation. If the previous conversation is not found in the specified number of attempts, a new conversation is created. Increasing this value will present more continued conversations, but at the cost of decreased performance. This parameter should not be used except in situations where Exchange connections are known to be unreliable. The default value is 3.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Server 2015, Skype for Business Server 2019

Inputs

Set-CsConversationHistoryConfiguration accepts pipelined instances of the Microsoft.Rtc.Management.WritableConfig.Settings.ConversationHistory.ConversationHistorySettings object.

Outputs

None. Instead, Set-CsConversationHistoryConfiguration modifies instances of the Microsoft.Rtc.Management.WritableConfig.Settings.ConversationHistory.ConversationHistorySettings object.