Set-SPOListVersionPolicy
設定文件庫上的版本原則設定。
語法
Default (預設值)
Set-SPOListVersionPolicy
[-Site] <SpoSitePipeBind>
-List <SPOListPipeBind>
-EnableAutoExpirationVersionTrim <Boolean>
[-ExpireVersionsAfterDays <Int32>]
[-MajorVersionLimit <Int32>]
[-MajorWithMinorVersionsLimit <Int32>]
[<CommonParameters>]
Description
設定文件庫上的版本原則設定。
範例
範例 1
Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $true
範例 1 在名為「文件」的文件庫上設定自動版本歷程記錄限制。
範例 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 透過限制沒有時間限制的版本數目，在名為「文件」的文件庫上設定手動版本歷史限制。 新的文件庫將會使用此版本設定。
參數
-EnableAutoExpirationVersionTrim
適用：SharePoint Online 全域和 SharePoint 系統管理員可以設定文件庫層級版本歷程記錄限制，這些設定普遍適用於新建立的版本。
自動管理版本歷程記錄限制時，SharePoint 會在幕後採用演算法，刪除 (稀疏) 最不需要的間歇性舊版本，同時保留足夠的高價值版本 - 較多是近期的版本，較少是較遠的時間 - 以防需要還原。
有效的值為：
- True - 系統會自動管理在文件庫上建立的新版本的版本歷程記錄限制。
- False - 透過設定主要版本數目 (
MajorVersionLimit) 、主要版本與次要版本數目 ()MajorWithMinorVersionsLimit，以及設定) (的時間ExpireVersionsAfterDays限制，手動管理在文件庫上建立的新版本的版本歷程記錄限制。 檢閱這兩個參數的文件，以手動管理組織的版本限制。
注意事項
當版本歷程記錄限制是手動管理時， (EnableAutoExpirationVersionTrim $false) ，MajorVersionLimit且ExpireVersionsAfterDays是MajorWithMinorVersionsLimit具有下列可接受值的必要參數： a.
MajorVersionLimit 接受 1 到 50,000 (含) 值。
b.
MajorWithMinorVersionsLimit 接受 0 到 50,000 之間的值 (含) 。
c.
ExpireVersionsAfterDays 接受值為 0 至永不過期，或 >值 = 30 以刪除超過該時間週期的版本。
自動管理版本歷程記錄限制 (EnableAutoExpirationVersionTrim $true) 時，設定 MajorVersionLimit 或 ExpireVersionsAfterDays 將導致錯誤，因為計數限制是由服務所設定。
PARAMVALUE: $true | $false
參數屬性
| 類型: | System.Boolean |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExpireVersionsAfterDays
適用對象：SharePoint Online 手動管理版本歷程記錄限制 (
EnableAutoExpirationVersionTrim $false) 時，系統管理員必須將限制設定為主要版本數目 (MajorVersionLimit) 、主要版本數目和次要版本數目 (MajorWithMinorVersionsLimit) ，以及版本儲存 (ExpireVersionsAfterDays) 的時間週期。 詳情請查看 的EnableAutoExpirationVersionTrim說明。
PARAMVALUE: Int32
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-List
文件庫名稱或識別碼。
參數屬性
| 類型: | Microsoft.Online.SharePoint.PowerShell.SPOListPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MajorVersionLimit
適用對象：SharePoint Online 手動管理版本歷程記錄限制 (
EnableAutoExpirationVersionTrim $false) 時，系統管理員必須將限制設定為主要版本數目 (MajorVersionLimit) ，以及版本儲存 (ExpireVersionsAfterDays) 的時間週期。 詳情請查看 的EnableAutoExpirationVersionTrim說明。
PARAMVALUE: Int32
參數屬性
| 類型: | System.Int32 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MajorWithMinorVersionsLimit
適用對象：SharePoint Online 手動管理版本歷程記錄限制 (
EnableAutoExpirationVersionTrim $false) 時，系統管理員必須將限制設定為主要版本數目 (MajorVersionLimit) 、主要版本數目和次要版本數目 (MajorWithMinorVersionsLimit) ，以及版本儲存 (ExpireVersionsAfterDays) 的時間週期。 詳情請查看 的EnableAutoExpirationVersionTrim說明。
PARAMVALUE: 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。