Learn Editor: Update New-SPOListFileVersionBatchDeleteJob.md

Author: blarrywangmsft

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

@@ -37,6 +37,12 @@ New-SPOListFileVersionBatchDeleteJob [-Site] <SpoSitePipeBind> -List <SPOListPip
  -MajorVersionLimit <Int32> -MajorWithMinorVersionsLimit <Int32> [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
+### ByPolicy
+```
+New-SPOListFileVersionBatchDeleteJob [-Site] <SpoSitePipeBind> -List <SPOListPipeBind> [-FileTypes <String[]>]
+ [-ExcludeDefaultPolicy] [-TrimUseListPolicy] [-WhatIf] [-Confirm] [<CommonParameters>]
+```
+
 ## 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.