Search <book_title>...

Enterprise Vault™ PowerShell Cmdlet

Last Published: 2018-03-28

Product(s): Enterprise Vault (12.3)

Set-EVArchive

Set-EVArchive 可设置指定归档的多个属性，包括用户是否可以手动删除归档中的项目，Enterprise Vault 是否可以在保留期限过期后自动删除已归档项目。您还可以为归档指定要显示在管理控制台中的说明和管理注释。您还可以指定要应用于归档的保留计划。如果将 -RetentionPlanName 的值指定为空字符串，则 Set-EVArchive 将从归档中删除现有保留计划。

Set-EVArchive 由管理单元 Symantec.EnterpriseVault.PowerShell.Snapin.dll 提供。

语法

Set-EVArchive [[-ArchiveID] <String>] [-DeleteProtected [<Boolean>]] [-DeleteExpiredItems [<Boolean>]] [-Description [<String>]] [-AdminNote [<String>]] [-RetentionPlanName [<String>]] [-Force [<Boolean>]] [<CommonParameters>]

参数

表：Set-EVArchive 参数

参数	说明
-ArchiveID（必填）	指定要设置属性的归档的 ID。您可以使用 Get-EVArchive cmdlet 获取所需的 ID。
-DeleteProtected	指定是否允许用户手动删除归档中的项目。设置为 $false 将允许用户删除项目，设置为 $true 将阻止用户删除项目。
-DeleteExpiredItem	指定是否允许 Enterprise Vault 在已归档项目的保留期限过期后自动删除这些项目。设置为 $false 将阻止删除，设置为 $true 将允许 Enterprise Vault 删除过期的项目。
-Description	提供要显示在管理控制台归档属性中的简要说明。
-AdminNote	提供要显示在管理控制台归档属性中的管理注释。
-RetentionPlanName	指定要应用于归档的保留计划的名称。如果该归档与一个或多个与其他归档关联的目标相关联，则该命令将更新所有受影响归档的保留计划。如果将 -RetentionPlanName 的值指定为空字符串，则 Set-EVArchive 将从归档中删除现有保留计划。在 Exchange 或 Internet 邮件归档中，Set-EVArchive 会创建或更新使用该保留计划定义的任何保留文件夹。该 cmdlet 首先确定归档的首选语言，然后，如果您已提供此语言的保留文件夹名称，则相应地命名该文件夹。如果首选语言是 Enterprise Vault 不支持的语言，或者 Enterprise Vault 支持该语言，但您没有提供该语言的文件夹名称，则使用以 Enterprise Vault 的默认语言命名的文件夹名称。请注意，当归档任务下一次执行邮箱同步时，可能会使用相应配置组的保留设置覆盖指定的保留计划。对于 Exchange 邮箱归档，仅当已清除 Exchange 邮箱策略设置中的“整体锁定”选项时才会出现此情况。
-Force	应用在 -RetentionPlanName 中指定的保留计划，但不提示进行确认。

示例

Set-EVArchive 14B...EVSERVER.LOCAL -DeleteProtected:$true -DeleteExpiredItems:$false
阻止用户和 Enterprise Vault 删除指定归档中的项目，以使其处于法定保留状态。
Set-EVArchive 14B...EVSERVER.LOCAL -DeleteProtected:$false -AdminNote "Item deletion allowed $(get-date) by $(gc env:username)"
允许用户手动删除指定归档中的项目，并修改其管理注释。
Get-EVArchive localhost Domain\User -OnHold:$false | Set-EVArchive -DeleteProtected:$true -DeleteExpiredItems:$false -Description "Archive placed on legal hold $(get-date) by $(gc env:username) from $(gc env:computername)"
使用 Get-EVArchive 生成本地 Enterprise Vault 服务器上不是法定保留状态的归档的列表，其中用户 Domain\User 具有删除权限。Get-EVArchive 将列表传递到 Set-EVArchive，这可将归档置于保留状态并相应设置归档说明。
Set-EVArchive 14B...EVSERVER.LOCAL -RetentionPlanName RPForManagers
警告: 此归档与一个或多个与其他归档关联的目标相关联。更改此归档的保留设置会更改所列归档的保留设置。
Express Vault Store\A1
Express Vault Store\A2
Express Vault Store\A3
确认是否要继续? [Y] 是 [N] 否 [S] 挂起 [?] 帮助 (默认值为“Y”): Y
将保留计划 RPForManagers 应用于指定归档。如果此归档与一个或多个与其他归档关联的目标相关联，则此命令将先显示归档列表，然后提示进行确认以继续。如果选择“是”，则该命令将向所列归档应用名为 RPForManagers 的保留计划。选择“N”或“S”将退出命令而不应用任何更改。
Set-EVArchive 14B...EVSERVER.LOCAL -RetentionPlanName RPForManagers -Force
向指定的归档应用名为 RPForManagers 的保留计划。如果此归档与一个或多个与其他归档关联的目标相关联，则此命令不显示确认提示，并继续更新所有受影响归档的保留计划。
Set-EVArchive 14B...EVSERVER.LOCAL -RetentionPlanName ""
删除先前应用于指定归档的保留计划。删除保留计划时，将使用归档目标的有效保留类别。

输出

表：Set-EVArchive 属性会列出可用的属性。

表：Set-EVArchive 属性

名称	类型	说明
ArchiveId	字符串	要修改的归档的 ArchiveId。
ArchiveName	字符串	要修改的归档的名称。
Updated	布尔值	表示归档是否已由 cmdlet 更新。可能的值为：$true（归档已更新）、$false（归档未更新）。