Add new versioning cmdlets.

src/Commands/Files/GetFileVersion.cs

@@ -13,6 +13,9 @@ public class GetFileVersion : PnPWebCmdlet
         [Parameter(Mandatory = true)]
         public string Url;
 
+        [Parameter(Mandatory = false)]
+        public SwitchParameter UseVersionExpirationReport;
+
         protected override void ExecuteCmdlet()
         {
             var serverRelativeUrl = string.Empty;
@@ -31,13 +34,21 @@ protected override void ExecuteCmdlet()
             File file;
 
             file = CurrentWeb.GetFileByServerRelativePath(ResourcePath.FromDecodedUrl(serverRelativeUrl));
+
+            if (UseVersionExpirationReport)
+            {
+                ClientContext.Load(file, f => f.Exists, f => f.VersionExpirationReport.IncludeWithDefaultProperties(i => i.CreatedBy, i => i.SnapshotDate, i => i.ExpirationDate));
+            }
+            else
+            {
+                ClientContext.Load(file, f => f.Exists, f => f.Versions.IncludeWithDefaultProperties(i => i.CreatedBy, i => i.SnapshotDate, i => i.ExpirationDate));
+            }
 
-            ClientContext.Load(file, f => f.Exists, f => f.Versions.IncludeWithDefaultProperties(i => i.CreatedBy));
             ClientContext.ExecuteQueryRetry();
 
             if (file.Exists)
             {
-                var versions = file.Versions;
+                var versions = UseVersionExpirationReport ? file.VersionExpirationReport : file.Versions;
                 ClientContext.ExecuteQueryRetry();
                 WriteObject(versions, true);
             }

src/Commands/Lists/GetLibraryLevelFileVersionExpirationReportJobProgress.cs

@@ -0,0 +1,39 @@
+using Microsoft.SharePoint.Client;
+
+using PnP.Framework.Utilities;
+using PnP.PowerShell.Commands.Base.PipeBinds;
+using PnP.PowerShell.Commands.Model.SharePoint;
+
+using System.Management.Automation;
+using System.Text.Json;
+
+namespace PnP.PowerShell.Commands.Lists
+{
+    [Cmdlet(VerbsCommon.Get, "LibraryLevelFileVersionExpirationReportJobProgress")]
+    [OutputType(typeof(FileVersionExpirationReportJobProgress))]
+    public class GetLibraryLevelFileVersionExpirationReportJobProgress : PnPWebCmdlet
+    {
+        [Parameter(Mandatory = true, ValueFromPipeline = true, Position = 0)]        
+        [ValidateNotNull]
+        public ListPipeBind Identity;
+
+        [Parameter(Mandatory = true)]
+        public string ReportUrl;
+
+        protected override void ExecuteCmdlet()
+        {
+            var list = Identity.GetList(CurrentWeb);
+            if (list != null)
+            {
+                var ret = list.GetProgressForFileVersionExpirationReport(ReportUrl);
+                ClientContext.ExecuteQueryRetry();
+
+                var status = JsonSerializer.Deserialize<FileVersionExpirationReportJobProgress>(ret.Value);
+                status.Url = list.RootFolder.ServerRelativeUrl;
+                status.ReportUrl = ReportUrl;
+
+                WriteObject(status);
+            }
+        }
+    }
+}

src/Commands/Lists/NewLibraryLevelFileVersionBatchDeleteJob.cs

@@ -0,0 +1,44 @@
+using Microsoft.SharePoint.Client;
+
+using PnP.Framework.Utilities;
+using PnP.PowerShell.Commands.Base.PipeBinds;
+
+using System.Management.Automation;
+
+using Resources = PnP.PowerShell.Commands.Properties.Resources;
+
+namespace PnP.PowerShell.Commands.Lists
+{
+    [Cmdlet(VerbsCommon.New, "LibraryLevelFileVersionBatchDeleteJob")]
+    public class NewLibraryLevelFileVersionBatchDeleteJob : PnPWebCmdlet
+    {
+        [Parameter(Mandatory = true, ValueFromPipeline = true, Position = 0)]        
+        [ValidateNotNull]
+        public ListPipeBind Identity;
+
+        [Parameter(Mandatory = true)]
+        public int DeleteBeforeDays;
+
+        [Parameter(Mandatory = false)]
+        public SwitchParameter Force;
+
+        protected override void ExecuteCmdlet()
+        {
+            if (Force || ShouldContinue("By executing this command, versions specified will be permanently deleted. These versions cannot be restored from the recycle bin. Are you sure you want to continue?", Resources.Confirm))
+            {
+                var list = Identity.GetList(CurrentWeb);
+                if (list != null)
+                {
+                    list.StartDeleteFileVersions(DeleteBeforeDays);
+                    ClientContext.ExecuteQueryRetry();
+
+                    WriteVerbose("Success. Versions specified will be permanently deleted in the upcoming days.");
+                }
+            }
+            else
+            {
+                WriteVerbose("Cancelled. No versions will be deleted.");
+            }
+        }
+    }
+}

src/Commands/Lists/NewLibraryLevelFileVersionExpirationReportJob.cs

@@ -0,0 +1,32 @@
+using Microsoft.SharePoint.Client;
+
+using PnP.Framework.Utilities;
+using PnP.PowerShell.Commands.Base.PipeBinds;
+
+using System.Management.Automation;
+
+namespace PnP.PowerShell.Commands.Lists
+{
+    [Cmdlet(VerbsCommon.New, "LibraryLevelFileVersionExpirationReportJob")]
+    public class NewLibraryLevelFileVersionExpirationReportJob : PnPWebCmdlet
+    {
+        [Parameter(Mandatory = true, ValueFromPipeline = true, Position = 0)]        
+        [ValidateNotNull]
+        public ListPipeBind Identity;
+
+        [Parameter(Mandatory = true)]
+        public string ReportUrl;
+
+        protected override void ExecuteCmdlet()
+        {
+            var list = Identity.GetList(CurrentWeb);
+            if (list != null)
+            {
+                list.StartFileVersionExpirationReport(ReportUrl);
+                ClientContext.ExecuteQueryRetry();
+
+                WriteVerbose("Success. The file version expiration report will be gradually populated. It will take over 24 hours to complete for a small library, and a few days for a larger one.");
+            }
+        }
+    }
+}

src/Commands/Lists/RemoveLibraryLevelFileVersionBatchDeleteJob.cs

@@ -0,0 +1,41 @@
+using Microsoft.SharePoint.Client;
+
+using PnP.Framework.Utilities;
+using PnP.PowerShell.Commands.Base.PipeBinds;
+
+using System.Management.Automation;
+
+using Resources = PnP.PowerShell.Commands.Properties.Resources;
+
+namespace PnP.PowerShell.Commands.Lists
+{
+    [Cmdlet(VerbsCommon.Remove, "LibraryLevelFileVersionBatchDeleteJob")]
+    public class RemoveLibraryLevelFileVersionBatchDeleteJob : PnPWebCmdlet
+    {
+        [Parameter(Mandatory = true, ValueFromPipeline = true, Position = 0)]        
+        [ValidateNotNull]
+        public ListPipeBind Identity;
+
+        [Parameter(Mandatory = false)]
+        public SwitchParameter Force;
+
+        protected override void ExecuteCmdlet()
+        {
+            if (Force || ShouldContinue("It will stop processing further version deletion batches. Are you sure you want to continue?", Resources.Confirm))
+            {
+                var list = Identity.GetList(CurrentWeb);
+                if (list != null)
+                {
+                    list.CancelDeleteFileVersions();
+                    ClientContext.ExecuteQueryRetry();
+                }
+
+                WriteVerbose("Future deletion is successfully stopped.");
+            }
+            else
+            {
+                WriteVerbose("Did not receive confirmation to stop deletion. Continuing to delete specified versions.");
+            }
+        }
+    }
+}

src/Commands/Model/SharePoint/FileVersionExpirationReportJobProgress.cs

@@ -0,0 +1,34 @@
+using System.Text.Json.Serialization;
+
+namespace PnP.PowerShell.Commands.Model.SharePoint
+{
+    /// <summary>
+    /// The progress for generating the file version expiration report.
+    /// </summary>
+    public class FileVersionExpirationReportJobProgress
+    {
+        /// <summary>
+        /// The URL to the site or library that the report is for
+        /// </summary>
+        [JsonPropertyName("url")]
+        public string Url { get; set; }
+
+        /// <summary>
+        /// The URL of the report file
+        /// </summary>
+        [JsonPropertyName("report_url")]
+        public string ReportUrl { get; set; }
+
+        /// <summary>
+        /// The request status
+        /// </summary>
+        [JsonPropertyName("status")]
+        public string Status { get; set; }
+
+        /// <summary>
+        /// The error message if any
+        /// </summary>
+        [JsonPropertyName( "error_message")]
+        public string ErrorMessage { get; set; }
+    }
+}

src/Commands/Site/GetSiteLevelFileVersionExpirationReportJobProgress.cs

@@ -0,0 +1,33 @@
+using Microsoft.SharePoint.Client;
+
+using PnP.Framework.Utilities;
+using PnP.PowerShell.Commands.Base.PipeBinds;
+using PnP.PowerShell.Commands.Model.SharePoint;
+
+using System.Management.Automation;
+using System.Text.Json;
+
+namespace PnP.PowerShell.Commands.Sites
+{
+    [Cmdlet(VerbsCommon.Get, "SiteLevelFileVersionExpirationReportJobProgress")]
+    [OutputType(typeof(FileVersionExpirationReportJobProgress))]
+    public class GetSiteLevelFileVersionExpirationReportJobProgress : PnPSharePointCmdlet
+    {
+        [Parameter(Mandatory = true)]
+        public string ReportUrl;
+
+        protected override void ExecuteCmdlet()
+        {
+            var site = ClientContext.Site;
+            ClientContext.Load(site, s => s.Url);
+            var ret = site.GetProgressForFileVersionExpirationReport(ReportUrl);
+            ClientContext.ExecuteQueryRetry();
+
+            var status = JsonSerializer.Deserialize<FileVersionExpirationReportJobProgress>(ret.Value);
+            status.Url = site.Url;
+            status.ReportUrl = ReportUrl;
+
+            WriteObject(status);
+        }
+    }
+}

src/Commands/Site/NewSiteLevelFileVersionBatchDeleteJob.cs

@@ -0,0 +1,37 @@
+using Microsoft.SharePoint.Client;
+
+using PnP.Framework.Utilities;
+using PnP.PowerShell.Commands.Base.PipeBinds;
+
+using System.Management.Automation;
+
+using Resources = PnP.PowerShell.Commands.Properties.Resources;
+
+namespace PnP.PowerShell.Commands.Sites
+{
+    [Cmdlet(VerbsCommon.New, "SiteLevelFileVersionBatchDeleteJob")]
+    public class NewSiteLevelFileVersionBatchDeleteJob : PnPSharePointCmdlet
+    {
+        [Parameter(Mandatory = true)]
+        public int DeleteBeforeDays;
+
+        [Parameter(Mandatory = false)]
+        public SwitchParameter Force;
+
+        protected override void ExecuteCmdlet()
+        {
+            if (Force || ShouldContinue("By executing this command, versions specified will be permanently deleted. These versions cannot be restored from the recycle bin. Are you sure you want to continue?", Resources.Confirm))
+            {
+                var site = ClientContext.Site;
+                site.StartDeleteFileVersions(DeleteBeforeDays);
+                ClientContext.ExecuteQueryRetry();
+
+                WriteVerbose("Success. Versions specified will be permanently deleted in the upcoming days.");
+            }
+            else
+            {
+                WriteVerbose("Cancelled. No versions will be deleted.");
+            }
+        }
+    }
+}

src/Commands/Site/NewSiteLevelFileVersionExpirationReportJob.cs

@@ -0,0 +1,25 @@
+using Microsoft.SharePoint.Client;
+
+using PnP.Framework.Utilities;
+using PnP.PowerShell.Commands.Base.PipeBinds;
+
+using System.Management.Automation;
+
+namespace PnP.PowerShell.Commands.Sites
+{
+    [Cmdlet(VerbsCommon.New, "SiteLevelFileVersionExpirationReportJob")]
+    public class NewSiteLevelFileVersionExpirationReportJob : PnPSharePointCmdlet
+    {
+        [Parameter(Mandatory = true)]
+        public string ReportUrl;
+
+        protected override void ExecuteCmdlet()
+        {
+            var site = ClientContext.Site;
+            site.StartFileVersionExpirationReport(ReportUrl);
+            ClientContext.ExecuteQueryRetry();
+
+            WriteVerbose("Success. The file version expiration report will be gradually populated. It will take over 24 hours to complete for a small site, and a few days for a larger one.");
+        }
+    }
+}

src/Commands/Site/RemoveSiteLevelFileVersionBatchDeleteJob.cs

@@ -0,0 +1,34 @@
+using Microsoft.SharePoint.Client;
+
+using PnP.Framework.Utilities;
+using PnP.PowerShell.Commands.Base.PipeBinds;
+
+using System.Management.Automation;
+
+using Resources = PnP.PowerShell.Commands.Properties.Resources;
+
+namespace PnP.PowerShell.Commands.Sites
+{
+    [Cmdlet(VerbsCommon.Remove, "SiteLevelFileVersionBatchDeleteJob")]
+    public class RemoveSiteLevelFileVersionBatchDeleteJob : PnPSharePointCmdlet
+    {
+        [Parameter(Mandatory = false)]
+        public SwitchParameter Force;
+
+        protected override void ExecuteCmdlet()
+        {
+            if (Force || ShouldContinue("It will stop processing further version deletion batches. Are you sure you want to continue?", Resources.Confirm))
+            {
+                var site = ClientContext.Site;
+                site.CancelDeleteFileVersions();
+                ClientContext.ExecuteQueryRetry();
+
+                WriteVerbose("Future deletion is successfully stopped.");
+            }
+            else
+            {
+                WriteVerbose("Did not receive confirmation to stop deletion. Continuing to delete specified versions.");
+            }
+        }
+    }
+}