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.