Remove-CsConversationHistoryConfiguration

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

Syntax

Remove-CsConversationHistoryConfiguration
      [-Identity] <XdsIdentity>
      [-Confirm]
      [-Force]
      [-WhatIf]
      [<CommonParameters>]

Description

Prior to the release of Skype for Business Server, conversation histories were stored in the Conversation History folder in users's mailbox, 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 be stored on the server in user mailboxes; this change makes these items readily available to mobile devices. Administrators can manage the server-side storage of these conversation histories by using the conversation history configuration settings. Just keep in mind that a single, global collection of these settings is used to manage conversation histories throughout your deployment. There is no option for creating additional conversation history settings at the site, service, or per-user scope.

Despite the name, the Remove-CsConversationHistoryConfiguration cmdlet does not actually delete the global collection of settings; that's because the global collection cannot be deleted. Instead, the Remove-CsConversationHistoryConfiguration cmdlet resets all the properties in the global collection to their default values. For example, when you install Skype for Business Server the CachedUserThreshold property is set to 1000000. Suppose you change this value to 500000. If you run the Remove-CsConversationHistoryConfiguration cmdlet then CachedUserThreshold will revert back to its default value of 1000000.

Examples

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

Remove-CsConversationHistoryConfiguration -Identity "global"

The command shown in Example 1 resets all the properties in the global collection of conversation history configuration settings to their default values.

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

-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 identifier for the conversation history configuration settings to be deleted. Because there is only a single, global collection of settings per deployment, the only allowed syntax is the following:

-Identity "global"

Type:XdsIdentity
Position:2
Default value:None
Required:True
Accept pipeline input:True
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

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

Outputs

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