Remove-CsArchivingConfiguration
上一次修改主题： 2012-03-27
删除指定的存档设置集合。存档设置可用于启用或禁用即时消息 (IM) 会话自动保存功能，以及选择性地阻止任何无法存档的即时消息。
语法
Remove-CsArchivingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
对许多组织而言，保存其用户参与的所有 IM 会话和会议的脚本很有用处。而某些组织必须保存此类脚本，例如，法律要求许多金融组织保留其所有电子通信的副本。
Microsoft Lync Server 2010 为存档 IM 和 Web 会议会话提供了灵活性。如果已部署存档服务器，可以使用不同 CsArchivingConfiguration cmdlet 启用和禁用 IM 会话存档，并管理您的存档数据库。也可以在存档失败时暂停 IM，这有助于确保保存您的所有电子通信记录。
安装 Lync Server 2010 时，将为您创建全局存档设置的集合，默认情况下，这些设置将应用于您的整个组织。此外，可以使用 New-CsArchivingConfiguration cmdlet 创建基于点对点的自定义配置设置。任何使用 New-CsArchivingConfiguration 创建且特定于站点的设置，都可以在稍后通过使用 Remove-CsArchivingConfiguration cmdlet 删除。删除站点设置时，受影响的站点将由全局设置管理。
请注意，也可以针对全局存档设置运行 Remove-CsArchivingConfiguration。但在这种情况下，不会删除设置，因为您无法删除全局设置，而是将所有全局属性都重置为默认值。例如，假设已在 global 作用域启用 IM 会话存档，稍后运行命令 Remove-CsArchivingConfiguration -Identity global。运行该命令将重置全局设置的属性值，这意味着 EnableArchiving 将还原为默认值 None。这将在 global 作用域禁用存档。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsArchivingConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsArchivingConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的存档配置设置集合的唯一标识符。要删除全局集合，请使用以下语法：-Identity global。（请注意，您无法实际删除全局设置，而只能将这些属性重置为默认值。）要删除一个站点集合，请使用类似如下的语法：-Identity site:Redmond。指定策略 Identity 时不能使用通配符。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings 对象。Remove-CsArchivingConfiguration 接受通过管道传递的存档配置对象的输入。
返回类型
Set-CsArchivingConfiguration 不会返回值或对象。此 cmdlet 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.Archiving.ArchivingSettings 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsArchivingConfiguration -Identity site:Redmond
上述示例使用 Remove-CsArchivingConfiguration 删除标识为 site:Redmond 的存档配置设置。
-------------------------- 示例 2 --------------------------
Get-CsArchivingConfiguration -Filter "site:*" | Remove-CsArchivingConfiguration
示例 2 中显示的命令删除在 site 作用域配置的所有存档配置设置。为执行此操作，该命令首先使用 Get-CsArchivingConfiguration 和 Filter 参数，以返回在 site 作用域配置的所有设置的集合。这是通过使用筛选器值“site:*”来实现的，该值可以将返回数据限制为 Identity 以字符“site:”开头的设置。然后，将筛选出的集合通过管道传递到 Remove-CsArchivingConfiguration，后者将删除集合中的每一项。
-------------------------- 示例 3 --------------------------
Get-CsArchivingConfiguration | Where-Object {$_.EnableArchiving -eq "None"} | Remove-CsArchivingConfiguration
示例 3 删除 EnableArchiving 属性已设置为“None”的所有存档配置设置。为完成此任务，调用不带任何参数的 Get-CsArchivingConfiguration，以返回配置为在组织中使用的所有存档设置的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者仅挑选出 EnableArchiving 属性等于“None”的设置。然后，将筛选出的集合通过管道传递到 Remove-CsArchivingConfiguration，后者将删除集合中的每一项。