通过

设置站点的版本限制

  • 项目

默认情况下，组织级别设置定义应用于网站中创建的所有新文档库的版本历史记录限制。 但是，为了满足特定内容需求，管理员可以选择在各个网站上设置不同的版本历史记录限制。 这样，用户可以在单个网站上打破组织限制的继承。

可以通过以下方式管理单个站点的版本历史记录限制：

版本历史记录限制选项 说明
应用于网站中的所有新文档库和现有文档库： 若要为站点实现一致的版本存储策略，可以选择 设置一个限制，以普遍应用于站点中的所有库 。 使用此选项，网站级别设置的版本历史记录限制将应用于网站中创建的所有新文档库，并创建后台请求以异步处理现有文档库的更新。
仅应用于在网站中创建的新文档库： 为了避免影响现有库的设置，可以 仅为新库设置版本历史记录限制。 使用此选项，在网站级别设置的版本历史记录限制仅适用于在网站中创建的新文档库。 对现有文档库或网站中未启用版本控制库的限制没有做出任何更改。
仅适用于网站中的现有文档库： 只能更新网站上 现有文档库 的限制，而无需为新文档库设置网站级别版本历史记录设置。 使用此选项可创建后台请求，以异步处理现有文档库的更新，同时允许在网站中创建的新文档库继承组织级别的版本历史记录限制。
清除网站上设置的现有限制： 可以 清除网站上的现有限制 ，以允许在网站中创建的新文档库遵循组织级别限制。
注意： 清除网站上的设置仅适用于在网站上创建的新文档库，不会影响现有文档库的设置或剪裁现有版本。

示例方案

以 Contoso 为例，其中默认组织版本历史记录限制配置为“自动设置”，最初不会对营销和法律网站应用版本限制。 为了满足业务需求，管理员可以决定在合法网站上应用“手动”设置，从而使用组织默认版本设置中断法定网站的继承。

下面是 Contoso 的版本存储：

  • 营销网站上的版本存储行为：由于没有为营销网站配置限制，所以在营销网站集中创建的所有新文档库都继承了组织默认设置自动。

  • 合法网站上的版本存储：由于法律网站配置了手动设置，所以在法律网站中创建的所有新库都应用了手动设置。

站点级别设置版本限制的关系图。

重要

  • 站点级别版本历史记录限制只能使用 PowerShell cmdlet 设置。
  • 设置站点级别版本历史记录限制不会剪裁现有版本以满足新限制。 需要执行其他步骤来 剪裁网站或库上的现有版本。
  • 更新现有库限制的请求由后台作业异步处理，最长可能需要 24 小时才能处理。 可以使用 PowerShell 检查作业进度。
  • 取消正在进行的作业会停止对未处理的库的更新。 此操作不会还原已处理设置更新的文档库的更改。

使用 PowerShell 管理站点的版本历史记录限制

按照以下步骤使用 PowerShell 管理站点的版本历史记录限制。

  1. 下载最新的SharePoint在线管理壳。

    注意

    如果安装了早期版本的 SharePoint Online 命令行管理程序，请转到添加或删除程序并卸载 SharePoint Online 命令行管理程序。

  2. 以 Microsoft 365 中的 SharePoint 管理员身份连接到 SharePoint 。 若要了解具体操作步骤，请参阅 SharePoint 在线管理壳入门。

  3. 运行以下命令之一来管理站点上的版本历史记录限制：

操作 PowerShell 命令
查看站点上设置的版本历史记录限制 Get-SPOSite -Identity $siteUrl |fl Url、EnableAutoExpirationVersionTrim、ExpireVersionsAfterDays、MajorVersionLimit
在站点上设置自动版本历史记录限制。 为站点上的所有库设置自动版本历史记录限制：

Set-SPOSite -Identity $siteUrl
-EnableAutoExpirationVersionTrim $true

追加 -ApplyToNewDocumentLibraries 参数以仅应用于网站上的新文档库：

Set-SPOSite -Identity $siteUrl
-EnableAutoExpirationVersionTrim $true
-ApplyToNewDocumentLibraries

追加 -ApplyToExistingDocumentLibraries 以仅应用于网站上的现有文档库：

Set-SPOSite -Identity $siteUrl
-EnableAutoExpirationVersionTrim $true
-ApplyToExistingDocumentLibraries
使用网站上的计数和时间参数设置手动限制。 若要为站点上的所有库设置计数和时间参数的手动限制：

Set-SPOSite -Identity $siteUrl
-EnableAutoExpirationVersionTrim $false
-MajorVersionLimit <delete major versions exceeding limit>
-MajorwithMinorVersionsLimit <number of major versions for which all minor versions will be kept>
-ExpireVersionsAfterDays <delete versions exceeding time limit set in days>

追加 -ApplyToNewDocumentLibraries 参数以仅应用于网站上的新文档库：

Set-SPOSite -Identity $siteUrl
-EnableAutoExpirationVersionTrim $false
-MajorVersionLimit <delete major versions exceeding limit>
-MajorwithMinorVersionsLimit <number of major versions for which all minor versions will be kept>
-ExpireVersionsAfterDays <delete versions exceeding time limit set in days>
-ApplyToNewDocumentLibraries

追加 -ApplyToExistingDocumentLibraries 以仅应用于网站上的现有文档库：

Set-SPOSite -Identity $siteUrl
-EnableAutoExpirationVersionTrim $false
-MajorVersionLimit <delete major versions exceeding limit>
-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>
-ExpireVersionsAfterDays <delete versions exceeding time limit set in days>
-ApplyToExistingDocumentLibraries
在站点上设置无过期限制的手动计数。 若要设置手动限制并设置计数限制，请将 -ExpireVersionsAfterDays 参数设置为 0:

Set-SPOSite -Identity $siteUrl
-EnableAutoExpirationVersionTrim $false
-MajorVersionLimit <delete major versions exceeding limit>
-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>
-ExpireVersionsAfterDays 0

追加 -ApplyToNewDocumentLibraries 参数以仅应用于网站上的新文档库：

Set-SPOSite -Identity $siteUrl
-EnableAutoExpirationVersionTrim $false
-MajorVersionLimit <delete major versions exceeding limit>
-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>
-ExpireVersionsAfterDays 0
-ApplyToNewDocumentLibraries

追加 -ApplyToExistingDocumentLibraries 以仅应用于网站上的现有文档库：

Set-SPOSite -Identity $siteUrl
-EnableAutoExpirationVersionTrim $false
-MajorVersionLimit <delete major versions exceeding limit>
-MajorWithMinorVersionsLimit <number of major versions for which all minor versions will be kept>
-ExpireVersionsAfterDays 0
-ApplyToExistingDocumentLibraries
清除网站上设置的现有版本历史记录限制，并继承网站上创建的新文档库的组织版本限制。 Set-SPOSite -Identity $siteUrl -InheritVersionPolicyFromTenant
正在取消更新作业 Remove-SPOSiteVersionPolicyJob -Identity $siteUrl

跟踪网站上现有库的设置更新进度

将立即应用站点中创建的所有新库的版本限制。 现有库的设置使用后台作业异步更新。 运行以下命令 以跟踪设置更新作业的进度。

Get-SPOSiteVersionPolicyJobProgress -Identity $siteUrl

下表枚举了尝试更新网站集中现有库的版本设置时可以报告的各种进度状态：

状态 说明
NoRequestFound 网站上没有设置或更新现有文档库的版本设置的请求。
新增 更新请求为“新建”，尚未处理。
InProgress 更新请求已处理，设置更新请求正在进行中。
CompleteSuccess 更新请求已成功完成。
CompleteWithFailure 更新请求已完成，但对某些文档库设置更新失败。

了解更多信息：