Add Documentation for restore from Deleted app (Azure#12057)

* adding SourceWebApp.Location details

* Update ChangeLog.md

* Add Details in documentation

* Correcting powershell

* Remove app created to restore in case of Failure

* Update ChangeLog.md

Co-authored-by: Yabo Hu <[email protected]>

Author: raohri3

src/Websites/Websites/ChangeLog.md

@@ -18,6 +18,7 @@
         - Additional information about change #1
 -->
 ## Upcoming Release
+* Added safeguard to delete created webapp if restore failed in `Restore-AzDeletedWebApp`
 * Added "SourceWebApp.Location" for `New-AzWebApp` and `New-AzWebAppSlot`
 
 ## Version 1.9.0

src/Websites/Websites/Cmdlets/BackupRestore/RestoreAzureDeletedWebApp.cs

@@ -105,18 +105,26 @@ public override void ExecuteCmdlet()
                 {
                     throw new Exception("Target App Service Plan " + TargetAppServicePlanName + " not found in target Resource Group " + TargetResourceGroupName);
                 }
-                Action createRestoreAction = () =>
+                try
                 {
-                    WebsitesClient.CreateWebApp(TargetResourceGroupName, TargetName, TargetSlot, plan.Location, TargetAppServicePlanName,
-                        null, string.Empty, string.Empty);
-                    restoreAction();
-                };
-                string confirmMsg = string.Format("This web app will be created. App Name: {0}, Resource Group: {1}", TargetName, TargetResourceGroupName);
-                if (!string.IsNullOrEmpty(TargetSlot))
+                    Action createRestoreAction = () =>
+                    {
+                        WebsitesClient.CreateWebApp(TargetResourceGroupName, TargetName, TargetSlot, plan.Location, TargetAppServicePlanName,
+                            null, string.Empty, string.Empty);
+                        restoreAction();
+                    };
+                    string confirmMsg = string.Format("This web app will be created. App Name: {0}, Resource Group: {1}", TargetName, TargetResourceGroupName);
+                    if (!string.IsNullOrEmpty(TargetSlot))
+                    {
+                        confirmMsg += ", Slot: " + TargetSlot;
+                    }
+                    ConfirmAction(this.Force.IsPresent, confirmMsg, "The deleted app has been restored.", TargetName, createRestoreAction);
+                }
+                catch (Exception e)
                 {
-                    confirmMsg += ", Slot: " + TargetSlot;
+                    WebsitesClient.RemoveWebApp(TargetResourceGroupName, TargetName, TargetSlot, true, true, false);
+                    throw e;
                 }
-                ConfirmAction(this.Force.IsPresent, confirmMsg, "The deleted app has been restored.", TargetName, createRestoreAction);
             }
 
             PSSite restoredApp = new PSSite(WebsitesClient.GetWebApp(TargetResourceGroupName, TargetName, TargetSlot));

src/Websites/Websites/help/Restore-AzDeletedWebApp.md

@@ -47,6 +47,14 @@ PS C:\> Restore-AzDeletedWebApp -ResourceGroupName Default-Web-WestUS -Name Cont
 
 Restores the Staging slot of a deleted app named ContosoApp belonging to the resource group Default-Web-WestUS. The web app named ContosoRestore belonging to the resource group Default-Web-EastUS will be overwritten. The deleted web app settings will not be restored.
 
+###Example 3
+```powershell
+PS C:\> $deletedSite = Get-AzDeletedWebApp -ResourceGroupName Default-Web-WestUS -Name ContosoApp
+PS C:\> Restore-AzDeletedWebApp -TargetResourceGroupName Default-Web-EastUS -TargetName ContosoRestore -TargetAppServicePlanName ContosoPlan -InputObject $deletedSite[0]
+```
+
+In case there are 2 deleted apps with same name(ContosoApp), then we get details of both the sites and restore the app named ContosoRestore with the app of our choice by calling restore with InputObject(Deletedsite) details 
+
 ## PARAMETERS
 
 ### -AsJob