From 3df3d17d02db48cde95062d0e949a3f5af9fe2c8 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 11:18:52 -0700 Subject: [PATCH 01/31] Learn Editor: Update Set-SPOTenant.md --- .../Set-SPOTenant.md | 108 +++++++++++++++++- 1 file changed, 105 insertions(+), 3 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md index 582c748aa..7d2463ca2 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md @@ -105,7 +105,9 @@ Set-SPOTenant [-MinCompatibilityLevel ] [-MaxCompatibilityLevel ] [-IsEnableAppAuthPopUpEnabled ] [-IsDataAccessInCardDesignerEnabled ] [-MassDeleteNotificationDisabled ] [-EnableAutoExpirationVersionTrim ] [-EnableMediaReactions ] [-BusinessConnectivityServiceDisabled ] - [-ExpireVersionsAfterDays ] [-MajorVersionLimit ] [-AllowSensitivityLabelOnRecords ] + [-ExpireVersionsAfterDays ] [-MajorVersionLimit ] [-FileTypesForVersionExpiration ] + [-RemoveVersionExpirationFileTypeOverride ] + [-AllowSensitivityLabelOnRecords ] [-DelayDenyAddAndCustomizePagesEnforcement ] [-DelayDenyAddAndCustomizePagesEnforcementOnClassicPublishingSites ] [-AllowClassicPublishingSiteCreation ] [-WhoCanShareAnonymousAllowList ] @@ -337,7 +339,9 @@ Set-SPOTenant [-MinCompatibilityLevel ] [-MaxCompatibilityLevel ] [-IsEnableAppAuthPopUpEnabled ] [-IsDataAccessInCardDesignerEnabled ] [-MassDeleteNotificationDisabled ] [-EnableAutoExpirationVersionTrim ] [-EnableMediaReactions ] [-BusinessConnectivityServiceDisabled ] - [-ExpireVersionsAfterDays ] [-MajorVersionLimit ] [-AllowSensitivityLabelOnRecords ] + [-ExpireVersionsAfterDays ] [-MajorVersionLimit ] + [-FileTypesForVersionExpiration ] [-RemoveVersionExpirationFileTypeOverride ] + [-AllowSensitivityLabelOnRecords ] [-DelayDenyAddAndCustomizePagesEnforcement ] [-DelayDenyAddAndCustomizePagesEnforcementOnClassicPublishingSites ] [-AllowClassicPublishingSiteCreation ] [-WhoCanShareAnonymousAllowList ] @@ -452,7 +456,9 @@ Set-SPOTenant [-MinCompatibilityLevel ] [-MaxCompatibilityLevel ] [-IsEnableAppAuthPopUpEnabled ] [-IsDataAccessInCardDesignerEnabled ] [-MassDeleteNotificationDisabled ] [-EnableAutoExpirationVersionTrim ] [-EnableMediaReactions ] [-BusinessConnectivityServiceDisabled ] - [-ExpireVersionsAfterDays ] [-MajorVersionLimit ] [-AllowSensitivityLabelOnRecords ] + [-ExpireVersionsAfterDays ] [-MajorVersionLimit ] + [-FileTypesForVersionExpiration ] [-RemoveVersionExpirationFileTypeOverride ] + [-AllowSensitivityLabelOnRecords ] [-DelayDenyAddAndCustomizePagesEnforcement ] [-DelayDenyAddAndCustomizePagesEnforcementOnClassicPublishingSites ] [-AllowClassicPublishingSiteCreation ] [-WhoCanShareAnonymousAllowList ] @@ -664,6 +670,42 @@ Set-SPOTenant -DisabledAdaptiveCardExtensionIds 0d2d0fd0-9489-47ef-acfb-90edca00 This example disables the Power Apps Adaptive Card Extension. +### EXAMPLE 22 + + +```powershell +Set-SPOTenant -EnableAutoExpirationVersionTrim $true -FileTypesForVersionExpiration @("Video", "Audio") +``` + +This example sets automatic version history limit override for video and audio file types on all new document libraries at tenant level. + +### EXAMPLE 23 + + +```powershell +Set-SPOTenant -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -ExpireVersionsAfterDays 30 -FileTypesForVersionExpiration @("Video", "Audio") +``` + +This example sets manual version history limit override for video and audio file types on all new document libraries at tenant level by limiting the number of major versions and the time (in days) versions are kept. + +### EXAMPLE 24 + + +```powershell +Set-SPOTenant -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -ExpireVersionsAfterDays 0 -FileTypesForVersionExpiration @("Video", "Audio") +``` + +This example sets manual version history limit override for video and audio file types on all new document libraries at tenant level by limiting the number of major versions with no time limits. + +### EXAMPLE 25 + + +```powershell +Set-SPOTenant -RemoveVersionExpirationFileTypeOverride @("Video", "Audio") +``` + +This example removes any specific version history limit override set for video and audio file types on all new document libraries at tenant level. + ## PARAMETERS ### -AIBuilderModelScope @@ -3125,6 +3167,42 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -FileTypesForVersionExpiration + +An array of file type names. The supported file type names are: + +- Audio + +- OutlookPST + +- Video + +Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: + +- EnableAutoExpirationVersionTrim + +- MajorVersionLimit + +- ExpireVersionsAfterDays + +The version history limits are applied on new document libraries in the tenant. + +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + + +```yaml +Type: String[] +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -FolderAnonymousLinkType > Applicable: SharePoint Online @@ -4434,6 +4512,30 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RemoveVersionExpirationFileTypeOverride + +An array of file type names. Removes the version history limits to a set of file types so that they will follow the default version history limits. + +The version history limits are applied on new document libraries in the tenant. + +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + +YAML + + +``` +Type: String[] +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -RequireAcceptingAccountMatchInvitedAccount This parameter has been deprecated since SharePoint Online legacy invitation flow switched to Entra B2B invitation flow. From 2e51f13d2f7fbf429187bda23a946562b9db7137 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 12:28:18 -0700 Subject: [PATCH 02/31] Learn Editor: Update Set-SPOSite.md --- .../Set-SPOSite.md | 135 +++++++++++++++++- 1 file changed, 131 insertions(+), 4 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md index adb26af2a..79c1b87fd 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md @@ -147,6 +147,21 @@ Set-SPOSite [-Identity] [-InformationBarriersMode ] [-WhatIf] [-Confirm] [] ``` +### SetSiteFileTypeFileVersionPolicy + + +``` +Set-SPOSite [-Identity] [-InformationBarriersMode ] [-EnableAutoExpirationVersionTrim ] [-ExpireVersionsAfterDays ] [-MajorVersionLimit ] -FileTypesForVersionExpiration [-ApplyToNewDocumentLibraries] [-WhatIf] [-Confirm] [] +``` + +### RemoveSiteFileVersionPolicy + + +``` +Set-SPOSite [-Identity] [-InformationBarriersMode ] [-ApplyToNewDocumentLibraries] + [-RemoveVersionExpirationFileTypeOverride ] [-WhatIf] [-Confirm] [] +``` + ### ClearGroupId ``` @@ -332,6 +347,44 @@ Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -InheritVersion Example 20 clears the file version setting at site level. The new document libraries will use the Tenant Level setting. It won't impact the existing document libraries. +### Example 21 + + +```powershell +Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $true -FileTypesForVersionExpiration @("Video", "Audio") -ApplyToNewDocumentLibraries +``` + +Example 21 sets automatic version history limit override for video and audio file types at site level. The new document libraries will use this version setting. + +### Example 22 + + +```powershell +Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -ExpireVersionsAfterDays 30 +-FileTypesForVersionExpiration @("Video", "Audio") -ApplyToNewDocumentLibraries +``` + +Example 22 sets manual version history limit override for video and audio file types at site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting. + +### Example 23 + + +```powershell +Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -ExpireVersionsAfterDays 0 +-FileTypesForVersionExpiration @("Video", "Audio") -ApplyToNewDocumentLibraries +``` + +Example 23 sets manual version history limit override for video and audio file types at site level by limiting the number of versions with no time limits. The new document libraries will use this version setting. + +### Example 24 + + +```powershell +Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -RemoveVersionExpirationFileTypeOverride @("Video", "Audio") -ApplyToNewDocumentLibraries +``` + +Example 24 removes the version history limit override for video and audio file types at the site level. The new document libraries will use this version setting. + ## PARAMETERS ### -AddInformationSegment @@ -518,7 +571,7 @@ Apply the version history limits setting to new document libraries. ```yaml Type: System.Management.Automation.SwitchParameter -Parameter Sets: SetSiteFileVersionPolicy +Parameter Sets: SetSiteFileVersionPolicy, RemoveSiteFileVersionPolicy Aliases: Required: False @@ -528,6 +581,19 @@ Accept pipeline input: False Accept wildcard characters: False ``` + +``` +Type: SwitchParameter +Parameter Sets: SetSiteFileTypeFileVersionPolicy +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -AuthenticationContextAccessType > Applicable: SharePoint Online @@ -1045,7 +1111,7 @@ PARAMVALUE: False | True ```yaml Type: System.Boolean -Parameter Sets: SetSiteFileVersionPolicy +Parameter Sets: SetSiteFileVersionPolicy, SetSiteFileTypeFileVersionPolicy Aliases: Required: False @@ -1140,7 +1206,7 @@ PARAMVALUE: Int32 ```yaml Type: System.Int32 -Parameter Sets: SetSiteFileVersionPolicy +Parameter Sets: SetSiteFileVersionPolicy, SetSiteFileTypeFileVersionPolicy Aliases: Required: False @@ -1170,6 +1236,43 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -FileTypesForVersionExpiration + +> Applicable: SharePoint Online + +An array of file type names. The supported file type names are: + +- Audio + +- OutlookPST + +- Video + +Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: + +- EnableAutoExpirationVersionTrim + +- MajorVersionLimit + +- ExpireVersionsAfterDays + +This must be used with **ApplyToNewDocumentLibraries** switch set to true, because the version history limits are only applied on new document libraries in the site. + + + + +``` +Type: String[] +Parameter Sets: SetSiteFileTypeFileVersionPolicy +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -HidePeoplePreviewingFiles > Applicable: SharePoint Online @@ -1430,7 +1533,7 @@ PARAMVALUE: Int32 ```yaml Type: System.Int32 -Parameter Sets: SetSiteFileVersionPolicy +Parameter Sets: SetSiteFileVersionPolicy, SetSiteFileTypeFileVersionPolicy Aliases: Required: False @@ -1701,6 +1804,30 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RemoveVersionExpirationFileTypeOverride + +> Applicable: SharePoint Online + +An array of file type names. Removes the version history limits to a set of file types so that they will follow the default version history limits. + +This must be used with **ApplyToNewDocumentLibraries** switch set to true, because the version history limits are only applied on new document libraries in the site. + +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + + +```yaml +Type: String[] +Parameter Sets: RemoveSiteFileVersionPolicy +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -RequestFilesLinkEnabled > Applicable: SharePoint Online From 5604501501382068e59ef82d944c06ff42d53a88 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 12:58:51 -0700 Subject: [PATCH 03/31] Learn Editor: Update Set-SPOListVersionPolicy.md --- .../Set-SPOListVersionPolicy.md | 207 +++++++++++++++++- 1 file changed, 197 insertions(+), 10 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md index 095fa9c5b..6e3c93f76 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md @@ -19,10 +19,23 @@ Sets the version policy setting on the document library. ## SYNTAX +### SetPolicy ``` Set-SPOListVersionPolicy [-Site] -List -EnableAutoExpirationVersionTrim [-ExpireVersionsAfterDays ] [-MajorVersionLimit ] - [-MajorWithMinorVersionsLimit ] [] + [-MajorWithMinorVersionsLimit ] [-FileTypes ] [] +``` + +### RemovePolicy +``` +Set-SPOListVersionPolicy [-Site] -List + -RemoveVersionExpirationFileTypeOverride [] +``` + +### SyncPolicy +``` +Set-SPOListVersionPolicy [-Site] -List [-FileTypes ] [-Sync] + [-ExcludeDefaultPolicy] [] ``` ## DESCRIPTION @@ -51,7 +64,79 @@ Example 2 sets manual version histroy limits on the document library called "Doc Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 0 ``` -Example 3 sets manual version histroy limits on the document library called "Documents" by limiting the number of versions with no time limits. The new document libraries will use this version setting. +Example 3 sets manual version histroy limits on the document library called "Documents" by limiting the number of versions with no time limits. + +### Example 4 +```powershell +Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $true -FileTypes @("Video", "Audio") +``` +Example 4 sets automatic version history limit override for video and audio file types on the document library called "Documents". + +### EXAMPLE 5 + +```powershell +Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 30 -FileTypes @("Video", "Audio") +``` + +Example 5 sets manual version history limit override for video and audio file types on the document library called "Documents" by limiting the number of versions and the time (in days) versions are kept. + +### EXAMPLE 6 + +```powershell +Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 0 -FileTypes @("Video", "Audio") +``` + +Example 6 sets manual version history limit override for video and audio file types on the document library called "Documents" by limiting the number of versions with no time limits. + +### EXAMPLE 7 + +```powershell +Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync +``` + +Example 7 sets the version history limits (include file type overrides) to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). + +### EXAMPLE 8 + +```powershell +Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync -FileTypes @("Video", "Audio") +``` + +Example 8 sets the default version history limits and overrides for video and audio file types to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). + +### EXAMPLE 9 + +```powershell +Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync -FileTypes @() +``` + +Example 9 sets the default version history limit to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). + +### EXAMPLE 10 + +```powershell +Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync -FileTypes @("Video", "Audio") -ExcludeDefaultPolicy +``` + +Example 10 sets the only the version history limit overrides for video and audio file types to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). + +### EXAMPLE 11 + + +```powershell +Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync -ExcludeDefaultPolicy +``` + +Example 10 sets the version history limit overrides for all file types to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). + +### EXAMPLE 12 + + +```powershell +Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -RemoveVersionExpirationFileTypeOverride @("Video", "Audio") +``` + +Example 12 removes the version history limit overrides for video and audio file types so that they follow the default version history limits. ## PARAMETERS @@ -77,8 +162,8 @@ The valid values are: PARAMVALUE: $true | $false ```yaml -Type: System.Boolean -Parameter Sets: (All) +Type: Boolean +Parameter Sets: SetPolicy Aliases: Required: True @@ -88,6 +173,26 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -ExcludeDefaultPolicy +> Applicable: SharePoint Online + +Indicates whether to synchronize the default version policy to the default policy of the tenant or the site (if the site this document library is in has broken inheritance for version history limits). + +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + +```yaml +Type: SwitchParameter +Parameter Sets: SyncPolicy +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -ExpireVersionsAfterDays > Applicable: SharePoint Online @@ -96,8 +201,43 @@ When version history limits are managed manually (`EnableAutoExpirationVersionTr PARAMVALUE: Int32 ```yaml -Type: System.Int32 -Parameter Sets: (All) +Type: Int32 +Parameter Sets: SetPolicy +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -FileTypes +> Applicable: SharePoint Online + +An array of file type names. The supported file type names are: + +- Audio + +- OutlookPST + +- Video + +Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: + +- EnableAutoExpirationVersionTrim + +- MajorVersionLimit + +- ExpireVersionsAfterDays + +Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the **Sync** parameter. For more information about this option, please refer to the documentation for the **Sync** parameter. + + + +```yaml +Type: String[] +Parameter Sets: SetPolicy, SyncPolicy Aliases: Required: False @@ -131,8 +271,8 @@ When version history limits are managed manually (`EnableAutoExpirationVersionTr PARAMVALUE: Int32 ```yaml -Type: System.Int32 -Parameter Sets: (All) +Type: Int32 +Parameter Sets: SetPolicy Aliases: Required: False @@ -150,8 +290,8 @@ When version history limits are managed manually (`EnableAutoExpirationVersionTr PARAMVALUE: Int32 ```yaml -Type: System.Int32 -Parameter Sets: (All) +Type: Int32 +Parameter Sets: SetPolicy Aliases: Required: False @@ -161,6 +301,23 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RemoveVersionExpirationFileTypeOverride +An array of file type names. Removes the version history limits to a set of file types so that they will follow the default version history limits. + + + +```yaml +Type: String[] +Parameter Sets: RemovePolicy +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Site > Applicable: SharePoint Online @@ -179,6 +336,36 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -Sync +Apply the version history limits of the tenant or the site (if the site this document library is in has broken inheritance for version history limits). + +You may use the following parameters in combination to update only the default policy or a set of file type overrides: + +- ExcludeDefaultPolicy: if set, it will not update the default policy. + +- FileTypes: + + - if set, it will update the specified file types; + + - if not set, it will update all file type overrides; + + - if set to an empty array (i.e. `@()`), it will not update any file type overrides. + +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + +```yaml +Type: SwitchParameter +Parameter Sets: SyncPolicy +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). From f92add722cc726511ccf08fdc12145d455a1c58e Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 13:24:10 -0700 Subject: [PATCH 04/31] Learn Editor: Update New-SPOListFileVersionBatchDeleteJob.md --- .../New-SPOListFileVersionBatchDeleteJob.md | 104 ++++++++++++++++++ 1 file changed, 104 insertions(+) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md index aa2629acb..3c3e6083c 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md @@ -37,6 +37,12 @@ New-SPOListFileVersionBatchDeleteJob [-Site] -List -MajorWithMinorVersionsLimit [-WhatIf] [-Confirm] [] ``` +### ByPolicy +``` +New-SPOListFileVersionBatchDeleteJob [-Site] -List [-FileTypes ] + [-ExcludeDefaultPolicy] [-TrimUseListPolicy] [-WhatIf] [-Confirm] [] +``` + ## DESCRIPTION Queues a job to trim versions from a document library. @@ -69,6 +75,46 @@ New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/ Example 3 starts a trim job that will delete file versions in the document library called "Documents" based on the version count limits. +### EXAMPLE 4 + +```powershell +New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -TrimUseListPolicy +``` + +Example 4 starts a trim job that will delete file versions in the document library called "Documents" based on the version history limits of the document library. + +### EXAMPLE 5 + +```powershell +New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -TrimUseListPolicy -FileTypes @("Video", "Audio") +``` + +Example 5 starts a trim job that will delete file versions for video and audio file types, and file versions that do not belong to a file type override in the document library based on the version history limits of the document library. + +### EXAMPLE 6 + +```powershell +New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -TrimUseListPolicy -FileTypes @("Video", "Audio") -ExcludeDefaultPolicy +``` + +Example 6 starts a trim job that will delete file versions for video and audio file types in the document library based on the version history limits of the document library. + +### EXAMPLE 7 + +```powershell +New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -TrimUseListPolicy -ExcludeDefaultPolicy +``` + +Example 7 starts a trim job that will delete file versions for all file types that have a version history limit override in the document library based on the version history limits of the document library. + +### EXAMPLE 8 + +```powershell +New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -TrimUseListPolicy -FileTypes @() +``` + +Example 8 starts a trim job that will delete file versions for all file types that don't have a version history limit override in the document library based on the version history limits of the document library. + ## PARAMETERS ### -Automatic @@ -101,6 +147,47 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -ExcludeDefaultPolicy +Indicates whether to trim versions based on the default version history limits. + +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + +```yaml +Type: SwitchParameter +Parameter Sets: ByPolicy +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -FileTypes +An array of file type names to trim versions. The supported file type names are: + +- Audio + +- OutlookPST + +- Video + + + +```yaml +Type: String[] +Parameter Sets: ByPolicy +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -List The document library name or Id. @@ -180,6 +267,23 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -TrimUseListPolicy +Indicates whether to trim versions by applying the document library's version history limits. + + + +```yaml +Type: SwitchParameter +Parameter Sets: ByPolicy +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -WhatIf Shows what would happen if the cmdlet runs. The cmdlet is not run. From 0cb3db8f84477b7158244737a12008208ba7abd1 Mon Sep 17 00:00:00 2001 From: blarrywang Date: Tue, 12 Aug 2025 13:43:16 -0700 Subject: [PATCH 05/31] Add new cmdlet templates. --- .openpublishing.redirection.ms-ol-sp-ps.json | 15 ++ ...t-SPOSiteManageVersionPolicyJobProgress.md | 60 ++++++ .../New-SPOSiteManageVersionPolicyJob.md | 171 ++++++++++++++++++ .../Remove-SPOSiteManageVersionPolicyJob.md | 91 ++++++++++ 4 files changed, 337 insertions(+) create mode 100644 sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md create mode 100644 sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md create mode 100644 sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md diff --git a/.openpublishing.redirection.ms-ol-sp-ps.json b/.openpublishing.redirection.ms-ol-sp-ps.json index a5867bdbd..fb6a73305 100644 --- a/.openpublishing.redirection.ms-ol-sp-ps.json +++ b/.openpublishing.redirection.ms-ol-sp-ps.json @@ -495,6 +495,11 @@ "redirect_url": "/powershell/module/microsoft.online.sharepoint.powershell/get-spositegroup", "redirect_document_id": true }, + { + "source_path": "sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteManageVersionPolicyJobProgress.md", + "redirect_url": "/powershell/module/microsoft.online.sharepoint.powershell/get-spositemanageversionpolicyjobprogress", + "redirect_document_id": true + }, { "source_path": "sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSitePages.md", "redirect_url": "/powershell/module/microsoft.online.sharepoint.powershell/get-spositepages", @@ -760,6 +765,11 @@ "redirect_url": "/powershell/module/microsoft.online.sharepoint.powershell/new-spositesharingreportjob", "redirect_document_id": true }, + { + "source_path": "sharepoint/sharepoint-ps/sharepoint-online/New-SPOSiteManageVersionPolicyJob.md", + "redirect_url": "/powershell/module/microsoft.online.sharepoint.powershell/new-spositemanageversionpolicyjob", + "redirect_document_id": true + }, { "source_path": "sharepoint/sharepoint-ps/sharepoint-online/Register-SPODataEncryptionPolicy.md", "redirect_url": "/powershell/module/microsoft.online.sharepoint.powershell/register-spodataencryptionpolicy", @@ -915,6 +925,11 @@ "redirect_url": "/powershell/module/microsoft.online.sharepoint.powershell/remove-spositegroup", "redirect_document_id": true }, + { + "source_path": "sharepoint/sharepoint-ps/sharepoint-online/Remove-SPOSiteManageVersionPolicyJob.md", + "redirect_url": "/powershell/module/microsoft.online.sharepoint.powershell/remove-spositemanageversionpolicyjob", + "redirect_document_id": true + }, { "source_path": "sharepoint/sharepoint-ps/sharepoint-online/Remove-SPOSiteScript.md", "redirect_url": "/powershell/module/microsoft.online.sharepoint.powershell/remove-spositescript", diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md new file mode 100644 index 000000000..53f86c478 --- /dev/null +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md @@ -0,0 +1,60 @@ +--- +external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: +schema: 2.0.0 +--- + +# Get-SPOSiteManageVersionPolicyJobProgress + +## SYNOPSIS +{{ Fill in the Synopsis }} + +## SYNTAX + +``` +Get-SPOSiteManageVersionPolicyJobProgress [-Identity] [] +``` + +## DESCRIPTION +{{ Fill in the Description }} + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> {{ Add example code here }} +``` + +{{ Add example description here }} + +## PARAMETERS + +### -Identity +{{ Fill Identity Description }} + +```yaml +Type: SpoSitePipeBind +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind + +## OUTPUTS + +### System.Object +## NOTES + +## RELATED LINKS diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md new file mode 100644 index 000000000..7eb8d38df --- /dev/null +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -0,0 +1,171 @@ +--- +external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: +schema: 2.0.0 +--- + +# New-SPOSiteManageVersionPolicyJob + +## SYNOPSIS +{{ Fill in the Synopsis }} + +## SYNTAX + +### MandatoryTrimOptionalSync +``` +New-SPOSiteManageVersionPolicyJob [-Identity] [-FileTypes ] [-ExcludeDefaultPolicy] + [-TrimUseListPolicy] [-SyncListPolicy] [-WhatIf] [-Confirm] [] +``` + +### MandatorySync +``` +New-SPOSiteManageVersionPolicyJob [-Identity] [-FileTypes ] [-ExcludeDefaultPolicy] + [-SyncListPolicy] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +{{ Fill in the Description }} + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> {{ Add example code here }} +``` + +{{ Add example description here }} + +## PARAMETERS + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ExcludeDefaultPolicy +{{ Fill ExcludeDefaultPolicy Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -FileTypes +{{ Fill FileTypes Description }} + +```yaml +Type: String[] +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Identity +{{ Fill Identity Description }} + +```yaml +Type: SpoSitePipeBind +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + +### -SyncListPolicy +{{ Fill SyncListPolicy Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: MandatoryTrimOptionalSync +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +```yaml +Type: SwitchParameter +Parameter Sets: MandatorySync +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -TrimUseListPolicy +{{ Fill TrimUseListPolicy Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: MandatoryTrimOptionalSync +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind + +## OUTPUTS + +### System.Object +## NOTES + +## RELATED LINKS diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md new file mode 100644 index 000000000..048acf663 --- /dev/null +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md @@ -0,0 +1,91 @@ +--- +external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: +schema: 2.0.0 +--- + +# Remove-SPOSiteManageVersionPolicyJob + +## SYNOPSIS +{{ Fill in the Synopsis }} + +## SYNTAX + +``` +Remove-SPOSiteManageVersionPolicyJob [-Identity] [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION +{{ Fill in the Description }} + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> {{ Add example code here }} +``` + +{{ Add example description here }} + +## PARAMETERS + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Identity +{{ Fill Identity Description }} + +```yaml +Type: SpoSitePipeBind +Parameter Sets: (All) +Aliases: + +Required: True +Position: 0 +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +### Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind + +## OUTPUTS + +### System.Object +## NOTES + +## RELATED LINKS From a5c0fe6b054f877fe4c1f15d3ad46dbf4f20555e Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 14:16:45 -0700 Subject: [PATCH 06/31] Learn Editor: Update New-SPOSiteManageVersionPolicyJob.md --- .../New-SPOSiteManageVersionPolicyJob.md | 162 +++++++++++++++++- 1 file changed, 154 insertions(+), 8 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md index 7eb8d38df..ae2fcd0a5 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -8,7 +8,7 @@ schema: 2.0.0 # New-SPOSiteManageVersionPolicyJob ## SYNOPSIS -{{ Fill in the Synopsis }} +Starts a background job that manages the file versions and version history limits of all of its document libraries. ## SYNTAX @@ -25,16 +25,154 @@ New-SPOSiteManageVersionPolicyJob [-Identity] [-FileTypes {{ Add example code here }} +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -FileTypes @() ``` -{{ Add example description here }} +Apply the site default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. + +### Example 4 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy +``` + +Apply the site version history limits (including file type overrides) to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. + +### Example 5 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -ExcludeDefaultPolicy +``` + +Apply the site level all file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. + +### Example 6 + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy -FileTypes @("Video","Audio") +``` + +Trim video and audio file versions, and the file versions that don't have a file type override, based on each document library's version history limits. + +### Example 7 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy +``` + +Trim video and audio file versions based on each document library's version history limits. + +### Example 8 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy -FileTypes @() +``` + +Trim file versions that don't have a file type override based on each document library's version history limits. + +### Example 9 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy +``` + +Trim all file versions based on each document library's version history limits. + +### Example 10 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy -ExcludeDefaultPolicy +``` + +Trim all file versions that have a file type override based on each document library's version history limits. + + +### Example 11 + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -FileTypes @("Video","Audio") +``` + +Apply the site video, audio, and default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim video and audio file versions, and the file versions that don't have a file type override, based on each document library's version history limits. + +### Example 12 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -TrimUseListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy +``` + +Apply the site video, audio version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim video and audio file versions based on each document library's version history limits. + +### Example 13 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -TrimUseListPolicy -FileTypes @() +``` + +Apply the site default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim file versions that don't have a file type override based on each document library's version history limits. + +### Example 14 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -TrimUseListPolicy +``` + +Apply the site version history limits (including file type overrides) to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim all file versions based on each document library's version history limits. + +### Example 15 + + +```powershell +New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -TrimUseListPolicy -ExcludeDefaultPolicy +``` + +Apply the site level all file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim all file versions that have a file type override based on each document library's version history limits. ## PARAMETERS @@ -54,7 +192,7 @@ Accept wildcard characters: False ``` ### -ExcludeDefaultPolicy -{{ Fill ExcludeDefaultPolicy Description }} +Indicates whether to update the default version history limits and/or to trim file versions that don't have an override. ```yaml Type: SwitchParameter @@ -69,7 +207,13 @@ Accept wildcard characters: False ``` ### -FileTypes -{{ Fill FileTypes Description }} +An array of file type names. The supported file type names are: + +- Audio + +- OutlookPST + +- Video ```yaml Type: String[] @@ -99,7 +243,7 @@ Accept wildcard characters: False ``` ### -SyncListPolicy -{{ Fill SyncListPolicy Description }} +Indicates whether to update all of the document libraries' version history limits to that of the site. Or if the site is not broken inheritance for version history limits, then it applies the tenant version history limits. ```yaml Type: SwitchParameter @@ -126,7 +270,7 @@ Accept wildcard characters: False ``` ### -TrimUseListPolicy -{{ Fill TrimUseListPolicy Description }} +Indicates whether to trim existing versions. ```yaml Type: SwitchParameter @@ -169,3 +313,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## NOTES ## RELATED LINKS +[Get-SPOSiteManageVersionPolicyJobProgress](Get-SPOSiteManageVersionPolicyJobProgress.md) +[Remove-SPOSiteManageVersionPolicyJob](Remove-SPOSiteManageVersionPolicyJob.md) \ No newline at end of file From 247cdf89eec7ea97c6aa80fa59c2bbf70f7482f8 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 14:23:48 -0700 Subject: [PATCH 07/31] Learn Editor: Update Get-SPOSiteManageVersionPolicyJobProgress.md --- ...t-SPOSiteManageVersionPolicyJobProgress.md | 23 ++++++++++++++----- 1 file changed, 17 insertions(+), 6 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md index 53f86c478..5afe672ae 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md @@ -8,7 +8,10 @@ schema: 2.0.0 # Get-SPOSiteManageVersionPolicyJobProgress ## SYNOPSIS -{{ Fill in the Synopsis }} +Gets the status and progress for background jobs started by [`New-SPOSiteManageVersionPolicyJob`](). + +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. ## SYNTAX @@ -17,21 +20,25 @@ Get-SPOSiteManageVersionPolicyJobProgress [-Identity] [ {{ Add example code here }} + +``` +Get-SPOSiteManageVersionPolicyJobProgress https://contoso.sharepoint.com/sites/site1 ``` -{{ Add example description here }} +Gets the progress of the site manage version policy job for the site. ## PARAMETERS ### -Identity -{{ Fill Identity Description }} + +> Applicable: SharePoint Online + +Specifies the URL of the site collection. ```yaml Type: SpoSitePipeBind @@ -58,3 +65,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## NOTES ## RELATED LINKS + +[New-SPOSiteManageVersionPolicyJob](New-SPOSiteManageVersionPolicyJob.md) + +[Remove-SPOSiteManageVersionPolicyJob](Remove-SPOSiteManageVersionPolicyJob.md) From f78c775983e8373c7c38ef4f61452fbcbf3fe9ae Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 14:27:34 -0700 Subject: [PATCH 08/31] Learn Editor: Update Remove-SPOSiteManageVersionPolicyJob.md --- .../Remove-SPOSiteManageVersionPolicyJob.md | 20 +++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md index 048acf663..974325868 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md @@ -8,25 +8,29 @@ schema: 2.0.0 # Remove-SPOSiteManageVersionPolicyJob ## SYNOPSIS -{{ Fill in the Synopsis }} +Stops further processing of site manage version policy job that is in-progress. + +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. ## SYNTAX -``` +```powershell Remove-SPOSiteManageVersionPolicyJob [-Identity] [-WhatIf] [-Confirm] [] ``` ## DESCRIPTION -{{ Fill in the Description }} +Stops further processing of site manage version policy job that is in-progress. ## EXAMPLES ### Example 1 + ```powershell -PS C:\> {{ Add example code here }} +Remove-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 ``` -{{ Add example description here }} +Stops further processing of site manage version policy job ## PARAMETERS @@ -46,7 +50,9 @@ Accept wildcard characters: False ``` ### -Identity -{{ Fill Identity Description }} +> Applicable: SharePoint Online + +Specifies the URL of the site collection. ```yaml Type: SpoSitePipeBind @@ -89,3 +95,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## NOTES ## RELATED LINKS +[Get-SPOSiteManageVersionPolicyJobProgress](Get-SPOSiteManageVersionPolicyJobProgress.md) +[New-SPOSiteManageVersionPolicyJob](New-SPOSiteManageVersionPolicyJob.md) \ No newline at end of file From 76103d0e31f0ca641a85c353b52bef3b81407575 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 14:28:37 -0700 Subject: [PATCH 09/31] Learn Editor: Update New-SPOSiteManageVersionPolicyJob.md --- .../New-SPOSiteManageVersionPolicyJob.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md index ae2fcd0a5..4cc307383 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -10,10 +10,13 @@ schema: 2.0.0 ## SYNOPSIS Starts a background job that manages the file versions and version history limits of all of its document libraries. +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + ## SYNTAX ### MandatoryTrimOptionalSync -``` +```powershell New-SPOSiteManageVersionPolicyJob [-Identity] [-FileTypes ] [-ExcludeDefaultPolicy] [-TrimUseListPolicy] [-SyncListPolicy] [-WhatIf] [-Confirm] [] ``` From a968deca28ec962740905e96b094396cf74943c4 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 14:29:51 -0700 Subject: [PATCH 10/31] Learn Editor: Update New-SPOListFileVersionBatchDeleteJob.md --- .../New-SPOListFileVersionBatchDeleteJob.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md index 3c3e6083c..e25b8697b 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md @@ -176,6 +176,8 @@ An array of file type names to trim versions. The supported file type names are: +- + ```yaml Type: String[] Parameter Sets: ByPolicy @@ -272,6 +274,8 @@ Indicates whether to trim versions by applying the document library's version hi + + ```yaml Type: SwitchParameter Parameter Sets: ByPolicy From a1b170efdfafdf0912393859802d2897aa069128 Mon Sep 17 00:00:00 2001 From: blarrywang Date: Tue, 12 Aug 2025 14:42:06 -0700 Subject: [PATCH 11/31] Add table of content. --- .../Microsoft.Online.SharePoint.PowerShell.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Microsoft.Online.SharePoint.PowerShell.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Microsoft.Online.SharePoint.PowerShell.md index fe2ee5d96..491a2fd52 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Microsoft.Online.SharePoint.PowerShell.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Microsoft.Online.SharePoint.PowerShell.md @@ -309,6 +309,9 @@ Gets the status for a file version expiration report generation job for a site c ### [Get-SPOSiteGroup](Get-SPOSiteGroup.md) Gets all the groups on the specified site collection. +### [Get-SPOSiteManageVersionPolicyJobProgress](Get-SPOSiteManageVersionPolicyJobProgress.md) +Gets the status and progress for site manage version policy jobs. + ### [Get-SPOSitePages](Get-SPOSitePages.md) This cmdlet allows you to retrieve all SharePoint pages under a specific SharePoint site. @@ -459,6 +462,9 @@ Generates a version storage usage report for a site collection. This report can ### [New-SPOSiteGroup](New-SPOSiteGroup.md) Creates a new group in a SharePoint Online site collection. +### [New-SPOSiteManageVersionPolicyJob](New-SPOSiteManageVersionPolicyJob.md) +Starts a background job that manages the file versions and version history limits of all of its document libraries. + ### [New-SPOSiteSharingReportJob](New-SPOSiteSharingReportJob.md) Creates a new sharing report job. @@ -558,6 +564,9 @@ Stops further processing of site level trim job that is in-progress. ### [Remove-SPOSiteGroup](Remove-SPOSiteGroup.md) Removes a SharePoint Online group from a site collection. +### [Remove-SPOSiteManageVersionPolicyJob](Remove-SPOSiteManageVersionPolicyJob.md) +Stops further processing of site manage version policy job that is in-progress. + ### [Remove-SPOSiteScript](Remove-SPOSiteScript.md) Removes a site script. From 5261728cc5fb8e930c4482a3cfb0fbd7c8508b52 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 14:48:51 -0700 Subject: [PATCH 12/31] Learn Editor: Update Get-SPOSiteManageVersionPolicyJobProgress.md --- .../Get-SPOSiteManageVersionPolicyJobProgress.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md index 5afe672ae..9ff48f460 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md @@ -8,9 +8,7 @@ schema: 2.0.0 # Get-SPOSiteManageVersionPolicyJobProgress ## SYNOPSIS -Gets the status and progress for background jobs started by [`New-SPOSiteManageVersionPolicyJob`](). - -> [!NOTE] +Gets the status and progress for background jobs started by `New-SPOSiteManageVersionPolicyJob`.> [!NOTE] > This feature is currently in preview and may not be available in your tenant. ## SYNTAX @@ -20,7 +18,7 @@ Get-SPOSiteManageVersionPolicyJobProgress [-Identity] [ Date: Tue, 12 Aug 2025 14:52:37 -0700 Subject: [PATCH 13/31] Fix spacing. --- .../Get-SPOSiteManageVersionPolicyJobProgress.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md index 9ff48f460..fe1242b08 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md @@ -8,7 +8,8 @@ schema: 2.0.0 # Get-SPOSiteManageVersionPolicyJobProgress ## SYNOPSIS -Gets the status and progress for background jobs started by `New-SPOSiteManageVersionPolicyJob`.> [!NOTE] +Gets the status and progress for background jobs started by `New-SPOSiteManageVersionPolicyJob`. +> [!NOTE] > This feature is currently in preview and may not be available in your tenant. ## SYNTAX From d0ba448d2a8d0bb4a31d94c920d785c1cde9332e Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 14:58:00 -0700 Subject: [PATCH 14/31] Learn Editor: Update New-SPOSiteManageVersionPolicyJob.md --- .../New-SPOSiteManageVersionPolicyJob.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md index 4cc307383..143c6731a 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -30,7 +30,7 @@ New-SPOSiteManageVersionPolicyJob [-Identity] [-FileTypes Applicable: SharePoint Online + +Specifies the URL of the site collection. ```yaml Type: SpoSitePipeBind From 9d98113534af70e226130bb7c8e227c816a81897 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 15:00:03 -0700 Subject: [PATCH 15/31] Learn Editor: Update New-SPOSiteManageVersionPolicyJob.md --- .../New-SPOSiteManageVersionPolicyJob.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md index 143c6731a..6890847f9 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -47,7 +47,7 @@ This effect can be applied to default version history limits, or a set of file t ### Example 1 ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -FileTypes @("Video","Audio") +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -FileTypes @("Video","Audio") ``` Apply the site video, audio, and default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. @@ -56,7 +56,7 @@ Apply the site video, audio, and default version history limits to existing docu ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy ``` Apply the site video, audio version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. @@ -65,7 +65,7 @@ Apply the site video, audio version history limits to existing document librarie ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -FileTypes @() +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -FileTypes @() ``` Apply the site default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. @@ -74,7 +74,7 @@ Apply the site default version history limits to existing document libraries. If ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy ``` Apply the site version history limits (including file type overrides) to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. @@ -83,7 +83,7 @@ Apply the site version history limits (including file type overrides) to existin ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -ExcludeDefaultPolicy +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -ExcludeDefaultPolicy ``` Apply the site level all file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. @@ -91,7 +91,7 @@ Apply the site level all file type version history limit overrides to existing d ### Example 6 ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy -FileTypes @("Video","Audio") +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy -FileTypes @("Video","Audio") ``` Trim video and audio file versions, and the file versions that don't have a file type override, based on each document library's version history limits. @@ -100,7 +100,7 @@ Trim video and audio file versions, and the file versions that don't have a file ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy ``` Trim video and audio file versions based on each document library's version history limits. @@ -109,7 +109,7 @@ Trim video and audio file versions based on each document library's version hist ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy -FileTypes @() +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy -FileTypes @() ``` Trim file versions that don't have a file type override based on each document library's version history limits. @@ -118,7 +118,7 @@ Trim file versions that don't have a file type override based on each document l ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy ``` Trim all file versions based on each document library's version history limits. @@ -127,7 +127,7 @@ Trim all file versions based on each document library's version history limits. ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -TrimUseListPolicy -ExcludeDefaultPolicy +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy -ExcludeDefaultPolicy ``` Trim all file versions that have a file type override based on each document library's version history limits. @@ -136,7 +136,7 @@ Trim all file versions that have a file type override based on each document lib ### Example 11 ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -FileTypes @("Video","Audio") +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -FileTypes @("Video","Audio") ``` Apply the site video, audio, and default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim video and audio file versions, and the file versions that don't have a file type override, based on each document library's version history limits. @@ -145,7 +145,7 @@ Apply the site video, audio, and default version history limits to existing docu ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -TrimUseListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -TrimUseListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy ``` Apply the site video, audio version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim video and audio file versions based on each document library's version history limits. @@ -154,7 +154,7 @@ Apply the site video, audio version history limits to existing document librarie ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -TrimUseListPolicy -FileTypes @() +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -TrimUseListPolicy -FileTypes @() ``` Apply the site default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim file versions that don't have a file type override based on each document library's version history limits. @@ -163,7 +163,7 @@ Apply the site default version history limits to existing document libraries. If ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -TrimUseListPolicy +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -TrimUseListPolicy ``` Apply the site version history limits (including file type overrides) to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim all file versions based on each document library's version history limits. @@ -172,7 +172,7 @@ Apply the site version history limits (including file type overrides) to existin ```powershell -New-SPOSiteManageVersionPolicyJob -Identity $siteUrl -SyncListPolicy -TrimUseListPolicy -ExcludeDefaultPolicy +New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -TrimUseListPolicy -ExcludeDefaultPolicy ``` Apply the site level all file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim all file versions that have a file type override based on each document library's version history limits. From 73f3df83b98d37a2fabc1d276ab6f398501ac6fe Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Tue, 12 Aug 2025 15:05:27 -0700 Subject: [PATCH 16/31] Learn Editor: Update New-SPOListFileVersionBatchDeleteJob.md --- .../New-SPOListFileVersionBatchDeleteJob.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md index e25b8697b..8c827a3c9 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md @@ -176,7 +176,7 @@ An array of file type names to trim versions. The supported file type names are: -- + ```yaml Type: String[] @@ -276,6 +276,8 @@ Indicates whether to trim versions by applying the document library's version hi + + ```yaml Type: SwitchParameter Parameter Sets: ByPolicy From f47f05075f0af5e70bf0b2ac9ed80da430b9a37c Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Wed, 13 Aug 2025 11:34:38 -0700 Subject: [PATCH 17/31] Learn Editor: Update New-SPOSiteManageVersionPolicyJob.md --- .../New-SPOSiteManageVersionPolicyJob.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md index 6890847f9..4e3fe698e 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -86,7 +86,7 @@ Apply the site version history limits (including file type overrides) to existin New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -ExcludeDefaultPolicy ``` -Apply the site level all file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. +Apply all site file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. ### Example 6 @@ -175,7 +175,7 @@ Apply the site version history limits (including file type overrides) to existin New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -TrimUseListPolicy -ExcludeDefaultPolicy ``` -Apply the site level all file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim all file versions that have a file type override based on each document library's version history limits. +Apply all site file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim all file versions that have a file type override based on each document library's version history limits. ## PARAMETERS From 9311a7152066483c4889de3aff72c31ae66f4a15 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Wed, 13 Aug 2025 11:35:32 -0700 Subject: [PATCH 18/31] Learn Editor: Update Remove-SPOSiteManageVersionPolicyJob.md --- .../Remove-SPOSiteManageVersionPolicyJob.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md index 974325868..cc4b87217 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md @@ -30,7 +30,7 @@ Stops further processing of site manage version policy job that is in-progress. Remove-SPOSiteFileVersionBatchDeleteJob -Identity https://contoso.sharepoint.com/sites/site1 ``` -Stops further processing of site manage version policy job +Stops further processing of site manage version policy job. ## PARAMETERS From 78e2d95ea60139facaa015be3b5830a73d5e9703 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Wed, 13 Aug 2025 11:43:15 -0700 Subject: [PATCH 19/31] Learn Editor: Update Set-SPOTenant.md --- .../Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md index 7d2463ca2..6768cd329 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md @@ -4517,14 +4517,10 @@ Accept wildcard characters: False An array of file type names. Removes the version history limits to a set of file types so that they will follow the default version history limits. The version history limits are applied on new document libraries in the tenant. - > [!NOTE] > This feature is currently in preview and may not be available in your tenant. -YAML - - -``` +```yaml Type: String[] Parameter Sets: (All) Aliases: From 05120fa93a46f8a6cfaa3da7e3fa4cca6fe84e3c Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Wed, 13 Aug 2025 11:47:25 -0700 Subject: [PATCH 20/31] Learn Editor: Update Set-SPOTenant.md --- .../Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md index 6768cd329..3e620ae62 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md @@ -4514,7 +4514,7 @@ Accept wildcard characters: False ### -RemoveVersionExpirationFileTypeOverride -An array of file type names. Removes the version history limits to a set of file types so that they will follow the default version history limits. +An array of file type names. Removes the version history limit override from a set of file types so that they will follow the default version history limits. The version history limits are applied on new document libraries in the tenant. > [!NOTE] From 350a8f0c8551c19abfd07c44fafe74ab3605b7fc Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Wed, 13 Aug 2025 11:52:30 -0700 Subject: [PATCH 21/31] Learn Editor: Update Set-SPOSite.md --- .../Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md index 79c1b87fd..bdf742a8c 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md @@ -159,7 +159,7 @@ Set-SPOSite [-Identity] [-InformationBarriersMode ] [- ``` Set-SPOSite [-Identity] [-InformationBarriersMode ] [-ApplyToNewDocumentLibraries] - [-RemoveVersionExpirationFileTypeOverride ] [-WhatIf] [-Confirm] [] + -RemoveVersionExpirationFileTypeOverride [-WhatIf] [-Confirm] [] ``` ### ClearGroupId From de9c9fbe77d2472c028d58ee0bea7bb2eb365754 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Wed, 13 Aug 2025 11:57:57 -0700 Subject: [PATCH 22/31] Learn Editor: Update Set-SPOSite.md --- .../Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md index bdf742a8c..f66b3039e 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md @@ -1821,7 +1821,7 @@ Type: String[] Parameter Sets: RemoveSiteFileVersionPolicy Aliases: -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False From 6e83ced68a482707018e763b6d17dbe1d5ae7ee5 Mon Sep 17 00:00:00 2001 From: blarrywangmsft <129248125+blarrywangmsft@users.noreply.github.com> Date: Wed, 13 Aug 2025 12:03:45 -0700 Subject: [PATCH 23/31] Learn Editor: Update Set-SPOListVersionPolicy.md --- .../Set-SPOListVersionPolicy.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md index 6e3c93f76..a8496977b 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md @@ -302,9 +302,7 @@ Accept wildcard characters: False ``` ### -RemoveVersionExpirationFileTypeOverride -An array of file type names. Removes the version history limits to a set of file types so that they will follow the default version history limits. - - +An array of file type names. Removes the version history limit override from a set of file types so that they will follow the default version history limits. ```yaml Type: String[] From c503692e1941c788eec60a617ae1d223a0755c8f Mon Sep 17 00:00:00 2001 From: blarrywang Date: Thu, 14 Aug 2025 10:50:53 -0700 Subject: [PATCH 24/31] Add metadata. --- .../Get-SPOSiteManageVersionPolicyJobProgress.md | 8 +++++++- .../New-SPOSiteManageVersionPolicyJob.md | 8 +++++++- .../Remove-SPOSiteManageVersionPolicyJob.md | 8 +++++++- 3 files changed, 21 insertions(+), 3 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md index fe1242b08..2fed1060f 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md @@ -1,8 +1,14 @@ --- external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell -online version: +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-spositemanageversionpolicyjobprogress +applicable: SharePoint Online +title: Get-SPOSiteManageVersionPolicyJobProgress schema: 2.0.0 +author: blarrywangmsft +ms.author: blarrywang +ms.reviewer: +manager: yigitd --- # Get-SPOSiteManageVersionPolicyJobProgress diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md index 4cc307383..1cfb37274 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -1,8 +1,14 @@ --- external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell -online version: +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/new-spositemanageversionpolicyjob +applicable: SharePoint Online +title: New-SPOSiteManageVersionPolicyJob schema: 2.0.0 +author: blarrywangmsft +ms.author: blarrywang +ms.reviewer: +manager: yigitd --- # New-SPOSiteManageVersionPolicyJob diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md index 974325868..c5bbfd552 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md @@ -1,8 +1,14 @@ --- external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell -online version: +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/remove-spositemanageversionpolicyjob +applicable: SharePoint Online +title: Remove-SPOSiteManageVersionPolicyJob schema: 2.0.0 +author: blarrywangmsft +ms.author: blarrywang +ms.reviewer: +manager: yigitd --- # Remove-SPOSiteManageVersionPolicyJob From a80a1a2e56837ec479662303039cd7c82961de96 Mon Sep 17 00:00:00 2001 From: blarrywang Date: Thu, 14 Aug 2025 11:12:10 -0700 Subject: [PATCH 25/31] Address comments. --- ...t-SPOSiteManageVersionPolicyJobProgress.md | 6 +-- .../Microsoft.Online.SharePoint.PowerShell.md | 4 +- .../New-SPOListFileVersionBatchDeleteJob.md | 11 ----- .../New-SPOSiteManageVersionPolicyJob.md | 2 +- .../Remove-SPOSiteManageVersionPolicyJob.md | 4 +- .../Set-SPOListVersionPolicy.md | 25 +++------- .../Set-SPOSite.md | 49 +++++++------------ .../Set-SPOTenant.md | 18 ++----- 8 files changed, 36 insertions(+), 83 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md index 2fed1060f..f766a5370 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md @@ -14,7 +14,7 @@ manager: yigitd # Get-SPOSiteManageVersionPolicyJobProgress ## SYNOPSIS -Gets the status and progress for background jobs started by `New-SPOSiteManageVersionPolicyJob`. +Gets the status and progress for a background job started by `New-SPOSiteManageVersionPolicyJob`. > [!NOTE] > This feature is currently in preview and may not be available in your tenant. @@ -25,7 +25,7 @@ Get-SPOSiteManageVersionPolicyJobProgress [-Identity] [ [!NOTE] > This feature is currently in preview and may not be available in your tenant. diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md index c5bbfd552..b4e8d1927 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md @@ -14,7 +14,7 @@ manager: yigitd # Remove-SPOSiteManageVersionPolicyJob ## SYNOPSIS -Stops further processing of site manage version policy job that is in-progress. +Stops processing of the in-progress manage version policy job for the given site. > [!NOTE] > This feature is currently in preview and may not be available in your tenant. @@ -26,7 +26,7 @@ Remove-SPOSiteManageVersionPolicyJob [-Identity] [-WhatIf] [-C ``` ## DESCRIPTION -Stops further processing of site manage version policy job that is in-progress. +Stops processing of the in-progress manage version policy job for the given site. ## EXAMPLES diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md index 6e3c93f76..b8d15ff07 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md @@ -216,24 +216,16 @@ Accept wildcard characters: False > Applicable: SharePoint Online An array of file type names. The supported file type names are: - - Audio - - OutlookPST - - Video Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: +- [EnableAutoExpirationVersionTrim](#-EnableAutoExpirationVersionTrim) +- [MajorVersionLimit](#-MajorVersionLimit) +- [ExpireVersionsAfterDays](#-ExpireVersionsAfterDays) -- EnableAutoExpirationVersionTrim - -- MajorVersionLimit - -- ExpireVersionsAfterDays - -Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the **Sync** parameter. For more information about this option, please refer to the documentation for the **Sync** parameter. - - +Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the [Sync](#-Sync) parameter. For more information about this option, please refer to the documentation for the [Sync](#-Sync) parameter. ```yaml Type: String[] @@ -340,15 +332,10 @@ Accept wildcard characters: False Apply the version history limits of the tenant or the site (if the site this document library is in has broken inheritance for version history limits). You may use the following parameters in combination to update only the default policy or a set of file type overrides: - -- ExcludeDefaultPolicy: if set, it will not update the default policy. - -- FileTypes: - +- [ExcludeDefaultPolicy](#-ExcludeDefaultPolicy): if set, it will not update the default policy. +- [FileTypes](#-FileTypes): - if set, it will update the specified file types; - - if not set, it will update all file type overrides; - - if set to an empty array (i.e. `@()`), it will not update any file type overrides. > [!NOTE] diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md index 79c1b87fd..3e1abf06e 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md @@ -149,14 +149,12 @@ Set-SPOSite [-Identity] [-InformationBarriersMode ] ### SetSiteFileTypeFileVersionPolicy - ``` Set-SPOSite [-Identity] [-InformationBarriersMode ] [-EnableAutoExpirationVersionTrim ] [-ExpireVersionsAfterDays ] [-MajorVersionLimit ] -FileTypesForVersionExpiration [-ApplyToNewDocumentLibraries] [-WhatIf] [-Confirm] [] ``` ### RemoveSiteFileVersionPolicy - ``` Set-SPOSite [-Identity] [-InformationBarriersMode ] [-ApplyToNewDocumentLibraries] [-RemoveVersionExpirationFileTypeOverride ] [-WhatIf] [-Confirm] [] @@ -273,7 +271,7 @@ In this example, an authentication context called MFA is attached to the site. Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $true ``` -Example 11 sets automatic version history limits at site level. Automatic setting will be applied to all new document libraries created in the site and a background request will be created to asynchronously process the update on existing document libraries that have versioning enabled. +Example 11 sets automatic version history limits at the site level. Automatic setting will be applied to all new document libraries created in the site and a background request will be created to asynchronously process the update on existing document libraries that have versioning enabled. ### EXAMPLE 12 @@ -281,7 +279,7 @@ Example 11 sets automatic version history limits at site level. Automatic settin Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 30 ``` -Example 12 sets manual version history limits at site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting. Also it creates a job to set this manual version setting for existing document libraries that enabled versioning. +Example 12 sets manual version history limits at the site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting. Also it creates a job to set this manual version setting for existing document libraries that enabled versioning. ### EXAMPLE 13 @@ -289,7 +287,7 @@ Example 12 sets manual version history limits at site level by limiting the numb Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 0 ``` -Example 13 sets manual version history limits at site level by limiting the number of versions with no time limits. The new document libraries will use this version setting. Also it creates a job to set this manual version setting for existing document libraries that enabled versioning. +Example 13 sets manual version history limits at the site level by limiting the number of versions with no time limits. The new document libraries will use this version setting. Also it creates a job to set this manual version setting for existing document libraries that enabled versioning. ### Example 14 @@ -297,7 +295,7 @@ Example 13 sets manual version history limits at site level by limiting the numb Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $true -ApplyToNewDocumentLibraries ``` -Example 14 sets automatic version history limits at site level. The new document libraries will use this version setting. +Example 14 sets automatic version history limits at the site level. The new document libraries will use this version setting. ### EXAMPLE 15 @@ -305,7 +303,7 @@ Example 14 sets automatic version history limits at site level. The new document Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -ExpireVersionsAfterDays 30 -ApplyToNewDocumentLibraries ``` -Example 15 sets manual version history limits at site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting. +Example 15 sets manual version history limits at the site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting. ### EXAMPLE 16 @@ -313,7 +311,7 @@ Example 15 sets manual version history limits at site level by limiting the numb Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -ExpireVersionsAfterDays 0 -ApplyToNewDocumentLibraries ``` -Example 16 sets manual version history limits at site level by limiting the number of versions with no time limits. The new document libraries will use this version setting. +Example 16 sets manual version history limits at the site level by limiting the number of versions with no time limits. The new document libraries will use this version setting. ### Example 17 @@ -345,7 +343,7 @@ Example 19 creates a request to set manual version history limits that limits th Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -InheritVersionPolicyFromTenant ``` -Example 20 clears the file version setting at site level. The new document libraries will use the Tenant Level setting. It won't impact the existing document libraries. +Example 20 clears the file version setting at the site level. The new document libraries will use the Tenant Level setting. It won't impact the existing document libraries. ### Example 21 @@ -354,7 +352,7 @@ Example 20 clears the file version setting at site level. The new document libra Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpirationVersionTrim $true -FileTypesForVersionExpiration @("Video", "Audio") -ApplyToNewDocumentLibraries ``` -Example 21 sets automatic version history limit override for video and audio file types at site level. The new document libraries will use this version setting. +Example 21 sets automatic version history limit override for video and audio file types at the site level. The new document libraries will use this version setting. ### Example 22 @@ -364,7 +362,7 @@ Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpi -FileTypesForVersionExpiration @("Video", "Audio") -ApplyToNewDocumentLibraries ``` -Example 22 sets manual version history limit override for video and audio file types at site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting. +Example 22 sets manual version history limit override for video and audio file types at the site level by limiting the number of versions and the time (in days) versions are kept. The new document libraries will use this version setting. ### Example 23 @@ -374,7 +372,7 @@ Set-SPOSite -Identity https://contoso.sharepoint.com/sites/site1 -EnableAutoExpi -FileTypesForVersionExpiration @("Video", "Audio") -ApplyToNewDocumentLibraries ``` -Example 23 sets manual version history limit override for video and audio file types at site level by limiting the number of versions with no time limits. The new document libraries will use this version setting. +Example 23 sets manual version history limit override for video and audio file types at the site level by limiting the number of versions with no time limits. The new document libraries will use this version setting. ### Example 24 @@ -581,8 +579,7 @@ Accept pipeline input: False Accept wildcard characters: False ``` - -``` +```yaml Type: SwitchParameter Parameter Sets: SetSiteFileTypeFileVersionPolicy Aliases: @@ -1241,27 +1238,18 @@ Accept wildcard characters: False > Applicable: SharePoint Online An array of file type names. The supported file type names are: - - Audio - - OutlookPST - - Video Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: +- [EnableAutoExpirationVersionTrim](#-EnableAutoExpirationVersionTrim) +- [MajorVersionLimit](#-MajorVersionLimit) +- [ExpireVersionsAfterDays](#-ExpireVersionsAfterDays) -- EnableAutoExpirationVersionTrim - -- MajorVersionLimit +This must be used with [ApplyToNewDocumentLibraries](#-ApplyToNewDocumentLibraries) switch set to true, because the version history limits are only applied on new document libraries in the site. -- ExpireVersionsAfterDays - -This must be used with **ApplyToNewDocumentLibraries** switch set to true, because the version history limits are only applied on new document libraries in the site. - - - - -``` +```yaml Type: String[] Parameter Sets: SetSiteFileTypeFileVersionPolicy Aliases: @@ -1375,7 +1363,7 @@ Accept wildcard characters: False > Applicable: SharePoint Online -Clear the file version setting at site level. The new document libraries will use the Tenant Level setting. It won't impact the existing document libraries. +Clear the file version setting at the site level. The new document libraries will use the Tenant Level setting. It won't impact the existing document libraries. ```yaml Type: System.Management.Automation.SwitchParameter @@ -1810,12 +1798,11 @@ Accept wildcard characters: False An array of file type names. Removes the version history limits to a set of file types so that they will follow the default version history limits. -This must be used with **ApplyToNewDocumentLibraries** switch set to true, because the version history limits are only applied on new document libraries in the site. +This must be used with [ApplyToNewDocumentLibraries](#-ApplyToNewDocumentLibraries) switch set to true, because the version history limits are only applied on new document libraries in the site. > [!NOTE] > This feature is currently in preview and may not be available in your tenant. - ```yaml Type: String[] Parameter Sets: RemoveSiteFileVersionPolicy diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md index 7d2463ca2..7c2888116 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md @@ -3170,27 +3170,20 @@ Accept wildcard characters: False ### -FileTypesForVersionExpiration An array of file type names. The supported file type names are: - - Audio - - OutlookPST - - Video Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: - -- EnableAutoExpirationVersionTrim - -- MajorVersionLimit - -- ExpireVersionsAfterDays +- [EnableAutoExpirationVersionTrim](#-EnableAutoExpirationVersionTrim) +- [MajorVersionLimit](#-MajorVersionLimit) +- [ExpireVersionsAfterDays](#-ExpireVersionsAfterDays) The version history limits are applied on new document libraries in the tenant. > [!NOTE] > This feature is currently in preview and may not be available in your tenant. - ```yaml Type: String[] Parameter Sets: (All) @@ -4521,10 +4514,7 @@ The version history limits are applied on new document libraries in the tenant. > [!NOTE] > This feature is currently in preview and may not be available in your tenant. -YAML - - -``` +```yaml Type: String[] Parameter Sets: (All) Aliases: From 168b839b4fbdc38de75a576985f957d8621227c1 Mon Sep 17 00:00:00 2001 From: blarrywang Date: Thu, 14 Aug 2025 11:19:18 -0700 Subject: [PATCH 26/31] Update bookmarks. --- .../Set-SPOListVersionPolicy.md | 12 ++++++------ .../Set-SPOSite.md | 10 +++++----- .../Set-SPOTenant.md | 6 +++--- 3 files changed, 14 insertions(+), 14 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md index 0d73aa9f5..c25f78709 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md @@ -221,11 +221,11 @@ An array of file type names. The supported file type names are: - Video Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: -- [EnableAutoExpirationVersionTrim](#-EnableAutoExpirationVersionTrim) -- [MajorVersionLimit](#-MajorVersionLimit) -- [ExpireVersionsAfterDays](#-ExpireVersionsAfterDays) +- [EnableAutoExpirationVersionTrim](#-enableautoexpirationversiontrim) +- [MajorVersionLimit](#-majorversionlimit) +- [ExpireVersionsAfterDays](#-expireversionsafterdays) -Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the [Sync](#-Sync) parameter. For more information about this option, please refer to the documentation for the [Sync](#-Sync) parameter. +Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the [Sync](#-sync) parameter. For more information about this option, please refer to the documentation for the [Sync](#-sync) parameter. ```yaml Type: String[] @@ -330,8 +330,8 @@ Accept wildcard characters: False Apply the version history limits of the tenant or the site (if the site this document library is in has broken inheritance for version history limits). You may use the following parameters in combination to update only the default policy or a set of file type overrides: -- [ExcludeDefaultPolicy](#-ExcludeDefaultPolicy): if set, it will not update the default policy. -- [FileTypes](#-FileTypes): +- [ExcludeDefaultPolicy](#-excludedefaultpolicy): if set, it will not update the default policy. +- [FileTypes](#-filetypes): - if set, it will update the specified file types; - if not set, it will update all file type overrides; - if set to an empty array (i.e. `@()`), it will not update any file type overrides. diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md index 57be10026..cb34cb384 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md @@ -1243,11 +1243,11 @@ An array of file type names. The supported file type names are: - Video Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: -- [EnableAutoExpirationVersionTrim](#-EnableAutoExpirationVersionTrim) -- [MajorVersionLimit](#-MajorVersionLimit) -- [ExpireVersionsAfterDays](#-ExpireVersionsAfterDays) +- [EnableAutoExpirationVersionTrim](#-enableautoexpirationversiontrim) +- [MajorVersionLimit](#-majorversionlimit) +- [ExpireVersionsAfterDays](#-expireversionsafterdays) -This must be used with [ApplyToNewDocumentLibraries](#-ApplyToNewDocumentLibraries) switch set to true, because the version history limits are only applied on new document libraries in the site. +This must be used with [ApplyToNewDocumentLibraries](#-applytonewdocumentlibraries) switch set to true, because the version history limits are only applied on new document libraries in the site. ```yaml Type: String[] @@ -1798,7 +1798,7 @@ Accept wildcard characters: False An array of file type names. Removes the version history limits to a set of file types so that they will follow the default version history limits. -This must be used with [ApplyToNewDocumentLibraries](#-ApplyToNewDocumentLibraries) switch set to true, because the version history limits are only applied on new document libraries in the site. +This must be used with [ApplyToNewDocumentLibraries](#-applytonewdocumentlibraries) switch set to true, because the version history limits are only applied on new document libraries in the site. > [!NOTE] > This feature is currently in preview and may not be available in your tenant. diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md index cecb87d5e..8ee906143 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOTenant.md @@ -3175,9 +3175,9 @@ An array of file type names. The supported file type names are: - Video Apply the version history limits to a set of file types so that they no longer follow the default version history limits. It is used in combination with the following parameters: -- [EnableAutoExpirationVersionTrim](#-EnableAutoExpirationVersionTrim) -- [MajorVersionLimit](#-MajorVersionLimit) -- [ExpireVersionsAfterDays](#-ExpireVersionsAfterDays) +- [EnableAutoExpirationVersionTrim](#-enableautoexpirationversiontrim) +- [MajorVersionLimit](#-majorversionlimit) +- [ExpireVersionsAfterDays](#-expireversionsafterdays) The version history limits are applied on new document libraries in the tenant. From d6775e2d383332959fa6bc1b3f9184dcfc020210 Mon Sep 17 00:00:00 2001 From: blarrywang Date: Thu, 14 Aug 2025 11:32:33 -0700 Subject: [PATCH 27/31] Fix spacing. --- .../Set-SPOListVersionPolicy.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md index c25f78709..c38880267 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md @@ -143,6 +143,7 @@ Example 12 removes the version history limit overrides for video and audio file ### -EnableAutoExpirationVersionTrim > Applicable: SharePoint Online + Global and SharePoint Administrators can set document library level version history limits settings that universally apply to new versions created. When version history limits are managed automatically, SharePoint employs an algorithm behind the scenes that deletes (thins out) intermittent older versions that are least likely to be needed, while preserving sufficient high-value versions - more versions in the recent past and fewer farther back in time - in case restores are required. @@ -196,6 +197,7 @@ Accept wildcard characters: False ### -ExpireVersionsAfterDays > Applicable: SharePoint Online + When version history limits are managed manually (`EnableAutoExpirationVersionTrim $false`), admins will need to set the limits to the number of major versions (`MajorVersionLimit`), the number of major with minor versions (`MajorWithMinorVersionsLimit`) and the time period the versions are stored (`ExpireVersionsAfterDays`). Please check the description of `EnableAutoExpirationVersionTrim` for more details. PARAMVALUE: Int32 @@ -258,6 +260,7 @@ Accept wildcard characters: False ### -MajorVersionLimit > Applicable: SharePoint Online + When version history limits are managed manually (`EnableAutoExpirationVersionTrim $false`), admins will need to set the limits to the number of major versions (`MajorVersionLimit`) and the time period the versions are stored (`ExpireVersionsAfterDays`). Please check the description of `EnableAutoExpirationVersionTrim` for more details. PARAMVALUE: Int32 @@ -277,6 +280,7 @@ Accept wildcard characters: False ### -MajorWithMinorVersionsLimit > Applicable: SharePoint Online + When version history limits are managed manually (`EnableAutoExpirationVersionTrim $false`), admins will need to set the limits to the number of major versions (`MajorVersionLimit`), the number of major with minor versions (`MajorWithMinorVersionsLimit`) and the time period the versions are stored (`ExpireVersionsAfterDays`). Please check the description of `EnableAutoExpirationVersionTrim` for more details. PARAMVALUE: Int32 From 98c7648f608b5a2f701f341c95602ff2ca274ccd Mon Sep 17 00:00:00 2001 From: blarrywang Date: Fri, 15 Aug 2025 10:52:27 -0700 Subject: [PATCH 28/31] Address comments. --- .../Get-SPOSiteManageVersionPolicyJobProgress.md | 1 - .../New-SPOListFileVersionBatchDeleteJob.md | 7 ------- .../New-SPOSiteManageVersionPolicyJob.md | 1 - .../Remove-SPOSiteManageVersionPolicyJob.md | 1 - .../Set-SPOListVersionPolicy.md | 2 +- 5 files changed, 1 insertion(+), 11 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md index f766a5370..f588d0bc0 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOSiteManageVersionPolicyJobProgress.md @@ -8,7 +8,6 @@ schema: 2.0.0 author: blarrywangmsft ms.author: blarrywang ms.reviewer: -manager: yigitd --- # Get-SPOSiteManageVersionPolicyJobProgress diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md index 76847f62a..85ec0ec1f 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md @@ -171,13 +171,6 @@ An array of file type names to trim versions. The supported file type names are: - OutlookPST - Video -<<<<<<< HEAD -======= - - - - ->>>>>>> 6e83ced68a482707018e763b6d17dbe1d5ae7ee5 ```yaml Type: String[] Parameter Sets: ByPolicy diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md index fb97a229b..111c845c8 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -8,7 +8,6 @@ schema: 2.0.0 author: blarrywangmsft ms.author: blarrywang ms.reviewer: -manager: yigitd --- # New-SPOSiteManageVersionPolicyJob diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md index db506aa82..09dfd8a94 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOSiteManageVersionPolicyJob.md @@ -8,7 +8,6 @@ schema: 2.0.0 author: blarrywangmsft ms.author: blarrywang ms.reviewer: -manager: yigitd --- # Remove-SPOSiteManageVersionPolicyJob diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md index c38880267..6f30e93f2 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md @@ -227,7 +227,7 @@ Apply the version history limits to a set of file types so that they no longer f - [MajorVersionLimit](#-majorversionlimit) - [ExpireVersionsAfterDays](#-expireversionsafterdays) -Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the [Sync](#-sync) parameter. For more information about this option, please refer to the documentation for the [Sync](#-sync) parameter. +Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the [Sync](#-sync) parameter. ```yaml Type: String[] From 517204ca25ad45dc22da7170c718da8e6de25895 Mon Sep 17 00:00:00 2001 From: blarrywang Date: Fri, 15 Aug 2025 11:01:13 -0700 Subject: [PATCH 29/31] Fix more whitespaces etc. --- .../New-SPOSiteManageVersionPolicyJob.md | 16 ---------------- .../Set-SPOTenant.md | 4 ---- 2 files changed, 20 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md index 111c845c8..f5162e4a6 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -34,17 +34,12 @@ New-SPOSiteManageVersionPolicyJob [-Identity] [-FileTypes Date: Fri, 15 Aug 2025 11:18:28 -0700 Subject: [PATCH 30/31] Reduce the number of examples. --- .../New-SPOListFileVersionBatchDeleteJob.md | 16 ---- .../New-SPOSiteManageVersionPolicyJob.md | 77 +------------------ .../Set-SPOListVersionPolicy.md | 48 ++---------- 3 files changed, 11 insertions(+), 130 deletions(-) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md index 85ec0ec1f..f0007b998 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md @@ -99,22 +99,6 @@ New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/ Example 6 starts a trim job that will delete file versions for video and audio file types in the document library based on the version history limits of the document library. -### EXAMPLE 7 - -```powershell -New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -TrimUseListPolicy -ExcludeDefaultPolicy -``` - -Example 7 starts a trim job that will delete file versions for all file types that have a version history limit override in the document library based on the version history limits of the document library. - -### EXAMPLE 8 - -```powershell -New-SPOListFileVersionBatchDeleteJob -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -TrimUseListPolicy -FileTypes @() -``` - -Example 8 starts a trim job that will delete file versions for all file types that don't have a version history limit override in the document library based on the version history limits of the document library. - ## PARAMETERS ### -Automatic diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md index f5162e4a6..249236cf2 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOSiteManageVersionPolicyJob.md @@ -54,7 +54,6 @@ Apply the site video, audio, and default version history limits to existing docu ### Example 2 - ```powershell New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy ``` @@ -63,32 +62,13 @@ Apply the site video, audio version history limits to existing document librarie ### Example 3 - -```powershell -New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -FileTypes @() -``` - -Apply the site default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. - -### Example 4 - - ```powershell New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy ``` Apply the site version history limits (including file type overrides) to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. -### Example 5 - - -```powershell -New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -ExcludeDefaultPolicy -``` - -Apply all site file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. - -### Example 6 +### Example 4 ```powershell New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy -FileTypes @("Video","Audio") @@ -96,7 +76,7 @@ New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites Trim video and audio file versions, and the file versions that don't have a file type override, based on each document library's version history limits. -### Example 7 +### Example 5 ```powershell New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy @@ -104,15 +84,7 @@ New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites Trim video and audio file versions based on each document library's version history limits. -### Example 8 - -```powershell -New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy -FileTypes @() -``` - -Trim file versions that don't have a file type override based on each document library's version history limits. - -### Example 9 +### Example 6 ```powershell New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy @@ -120,40 +92,7 @@ New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites Trim all file versions based on each document library's version history limits. -### Example 10 - -```powershell -New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -TrimUseListPolicy -ExcludeDefaultPolicy -``` - -Trim all file versions that have a file type override based on each document library's version history limits. - - -### Example 11 - -```powershell -New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -FileTypes @("Video","Audio") -``` - -Apply the site video, audio, and default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim video and audio file versions, and the file versions that don't have a file type override, based on each document library's version history limits. - -### Example 12 - -```powershell -New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -TrimUseListPolicy -FileTypes @("Video","Audio") -ExcludeDefaultPolicy -``` - -Apply the site video, audio version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim video and audio file versions based on each document library's version history limits. - -### Example 13 - -```powershell -New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -TrimUseListPolicy -FileTypes @() -``` - -Apply the site default version history limits to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim file versions that don't have a file type override based on each document library's version history limits. - -### Example 14 +### Example 7 ```powershell New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -TrimUseListPolicy @@ -161,14 +100,6 @@ New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites Apply the site version history limits (including file type overrides) to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim all file versions based on each document library's version history limits. -### Example 15 - -```powershell -New-SPOSiteManageVersionPolicyJob -Identity https://contoso.sharepoint.com/sites/site1 -SyncListPolicy -TrimUseListPolicy -ExcludeDefaultPolicy -``` - -Apply all site file type version history limit overrides to existing document libraries. If the site is not broken inheritance for version history limits, then it applies the tenant version history limits. Then trim all file versions that have a file type override based on each document library's version history limits. - ## PARAMETERS ### -Confirm diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md index 6f30e93f2..09b5c724e 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md @@ -74,69 +74,35 @@ Example 4 sets automatic version history limit override for video and audio file ### EXAMPLE 5 -```powershell -Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 30 -FileTypes @("Video", "Audio") -``` - -Example 5 sets manual version history limit override for video and audio file types on the document library called "Documents" by limiting the number of versions and the time (in days) versions are kept. - -### EXAMPLE 6 - -```powershell -Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -EnableAutoExpirationVersionTrim $false -MajorVersionLimit 500 -MajorWithMinorVersionsLimit 20 -ExpireVersionsAfterDays 0 -FileTypes @("Video", "Audio") -``` - -Example 6 sets manual version history limit override for video and audio file types on the document library called "Documents" by limiting the number of versions with no time limits. - -### EXAMPLE 7 - ```powershell Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync ``` -Example 7 sets the version history limits (include file type overrides) to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). +Example 5 sets the version history limits (include file type overrides) to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). -### EXAMPLE 8 +### EXAMPLE 6 ```powershell Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync -FileTypes @("Video", "Audio") ``` -Example 8 sets the default version history limits and overrides for video and audio file types to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). +Example 6 sets the default version history limits and overrides for video and audio file types to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). -### EXAMPLE 9 - -```powershell -Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync -FileTypes @() -``` - -Example 9 sets the default version history limit to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). - -### EXAMPLE 10 +### EXAMPLE 7 ```powershell Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync -FileTypes @("Video", "Audio") -ExcludeDefaultPolicy ``` -Example 10 sets the only the version history limit overrides for video and audio file types to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). - -### EXAMPLE 11 - - -```powershell -Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -Sync -ExcludeDefaultPolicy -``` - -Example 10 sets the version history limit overrides for all file types to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). - -### EXAMPLE 12 +Example 7 sets the only the version history limit overrides for video and audio file types to that of the tenant or site (if the site this document library is in has broken inheritance for version history limits). +### EXAMPLE 8 ```powershell Set-SPOListVersionPolicy -Site https://contoso.sharepoint.com/sites/site1 -List "Documents" -RemoveVersionExpirationFileTypeOverride @("Video", "Audio") ``` -Example 12 removes the version history limit overrides for video and audio file types so that they follow the default version history limits. +Example 8 removes the version history limit overrides for video and audio file types so that they follow the default version history limits. ## PARAMETERS From a092256dda3ddb8ee64c0339b828b39269858549 Mon Sep 17 00:00:00 2001 From: blarrywang Date: Fri, 15 Aug 2025 11:28:51 -0700 Subject: [PATCH 31/31] Add notes for preview. --- .../New-SPOListFileVersionBatchDeleteJob.md | 6 ++++++ .../Set-SPOListVersionPolicy.md | 6 ++++++ .../Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md | 3 +++ 3 files changed, 15 insertions(+) diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md index f0007b998..c62059c6a 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOListFileVersionBatchDeleteJob.md @@ -155,6 +155,9 @@ An array of file type names to trim versions. The supported file type names are: - OutlookPST - Video +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + ```yaml Type: String[] Parameter Sets: ByPolicy @@ -249,6 +252,9 @@ Accept wildcard characters: False ### -TrimUseListPolicy Indicates whether to trim versions by applying the document library's version history limits. +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + ```yaml Type: SwitchParameter Parameter Sets: ByPolicy diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md index 09b5c724e..f232c0959 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOListVersionPolicy.md @@ -195,6 +195,9 @@ Apply the version history limits to a set of file types so that they no longer f Or apply the version history limit override for the file types of the tenant or the site (if the site this document library is in has broken inheritance for version history limits) by using the [Sync](#-sync) parameter. +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + ```yaml Type: String[] Parameter Sets: SetPolicy, SyncPolicy @@ -266,6 +269,9 @@ Accept wildcard characters: False ### -RemoveVersionExpirationFileTypeOverride An array of file type names. Removes the version history limit override from a set of file types so that they will follow the default version history limits. +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + ```yaml Type: String[] Parameter Sets: RemovePolicy diff --git a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md index cb34cb384..bd0c0e14d 100644 --- a/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md +++ b/sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Set-SPOSite.md @@ -1249,6 +1249,9 @@ Apply the version history limits to a set of file types so that they no longer f This must be used with [ApplyToNewDocumentLibraries](#-applytonewdocumentlibraries) switch set to true, because the version history limits are only applied on new document libraries in the site. +> [!NOTE] +> This feature is currently in preview and may not be available in your tenant. + ```yaml Type: String[] Parameter Sets: SetSiteFileTypeFileVersionPolicy