Set-CsArchivingServer
上一次修改主题： 2012-03-26
使您可以为一个或多个存档服务器指定新数据库位置。
语法
Set-CsArchivingServer [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingDatabase <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
存档服务器提供了一种保存组织内进行的即时消息 (IM) 会话的完整脚本的方法。在一些组织中，保存 IM 会话的副本非常有用。在另一些必须保留所有电子通信记录的组织中，可能必须保存 IM 会话的副本。
存档服务器将每个 IM 会话的脚本（以及有关会话进行的时间和会话参与者的信息）记录在 SQL Server 数据库中。安装存档服务器时，必须指定此数据库的位置，并且大多数情况下，不需要更改此数据库的位置。但是，如果出现硬件故障或其他问题，则可以使用 Set-CsArchivingServer cmdlet 将存档服务器指向新的数据库。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsArchivingServer cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsArchivingServer"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要修改的存档服务器实例的服务位置。例如：-Identity ArchivingServer:atl-cs-001.litwareinc.com。可以通过运行如下命令来检索所有存档服务器的服务位置： Get-CsService –ArchivingServer | Select-Object Identity 请注意，在指定存档服务器时可以省略前缀“ArchivingServer:”。例如：-Identity "atl-cs-001.litwareinc.com"。 |
ArchivingDatabase |
可选 |
字符串 |
新存档数据库所在的服务位置。例如：-ArchivingDatabase ArchivingDatabase:atl-sql-001.litwareinc.com。请确保在指定数据库位置的时候，使用服务位置而不是 SQL Server 路径。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。Set-CsArchivingServer 不接受通过管道传递的输入。
返回类型
Set-CsArchivingServer 不会返回任何对象或值。此 cmdlet 会修改 Microsoft.Rtc.Management.Xds.DisplayArchivingServer 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsArchivingServer -Identity "ArchivingServer:atl-cs-001.litwareinc.com" -ArchivingDatabase "ArchivingDatabase:atl-sql-001.litwareinc.com"
上述命令更改 ArchivingServer:atl-cs-001.litwareinc.com 存档服务器的存档数据库的位置。在此示例中，新数据库位于 ArchivingDatabase:atl-sql-001.litwareinc.com 中。