Skip to content

Commit 2aa19ae

Browse files
committed
376112-content-pattern-metadata-updates-app-service
1 parent f3a80bf commit 2aa19ae

File tree

3 files changed

+47
-44
lines changed

3 files changed

+47
-44
lines changed

articles/app-service/app-service-undelete.md

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -12,14 +12,14 @@ ms.custom: devx-track-azurepowershell
1212

1313
If you accidentally deleted an app in Azure App Service, you can now restore it by using the Azure portal or PowerShell.
1414

15-
## Restore deleted App Service app by using the Azure portal
15+
## Restore a deleted App Service app by using the Azure portal
1616

1717
If you deleted your app in Azure App Service, you can restore it from the portal by following these steps:
1818

1919
1. Go to App Services in the Azure portal.
2020
1. Select **Manage Deleted Apps**.
2121
1. Select **Subscription**.
22-
1. From the dropdown, select the deleted app. Apps deleted in the last 30 days show in the dropdown list.
22+
1. From the dropdown, select the deleted app. Apps deleted in the last 30 days appear in the dropdown list.
2323
1. Select the destination app from the dropdown that correlates to where you want to restore your app.
2424
1. If you would like to restore the deleted app to a slot of the destination app, select the slot checkbox and select available slots from the dropdown.
2525
1. By default, only app content is restored. If you want app configuration to also be restored, select **Restore App configuration**.
@@ -67,22 +67,26 @@ The detailed information includes:
6767
>* `Restore-AzDeletedWebApp` isn't supported for function apps hosted on the Consumption plan or Elastic Premium plan.
6868
>* The `Restore-AzDeletedWebApp` cmdlet restores a deleted web app. The web app specified by `TargetResourceGroupName`, `TargetName`, and `TargetSlot` is overwritten with the contents and settings of the deleted web app. If the target parameters aren't specified, they're automatically filled with the deleted web app's resource group, name, and slot. If the target web app doesn't exist, it's automatically created in the App Service plan specified by `TargetAppServicePlanName`.
6969
>* By default `Restore-AzDeletedWebApp` restores both your app configuration and any content. If you want to only restore content, you use the `-RestoreContentOnly` flag with this cmdlet.
70-
>* Custom domains, bindings, or certs that you import to your app isn't restored. You'll need to add them again after your app is restored.
70+
>* Custom domains, bindings, or certs that you import to your app aren't restored. You need to add them again after your app is restored.
7171
7272
After identifying the app you want to restore, you can restore it by using `Restore-AzDeletedWebApp`, as shown in the following examples.
73-
>You can find the full cmdlet reference here: [`Restore-AzDeletedWebApp`](/powershell/module/az.websites/restore-azdeletedwebapp).
7473

75-
>Restore to the original app name:
74+
You can find the full cmdlet reference here: [`Restore-AzDeletedWebApp`](/powershell/module/az.websites/restore-azdeletedwebapp).
75+
76+
Restore to the original app name:
77+
7678
```powershell
7779
Restore-AzDeletedWebApp -TargetResourceGroupName <my_rg> -Name <my_app> -TargetAppServicePlanName <my_asp>
7880
```
7981

80-
>Restore to a different app name:
82+
Restore to a different app name:
83+
8184
```powershell
8285
Restore-AzDeletedWebApp -ResourceGroupName <original_rg> -Name <original_app> -TargetResourceGroupName <target_rg> -TargetName <target_app> -TargetAppServicePlanName <target_asp>
8386
```
8487

85-
>Restore a slot to target app:
88+
Restore a slot to target app:
89+
8690
```powershell
8791
Restore-AzDeletedWebApp -TargetResourceGroupName <my_rg> -Name <my_app> -TargetAppServicePlanName <my_asp> -Slot <original_slot>
8892
```
@@ -92,12 +96,14 @@ Restore-AzDeletedWebApp -TargetResourceGroupName <my_rg> -Name <my_app> -TargetA
9296
> The cmdlet restores the original slot to the target app's production slot.
9397
> By default, `Restore-AzDeletedWebApp` restores both your app configuration as well any content to the target app. If you want to only restore content, you use the `-RestoreContentOnly` flag with this cmdlet.
9498
95-
> Restore only site content to the target app:
99+
Restore only site content to the target app:
96100

97101
```powershell
98102
Restore-AzDeletedWebApp -TargetResourceGroupName <my_rg> -Name <my_app> -TargetAppServicePlanName <my_asp> -RestoreContentOnly
99103
```
100-
>Restore used for scenarios where multiple apps with the same name have been deleted with `-DeletedSiteId`
104+
105+
Restore in scenarios where multiple apps with the same name were deleted with `-DeletedSiteId`:
106+
101107
```powershell
102108
Restore-AzDeletedWebApp -ResourceGroupName <original_rg> -Name <original_app> -DeletedId /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.Web/locations/location/deletedSites/1234 -TargetAppServicePlanName <my_asp>
103109
@@ -109,7 +115,7 @@ The inputs for command are:
109115
- **`TargetName`**: Target app to which you're restoring the deleted app.
110116
- **`TargetAppServicePlanName`**: App Service plan linked to the app.
111117
- **Name**: Name for the app. We recommend that it's globally unique.
112-
- **`ResourceGroupName`**: Original resource group for the deleted app, you can get it from `Get-AzDeletedWebApp -Name <your_deleted_app> -Location <your_deleted_app_location>`
118+
- **`ResourceGroupName`**: Original resource group for the deleted app. You can get it from `Get-AzDeletedWebApp -Name <your_deleted_app> -Location <your_deleted_app_location>`
113119
- **Slot**: Slot for the deleted app.
114120
- **`RestoreContentOnly`**: By default `Restore-AzDeletedWebApp` restores both your app configuration as well any content. If you want to only restore content, you can use the `-RestoreContentOnly` flag with this cmdlet.
115121

@@ -118,28 +124,27 @@ The inputs for command are:
118124
119125
## Restore deleted Azure Functions app
120126

121-
If the function app was hosted on a **Dedicated app service plan**, it can be restored, as long as it used the default App Service storage.
127+
If a function app was hosted on a **Dedicated app service plan**, it can be restored, as long as it used the default App Service storage.
122128

123-
1. Fetch the `DeletedSiteId` of the app version you want to restore, by using `Get-AzDeletedWebApp` cmdlet:
129+
Fetch the `DeletedSiteId` of the app version you want to restore, by using `Get-AzDeletedWebApp` cmdlet:
124130

125131
```powershell
126132
Get-AzDeletedWebApp -ResourceGroupName <RGofDeletedApp> -Name <NameofApp>
127133
```
128134

129-
1. Create a new function app in a Dedicated plan. Refer to the instructions for [how to create an app in the portal](../azure-functions/functions-create-function-app-portal.md#create-a-function-app).
130-
1. Restore to the newly created function app by using this cmdlet:
135+
Create a new function app in a Dedicated plan. Refer to the instructions for [how to create an app in the portal](../azure-functions/functions-create-function-app-portal.md#create-a-function-app). Restore to the newly created function app by using this cmdlet:
131136

132137
```powershell
133138
Restore-AzDeletedWebApp -ResourceGroupName <RGofnewapp> -Name <newApp> -deletedId "/subscriptions/xxxx/providers/Microsoft.Web/locations/xxxx/deletedSites/xxxx"
134139
```
135140

136-
Currently there's no support to undelete (`Restore-AzDeletedWebApp`) a function app hosted in a Consumption plan or Elastic premium plan because the content resides on Azure Files in a storage account. If you didn't hard delete that Azure Files storage account, or if the account exists and file shares weren't deleted, then you can use the following steps as a workaround:
141+
Currently there's no support to use the `Restore-AzDeletedWebApp` cmdlet to undelete a function app hosted in a Consumption plan or Elastic premium plan, because the content resides on Azure Files in a storage account. If you didn't hard delete that Azure Files storage account, or if the account exists and you didn't delete file shares, you can use the following steps as a workaround:
137142

138143
1. Create a new function app in a Consumption or Premium plan. Refer the instructions for [how to create an app in the portal](../azure-functions/functions-create-function-app-portal.md#create-a-function-app).
139144
1. Set the following [app settings](../azure-functions/functions-how-to-use-azure-function-app-settings.md?tabs=portal#settings) to refer to the old storage account, which contains the content from the previous app.
140145

141-
| App Setting | Suggested value |
142-
| ------------ | ---------------- |
143-
| **AzureWebJobsStorage** | Connection String for the storage account used by the deleted app. |
144-
| **WEBSITE_CONTENTAZUREFILECONNECTIONSTRING** | Connection String for the storage account used by the deleted app. |
145-
| **WEBSITE_CONTENTSHARE** | File share on storage account used by the deleted app. |
146+
| App Setting | Suggested value |
147+
| ------------ | ---------------- |
148+
| `AzureWebJobsStorage` | Connection string for the storage account used by the deleted app. |
149+
| `WEBSITE_CONTENTAZUREFILECONNECTIONSTRING` | Connection string for the storage account used by the deleted app. |
150+
| `WEBSITE_CONTENTSHARE` | File share on storage account used by the deleted app. |

articles/app-service/app-service-web-app-cloning.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@ ms.author: msangapu
1212

1313
[!INCLUDE [updated-for-az](~/reusable-content/ce-skilling/azure/includes/updated-for-az.md)]
1414

15-
With the release of Microsoft Azure PowerShell version 1.1.0, there's a new option for `New-AzWebApp`. By using this option, you can clone an existing App Service app to a newly created app in a different region or in the same region. This option enables customers to deploy multiple apps across different regions quickly and easily.
15+
With the release of Microsoft Azure PowerShell version 1.1.0, there's a new option for `New-AzWebApp`. By using this option, you can clone an existing App Service app to a newly created app in a different region or in the same region. You can deploy multiple apps across different regions quickly and easily.
1616

17-
App cloning is supported for Standard, Premium, Premium V2, and Isolated app service plans. The new feature uses the same limitations as the App Service Backup feature, see [Back up an app in Azure App Service](manage-backup.md).
17+
App cloning is supported for Standard, Premium, Premium V2, and Isolated App Service plans. The feature uses the same limitations as the App Service Backup feature, see [Back up an app in Azure App Service](manage-backup.md).
1818

1919
## Clone an existing app
2020

@@ -26,31 +26,31 @@ When you know the name of the resource group that contains the source app, you c
2626
$srcapp = Get-AzWebApp -ResourceGroupName SourceAzureResourceGroup -Name source-webapp
2727
```
2828

29-
To create a new App Service Plan, you can use the `New-AzAppServicePlan` command shown in the following example:
29+
To create a new App Service plan, you can use the `New-AzAppServicePlan` command shown in the following example:
3030

3131
```powershell
3232
New-AzAppServicePlan -Location "North Central US" -ResourceGroupName DestinationAzureResourceGroup -Name DestinationAppServicePlan -Tier Standard
3333
```
3434

35-
By using the `New-AzWebApp` command, you can create the new app in the North Central US region, and tie it to an existing App Service Plan. Moreover, you can use the same resource group as the source app, or define a new resource group. See the following command:
35+
By using the `New-AzWebApp` command, you can create the new app in the North Central US region, and tie it to an existing App Service plan. Moreover, you can use the same resource group as the source app, or define a new resource group. See the following command:
3636

3737
```powershell
3838
$destapp = New-AzWebApp -ResourceGroupName DestinationAzureResourceGroup -Name dest-webapp -Location "North Central US" -AppServicePlan DestinationAppServicePlan -SourceWebApp $srcapp
3939
```
4040

41-
To clone an existing app including all associated deployment slots, you need to use the `IncludeSourceWebAppSlots` parameter. The `IncludeSourceWebAppSlots` parameter is supported only for cloning an entire app including all of its slots. The following PowerShell command demonstrates the use of that parameter with the `New-AzWebApp` command:
41+
To clone an existing app, including all associated deployment slots, you need to use the `IncludeSourceWebAppSlots` parameter. The `IncludeSourceWebAppSlots` parameter is supported only for cloning an entire app including all of its slots. The following PowerShell command demonstrates the use of that parameter with the `New-AzWebApp` command:
4242

4343
```powershell
4444
$destapp = New-AzWebApp -ResourceGroupName DestinationAzureResourceGroup -Name dest-webapp -Location "North Central US" -AppServicePlan DestinationAppServicePlan -SourceWebApp $srcapp -IncludeSourceWebAppSlots
4545
```
4646

47-
To clone an existing app within the same region, create a new resource group and a new app service plan in the same region. Then, use the following PowerShell command to clone the app:
47+
To clone an existing app within the same region, create a new resource group and a new App Service plan in the same region. Then, use the following PowerShell command to clone the app:
4848

4949
```powershell
5050
$destapp = New-AzWebApp -ResourceGroupName NewAzureResourceGroup -Name dest-webapp -Location "South Central US" -AppServicePlan NewAppServicePlan -SourceWebApp $srcapp
5151
```
5252

53-
## Clone an existing App to an App Service Environment
53+
## Clone an existing app to an App Service Environment
5454

5555
Scenario: You want to clone the contents of an existing app in the South Central US region to a new app in an existing App Service Environment.
5656

@@ -68,7 +68,7 @@ $destapp = New-AzWebApp -ResourceGroupName DestinationAzureResourceGroup -Name d
6868

6969
The `Location` parameter is required for legacy reasons, but ignored when you create the app in an App Service Environment.
7070

71-
## Clone an existing App Slot
71+
## Clone an existing app slot
7272

7373
Scenario: You want to clone an existing deployment slot of an app to either a new app or a new slot. The new app can be in the same region as the original app slot or in a different region.
7474

@@ -118,7 +118,7 @@ Here are the known restrictions of app cloning:
118118

119119
* Autoscale settings aren't cloned
120120
* Backup schedule settings aren't cloned
121-
* Virtual Network settings aren't cloned
121+
* Virtual network settings aren't cloned
122122
* Application Insights isn't automatically set up on the destination app
123123
* Easy Auth settings aren't cloned
124124
* Kudu extensions aren't cloned

0 commit comments

Comments
 (0)