Set-SPOListVersionPolicy

设置文档库的版本策略设置。

语法

Default (默认值)

Set-SPOListVersionPolicy
    [-Site] <SpoSitePipeBind>
    -List <SPOListPipeBind>
    -EnableAutoExpirationVersionTrim <Boolean>
    [-ExpireVersionsAfterDays <Int32>]
    [-MajorVersionLimit <Int32>]
    [-MajorWithMinorVersionsLimit <Int32>]
    [<CommonParameters>]

说明

设置文档库的版本策略设置。

示例

示例 1

Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $true

示例 1 对名为“Documents”的文档库设置自动版本历史记录限制。

示例 2

Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 30

示例 2 通过限制版本数和保留时间 ((以天为单位) 版本)来设置名为“文档”的文档库的手动版本限制。

示例 3

Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 0

示例 3 通过限制没有时间限制的版本数来设置名为“Documents”的文档库的手动版本设置限制。 新的文档库将使用此版本设置。

参数

-EnableAutoExpirationVersionTrim

适用:SharePoint Online 全局和 SharePoint 管理员可以设置文档库级别版本历史记录限制设置,这些设置将普遍应用于创建的新版本。

当自动管理版本历史记录限制时,SharePoint 在后台采用一种算法,删除 () 最不需要的间歇性旧版本,同时保留足够的高价值版本(最近版本更多,回退时间更少),以防需要还原。

有效值为:

  • True - 将自动管理在文档库上创建的新版本的版本历史记录限制。
  • False - 对文档库上创建的新版本的版本历史记录限制进行手动管理,方法是将限制设置为 () MajorVersionLimit 的主要版本数、 () MajorWithMinorVersionsLimit 的主要版本数以及 (ExpireVersionsAfterDays) 设置时间。 查看这两个参数的文档,以手动管理组织的版本限制。

注意

当手动管理版本历史记录限制 () EnableAutoExpirationVersionTrim $false 时,MajorVersionLimitMajorWithMinorVersionsLimitExpireVersionsAfterDays 是具有以下可接受值的参数:a。 MajorVersionLimit 接受从 1 到 50,000 (包含) 的值。 b. MajorWithMinorVersionsLimit 接受介于 0 到 50,000 (含) 的值。 c. ExpireVersionsAfterDays 接受值 0 到永不过期或值 >= 30 以删除超过该时间段的版本。 当版本历史记录限制自动管理 (EnableAutoExpirationVersionTrim $true) 时,设置 MajorVersionLimitExpireVersionsAfterDays 将导致错误,因为计数限制由服务设置。

参数值:$true | $false

参数属性

类型:System.Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ExpireVersionsAfterDays

适用:SharePoint Online 当手动管理 (EnableAutoExpirationVersionTrim $false) 的版本历史记录限制时,管理员需要将限制设置为 () MajorVersionLimit 的主要版本数、 () MajorWithMinorVersionsLimit 的主要版本数以及版本存储 (ExpireVersionsAfterDays) 的时间段。 有关更多详细信息,检查 的说明EnableAutoExpirationVersionTrim

参数值:Int32

参数属性

类型:System.Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-List

文档库名称或 ID。

参数属性

类型:Microsoft.Online.SharePoint.PowerShell.SPOListPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MajorVersionLimit

适用:SharePoint Online 当 () EnableAutoExpirationVersionTrim $false 手动管理版本历史记录限制时,管理员需要将限制设置为) (MajorVersionLimit 主要版本的数量,以及 () 存储 ExpireVersionsAfterDays 版本的时间段。 有关更多详细信息,检查 的说明EnableAutoExpirationVersionTrim

参数值:Int32

参数属性

类型:System.Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MajorWithMinorVersionsLimit

适用:SharePoint Online 当手动管理 (EnableAutoExpirationVersionTrim $false) 的版本历史记录限制时,管理员需要将限制设置为 () MajorVersionLimit 的主要版本数、 () MajorWithMinorVersionsLimit 的主要版本数以及版本存储 (ExpireVersionsAfterDays) 的时间段。 有关更多详细信息,检查 的说明EnableAutoExpirationVersionTrim

参数值:Int32

参数属性

类型:System.Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Site

适用:SharePoint Online

指定网站的 URL。

参数属性

类型:Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

Microsoft.Online.SharePoint.PowerShell.SPOListPipeBind

输出

System.Object