[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

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 shut down instant messaging (IM) if your Archiving Server is unavailable and instant messages cannot be archived.


Remove-CsArchivingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]


Parameter Required Type Description




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. You cannot use wildcards when specifying a policy Identity.



Switch Parameter

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




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




Prompts you for confirmation before executing the command.

Detailed Description

Many organizations find it useful to keep a transcript of all the IM sessions and Web 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.

Microsoft Communications Server 2010 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 Communications Server 2010, 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 New-CsArchivingConfiguration 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 Remove-CsArchivingConfiguration 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 the 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 all archiving at the global scope.

Return Types


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

Copy Code
Remove-CsArchivingConfiguration -Identity site:Redmond

The preceding example uses Remove-CsArchivingConfiguration to delete the archiving configuration settings with the identity site:Redmond.

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

Copy Code
Get-CsArchivingConfiguration -Filter "site:*" | Remove-CsArchivingConfiguration

The command shown in Example 2 removes all of the archiving configuration settings that have been employed at the site scope. To do this, the command first uses Get-CsArchivingConfiguration 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 Remove-CsArchivingConfiguration, which deletes each item in that collection.

-------------------------- Example 3 --------------------------

Copy Code
Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -eq "None" | Remove-CsArchivingConfiguration

Example 3 deletes all the archiving configuration settings where the EnableArchiving property has been set to "None". To carry out this task, Get-CsArchivingConfiguration 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 (-eq) "None". The filtered collection is then piped to Remove-CsArchivingConfiguration, which deletes each item in the collection.