Remove-CsArchivingConfiguration
Removes the specified collection of archiving settings. Archiving settings are used to enable or disable the automatic saving of instant messaging (IM) sessions and to optionally block any instant message that cannot be archived. This cmdlet was introduced in Lync Server 2010.
Syntax
Remove-CsArchivingConfiguration
[-Identity] <XdsIdentity>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Many organizations find it useful to keep a transcript of all the IM sessions and conferences their users participate in. For other organizations, it's mandatory to keep such transcripts; for example, many organizations in the financial world are required by law to keep copies of all their electronic communications.
Skype for Business Server gives you flexibility when it comes to archiving IM and web conferencing sessions. If you have deployed Archiving Server, you can use the various CsArchivingConfiguration cmdlets to enable and disable IM session archiving and to manage your archiving database. You can also suspend IM should archiving fail; this helps to ensure that you keep a record of all your electronic communications.
When you install Skype for Business Server, a collection of global archiving settings will be created for you; by default, these settings will apply to your entire organization.
Alternatively, you can use the New-CsArchivingConfiguration cmdlet to create custom configuration settings on a site-by-site basis.
Any site-specific settings created using the New-CsArchivingConfiguration cmdlet can later be removed by using the Remove-CsArchivingConfiguration cmdlet.
When you remove the settings for a site, the affected site will then be governed by the global settings.
Note that you can also run the Remove-CsArchivingConfiguration cmdlet against the global archiving settings.
In that case, however, the settings will not be removed; that's because you cannot delete the global settings.
Instead, all the global properties will be reset to their default values.
For example, suppose you have enabled IM session archiving at the global scope; sometime later, you run this command:
Remove-CsArchivingConfiguration -Identity global
Running that command will reset the property values for the global settings; that means that EnableArchiving will revert to its default value of None. In turn, that will disable archiving at the global scope.
Examples
-------------------------- Example 1 --------------------------
Remove-CsArchivingConfiguration -Identity site:RedmondExample 1 uses the Remove-CsArchivingConfiguration cmdlet to delete the archiving configuration settings with the identity site:Redmond.
-------------------------- Example 2 --------------------------
Get-CsArchivingConfiguration -Filter "site:*" | Remove-CsArchivingConfigurationThe command shown in Example 2 removes all of the archiving configuration settings that have been configured at the site scope.
To do this, the command first uses the Get-CsArchivingConfiguration cmdlet and the Filter parameter to return a collection of all of the settings configured at the site scope.
This is done by using the filter value "site:*", which limits the returned data to settings that have an Identity that begins with the characters "site:".
The filtered collection is then piped to the Remove-CsArchivingConfiguration cmdlet, which deletes each item in that collection.
-------------------------- Example 3 --------------------------
Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -eq "None"} | Remove-CsArchivingConfigurationExample 3 deletes all the archiving configuration settings where the EnableArchiving property has been set to "None".
To carry out this task, the Get-CsArchivingConfiguration cmdlet is called without any parameters in order to return a collection of all the archiving settings configured for use in the organization.
This collection is then piped to the Where-Object cmdlet, which picks out only those settings where the EnableArchiving property is equal to "None".
The filtered collection is then piped to the Remove-CsArchivingConfiguration cmdlet, which deletes each item in the collection.
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: | Lync Server 2010, Lync Server 2013, 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: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
-Identity
Unique identifier for the collection of archiving configuration settings to be removed.
To remove the global collection, use the following syntax: -Identity global.
(Note that you cannot actually remove the global settings; instead, you can only reset the properties to their default values.) To remove a site collection, use syntax similar to this: -Identity site:Redmond.
To remove settings configured for an individual Registrar pool syntax like this:
-Identity "service:Registrar:atl-cs-001.litwareinc.com"
Note that pool-level settings are available only in Skype for Business Server.
You cannot use wildcards when specifying a policy Identity.
| Type: | XdsIdentity |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Lync Server 2010, Lync Server 2013, 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: | Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019 |
Inputs
Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings object.
The Remove-CsArchivingConfiguration cmdlet accepts pipelined input of archiving configuration objects.
Outputs
The Remove-CsArchivingConfiguration cmdlet does not return a value or object.
Instead, the cmdlet removes instances of the Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings object.