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