Refactor Export-PnPPage cmdlet to add support for returning the templ…

…ate as an in-memory object (#4323)

Co-authored-by: Gautam Sheth <[email protected]>

documentation/Export-PnPPage.md

@@ -16,7 +16,7 @@ Exports a Client Side Page to a PnP Provisioning Template
 
 ```powershell
 Export-PnPPage [-Identity] <PagePipeBind> [-PersistBrandingFiles] [-Out <String>] [-Force]
- [-Configuration <ExtractConfigurationPipeBind>] [-Connection <PnPConnection>] 
+ [-Configuration <ExtractConfigurationPipeBind>] [-OutputInstance]  [-Connection <PnPConnection>] 
   
 ```
 
@@ -141,15 +141,12 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-
-
-### -WhatIf
-Shows what would happen if the cmdlet runs. The cmdlet is not run.
+### -OutputInstance
+Returns the template as an in-memory object, which is an instance of the SiteTemplate type of the PnP Core Component. It cannot be used together with the -Out parameter.
 
 ```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
-Aliases: wi
 
 Required: False
 Position: Named

src/Commands/Pages/ExportPage.cs

@@ -29,6 +29,9 @@ public class ExportPage : PnPWebCmdlet
         [Parameter(Mandatory = false)]
         public ExtractConfigurationPipeBind Configuration;
 
+        [Parameter(Mandatory = false)]
+        public SwitchParameter OutputInstance;
+
         protected override void ProcessRecord()
         {
             _ = Identity.GetPage(Connection) ?? throw new Exception($"Page '{Identity?.Name}' does not exist");
@@ -95,9 +98,15 @@ private void ExtractTemplate(string dirName, string fileName, ExtractConfigurati
             }
             else
             {
-                WriteObject(outputTemplate.ToXML());
+                if (OutputInstance)
+                {
+                    WriteObject(outputTemplate);
+                }
+                else
+                {
+                    WriteObject(outputTemplate.ToXML());
+                }                
             }
         }
     }
-
 }