[FileVersion] Add documentation for tenant apply version policy cmdlets

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Get-SPOTenantApplyFileVersionPolicyJobProgress.md

@@ -0,0 +1,62 @@
+---
+external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
+Module Name: microsoft.online.sharepoint.powershell
+online version: https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/get-spotenantapplyfileversionpolicyjobprogress
+applicable: SharePoint Online
+title: Get-SPOTenantApplyFileVersionPolicyJobProgress
+schema: 2.0.0
+author: msjennywu
+ms.author: jennywu
+ms.reviewer:
+manager: seanmc
+---
+
+# Get-SPOTenantApplyFileVersionPolicyJobProgress
+
+## SYNOPSIS
+
+Gets the status for a tenant apply file version policy job. SharePoint Advanced Management license is required to run this cmdlet.
+
+> [!NOTE]
+> This feature is currently in preview and may not be available in your tenant.
+
+## SYNTAX
+
+```
+Get-SPOTenantApplyFileVersionPolicyJobProgress [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Gets the status for a tenant apply file version policy job.
+
+## EXAMPLES
+
+### Example 1
+```powershell
+Get-SPOTenantApplyFileVersionPolicyJobProgress
+```
+
+Example 1 gets the status for a tenant apply file version policy job.
+
+## PARAMETERS
+
+### CommonParameters
+This cmdlet supports the common parameters: `-Debug`, `-ErrorAction`, `-ErrorVariable`, `-InformationAction`, `-InformationVariable`, `-OutVariable`, `-OutBuffer`, `-PipelineVariable`, `-ProgressAction`, `-Verbose`, `-WarningAction`, and `-WarningVariable`. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+
+## RELATED LINKS
+
+[New-SPOTenantApplyFileVersionPolicyJob](New-SPOTenantApplyFileVersionPolicyJob.md)
+
+[Remove-SPOTenantApplyFileVersionPolicyJob](Remove-SPOTenantApplyFileVersionPolicyJob.md)
+
+[SharePoint Advanced Management](/sharepoint/sharepoint-advanced-management-licensing)

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Microsoft.Online.SharePoint.PowerShell.md

@@ -363,6 +363,9 @@ Get the structural navigation caching state for a web.
 ### [Get-SPOTenant](Get-SPOTenant.md)
 Returns SharePoint Online organization properties.
 
+### [Get-SPOTenantApplyFileVersionPolicyJobProgress](Get-SPOTenantApplyFileVersionPolicyJobProgress.md)
+Gets the status for a tenant apply file version policy job. SharePoint Advanced Management license is required to run this cmdlet.
+
 ### [Get-SPOTenantCdnEnabled](Get-SPOTenantCdnEnabled.md)
 Returns whether Public content delivery network (CDN) or Private CDN is enabled on the tenant level. Requires Tenant administrator permissions.
 
@@ -483,6 +486,9 @@ Starts a background job to manage file versions and version history limits for a
 ### [New-SPOSiteSharingReportJob](New-SPOSiteSharingReportJob.md)
 Creates a new sharing report job.
 
+### [New-SPOTenantApplyFileVersionPolicyJob](New-SPOTenantApplyFileVersionPolicyJob.md)
+Queues a job to apply the tenant-level file version policy across all sites. SharePoint Advanced Management license is required to run this cmdlet.
+
 ### [Register-SPODataEncryptionPolicy](Register-SPODataEncryptionPolicy.md)
 Cmdlet to register customer encryption status for your geo tenant. For more information, see [Controlling your data in Office 365 using Customer Key](/microsoft-365/compliance/controlling-your-data-using-customer-key)
 
@@ -600,6 +606,9 @@ Cancels further processing of version settings update on existing document libra
 ### [Remove-SPOStorageEntity](Remove-SPOStorageEntity.md)
 Tenant properties allow tenant administrators to add properties in the app catalog that can be read by various SharePoint Framework components. Because tenant properties are stored in the tenant app catalog, you must provide the tenant app catalog site collection URL or the site collection app catalog URL in the following cmdlets. This cmdlet is used to remove a value in the property bag.
 
+### [Remove-SPOTenantApplyFileVersionPolicyJob](Remove-SPOTenantApplyFileVersionPolicyJob.md)
+Stops further processing of tenant apply file version policy job that is in progress. SharePoint Advanced Management license is required to run this cmdlet.
+
 ### [Remove-SPOTenantCdnOrigin](Remove-SPOTenantCdnOrigin.md)
 Removes a new origin from the Public or Private content delivery network (CDN). Requires Tenant administrator permissions.
 

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/New-SPOTenantApplyFileVersionPolicyJob.md

@@ -0,0 +1,152 @@
+---
+external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
+Module Name: microsoft.online.sharepoint.powershell
+online version: https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/new-spotenantapplyfileversionpolicyjob
+applicable: SharePoint Online
+title: New-SPOTenantApplyFileVersionPolicyJob
+schema: 2.0.0
+author: msjennywu
+ms.author: jennywu
+ms.reviewer:
+manager: seanmc
+---
+
+# New-SPOTenantApplyFileVersionPolicyJob
+
+## SYNOPSIS
+
+Queues a job to apply the tenant-level file version policy across all sites. SharePoint Advanced Management license is required to run this cmdlet.
+
+> [!NOTE]
+> This feature is currently in preview and may not be available in your tenant.
+
+## SYNTAX
+
+```
+New-SPOTenantApplyFileVersionPolicyJob [-TrimVersions] [-SetVersionPolicy] [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Queues a job to apply the tenant-level file version policy across all sites. The job trims existing file versions and/or sets version policy for existing document libraries based on the version policy configured at the tenant level.
+
+The following site types are excluded from processing:
+
+- Read-only sites
+- Locked sites
+- Archived sites
+- Sites with version policy broken inheritance
+
+> [!NOTE]
+> - Versions deleted using this cmdlet will be permanently deleted and cannot be recovered from the recycle bin.
+> - Use `Get-SPOTenant` cmdlet and the `EnableAutoExpirationVersionTrim`, `MajorVersionLimit`, `ExpireVersionsAfterDays` and `VersionPolicyFileTypeOverride` properties to confirm the tenant-level file version policy before running the cmdlet to make sure it matches your intended configuration.
+> - If the tenant-level version policy changes while the job is in progress, the job will apply the updated policy to the remaining sites that have not yet been processed. Sites that were already processed will not be re-evaluated or updated.
+> - Allow only one job per tenant.
+
+## EXAMPLES
+
+### Example 1
+```powershell
+New-SPOTenantApplyFileVersionPolicyJob -TrimVersions -SetVersionPolicy
+```
+
+Example 1 starts a tenant apply file version policy job to trim existing versions and set version policy for existing document libraries across all sites.
+
+### Example 2
+```powershell
+New-SPOTenantApplyFileVersionPolicyJob -TrimVersions
+```
+
+Example 2 starts a tenant apply file version policy job to trim existing versions for files in doducment libraries across all sites.
+
+### Example 3
+```powershell
+New-SPOTenantApplyFileVersionPolicyJob -SetVersionPolicy
+```
+
+Example 3 starts a tenant apply file version policy job to set version policy for existing document libraries across all sites.
+
+## 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
+```
+
+### -SetVersionPolicy
+Sets version policy for existing document libraries across all sites based on the tenant-level file version policy. The version policy applies to new versions created in these existing document libraries.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -TrimVersions
+Trims existing versions for files in document libraries across all sites based on the tenant-level file version policy.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+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.
+
+```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`, `-ProgressAction`, `-Verbose`, `-WarningAction`, and `-WarningVariable`. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+
+## RELATED LINKS
+
+[Get-SPOTenantApplyFileVersionPolicyJobProgress](Get-SPOTenantApplyFileVersionPolicyJobProgress.md)
+
+[Remove-SPOTenantApplyFileVersionPolicyJob](Remove-SPOTenantApplyFileVersionPolicyJob.md)
+
+[Get-SPOTenant](Get-SPOTenant.md)
+
+[SharePoint Advanced Management](/sharepoint/sharepoint-advanced-management-licensing)

sharepoint/sharepoint-ps/Microsoft.Online.SharePoint.PowerShell/Remove-SPOTenantApplyFileVersionPolicyJob.md

@@ -0,0 +1,97 @@
+---
+external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
+Module Name: microsoft.online.sharepoint.powershell
+online version: https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/remove-spotenantapplyfileversionpolicyjob
+applicable: SharePoint Online
+title: Remove-SPOTenantApplyFileVersionPolicyJob
+schema: 2.0.0
+author: msjennywu
+ms.author: jennywu
+ms.reviewer:
+manager: seanmc
+---
+
+# Remove-SPOTenantApplyFileVersionPolicyJob
+
+## SYNOPSIS
+
+Stops further processing of tenant apply file version policy job that is in progress. SharePoint Advanced Management license is required to run this cmdlet.
+
+> [!NOTE]
+> This feature is currently in preview and may not be available in your tenant.
+
+## SYNTAX
+
+```
+Remove-SPOTenantApplyFileVersionPolicyJob [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+Stops further processing of tenant apply file version policy job that is in progress.
+
+> [!NOTE]
+> - If the tenant apply version job is queued by using the cmdlet `New-SPOTenantApplyFileVersionPolicyJob` with the `TrimVersions` parameter, this will stop creating new sub-jobs that trim versions for sites. This does not affect versions that were already permanently deleted while the job was running.
+> - If the tenant apply version job is queued by using the cmdlet `New-SPOTenantApplyFileVersionPolicyJob` with the `SetVersionPolicy` parameter, this will stop creating new sub-jobs that apply the new version policy to existing document libraries for sites. The version policies that were already applied remain in place and will not be reverted.
+
+## EXAMPLES
+
+### Example 1
+```powershell
+Remove-SPOTenantApplyFileVersionPolicyJob
+```
+
+Example 1 cancels further processing of the tenant apply file version policy job.
+
+## 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
+```
+
+### -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`, `-ProgressAction`, `-Verbose`, `-WarningAction`, and `-WarningVariable`. For more information, see [about_CommonParameters](/powershell/module/microsoft.powershell.core/about/about_commonparameters).
+
+## INPUTS
+
+### None
+
+## OUTPUTS
+
+### System.Object
+## NOTES
+
+## RELATED LINKS
+
+[New-SPOTenantApplyFileVersionPolicyJob](New-SPOTenantApplyFileVersionPolicyJob.md)
+
+[Get-SPOTenantApplyFileVersionPolicyJobProgress](Get-SPOTenantApplyFileVersionPolicyJobProgress.md)
+
+[SharePoint Advanced Management](/sharepoint/sharepoint-advanced-management-licensing)