Set-CsArchivingPolicy
上一次修改主题： 2012-03-26
修改现有的即时消息 (IM) 存档策略。通过存档策略，您可以存档在内部用户之间发生的所有 IM 会话和会议；您还可以存档在内部用户与联盟伙伴之间发生的会话。
语法
Set-CsArchivingPolicy [-Identity <XdsIdentity>] [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsArchivingPolicy [-ArchiveExternal <$true | $false>] [-ArchiveInternal <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]
详细说明
许多组织发现保留其用户参与的所有 IM 会话的存档非常有用。而对于其他一些组织，法律要求他们保留这种存档。要使用 Microsoft Lync Server 2010 存档 IM 会话，必须执行两个步骤。首先，需要通过 Set-CsArchivingConfiguration cmdlet 在 global 和/或 site 作用域启用存档。这样，您就能够存档 IM 会话；但是，这并不会自动开始存档这些会话。
要实际保存 IM 会话的文字记录，必须完成步骤 2：创建一个或多个存档策略。这些策略可确定哪些用户将记录其 IM 会话以及将对哪些类型的 IM 会话（内部和/或外部）进行存档。在内部 IM 会话中，所有参与者都是经过身份验证的用户，并拥有组织内的 Active Directory 帐户；而在外部 IM 会话中，至少有一个参与者是未经身份验证的用户，且没有组织内的 Active Directory 帐户。可以选择仅对内部会话、仅对外部会话或同时对二者进行存档。
可以将存档策略（使用 New-CsArchivingPolicy cmdlet 创建）分配给全局站点或 site 作用域。此外，还可以将这些策略分配给每用户作用域；这意味着可以创建策略，然后将策略应用于某个特定的用户或特定的用户组。例如，您可以拥有一个可存档所有用户的内部 IM 会话的全局策略。此外，您还可以创建另一个策略，用于同时存档内部会话和外部会话，并将第二个策略只应用于销售人员。由于每用户策略优先于全局策略和站点策略，因此各个销售人员将存档自己的所有 IM 会话。其他用户（即销售部门之外且不受销售策略影响的用户）则只会将其内部 IM 会话存档。
通过 Set-CsArchivingPolicy cmdlet，可以修改组织中当前使用的任何 IM 会话存档策略的属性值。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsArchivingPolicy cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsArchivingPolicy"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要修改的存档策略的唯一标识符。可以在 global 作用域、site 作用域或每用户作用域配置存档策略。要修改全局策略，请使用以下语法：-Identity global。要修改站点策略，请使用以下类似语法：-Identity site:Redmond。要修改每用户策略，请使用以下类似语法：-Identity SalesArchivingPolicy。如果未指定此参数，则将修改全局策略。 指定 Identity 时，不允许使用通配符。 |
Instance |
可选 |
IMArchivingPolicy 对象 |
允许您将对对象的引用传递到 cmdlet，而不是设置单个参数值。 |
ArchiveExternal |
可选 |
布尔值 |
指示是否存档外部 IM 会话。（外部 IM 会话是指至少一个参与者是未经过身份验证的、在组织中没有 Active Directory 帐户的用户的会话。）默认值为 False，这表示不存档包含外部用户的 IM 会话。 |
ArchiveInternal |
可选 |
布尔值 |
指示是否存档内部 IM 会话。（内部 IM 会话是指所有参与者都是经过身份验证的、在组织中拥有 Active Directory 帐户的用户的会话。）默认值为 False，这表示不存档内部 IM 会话。 |
Description |
可选 |
字符串 |
使管理员可以提供与策略相关的其他文本。例如，Description 属性可用于详细说明应该对哪些用户应用策略。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Policy.IM.IMArchivingPolicy 对象。Remove-CsArchivingPolicy 接受通过管道传递的存档策略对象的输入。
返回类型
Set-CsArchivingPolicy 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.WritableConfig.Settings.Policy.IM.IMArchivingPolicy 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Set-CsArchivingPolicy -Identity global -ArchiveInternal $True
在此示例中，使用 Set-CsArchivingPolicy 修改全局存档策略。在这种情况下，将 ArchiveInternal 属性设置为 True。
-------------------------- 示例 2 --------------------------
Get-CsArchivingPolicy | Set-CsArchivingPolicy -ArchiveInternal $True
示例 2 是示例 1 中显示的命令的变体。但在此示例中，组织中的所有存档策略都配置为允许存档 IM 会话。为此，该命令首先使用 Get-CsArchivingPolicy 返回当前使用的所有 IM 会话存档策略的集合。然后，将该集合通过管道传递到 Set-CsArchivingPolicy，后者会将每个策略的 ArchiveInternal 属性设置为 True。