Skip to content

Commit c33ed9c

Browse files
authored
Merge pull request #294915 from AbhishekMallick01/Feb-19-2025-AzFilesV
Azure Files vaulted backup GA - Doc updates for PLR
2 parents 56b5ccd + e6e8000 commit c33ed9c

17 files changed

+179
-186
lines changed

articles/backup/azure-file-share-backup-overview.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: About Azure Files backup
33
description: Learn how to back up Azure Files in the Recovery Services vault
44
ms.topic: overview
5-
ms.date: 03/05/2025
5+
ms.date: 02/27/2025
66
ms.service: azure-backup
77
ms.custom:
88
- engagement-fy23
@@ -87,8 +87,8 @@ For snapshot tier, you incur the following costs:
8787

8888
To get detailed estimates for backing up Azure Files, you can download the detailed [Azure Backup pricing estimator](https://aka.ms/AzureBackupCostEstimates).
8989

90-
>[!Note]
91-
>There are no additional charges for vaulted backups. However, you will incur the cost for the snapshots taken as part of the backup process.
90+
>[!Important]
91+
>For vaulted backup, you will incur a protected instance fee and charges for backup storage for your standard and premium shares from April 1,2025.
9292
9393
## How lease snapshot works?
9494

articles/backup/azure-file-share-support-matrix.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Support Matrix for Azure files backup by using Azure Backup
33
description: Provides a summary of support settings and limitations when backing up Azure files.
44
ms.topic: reference
5-
ms.date: 03/05/2025
5+
ms.date: 02/27/2025
66
ms.custom: references_regions, engagement-fy24
77
ms.service: azure-backup
88
author: jyothisuri
@@ -88,7 +88,7 @@ Cross Subscription Backup (CSB) for Azure Files (preview) is currently available
8888
| -------------------------------------------------- | ------ |
8989
| Standard | Supported |
9090
| Large | Supported |
91-
| Premium | Supported |
91+
| Premium | Supported (in preview) |
9292
| File Shares connected with Azure File Sync service | Supported |
9393

9494

@@ -124,8 +124,8 @@ Cross Subscription Backup (CSB) for Azure Files (preview) is currently available
124124

125125
| Setting | Limit |
126126
| --------------------------------------- | ------ |
127-
| Maximum size of File Share | 8 TB |
128-
| Maximum number of files in a File Share | 8 million |
127+
| Maximum size of File Share | 10 TB |
128+
| Maximum number of files in a File Share | 10 million |
129129

130130
>[!Note]
131131
>If you have multiple backups scheduled per day, only the last scheduled backup of the day is transferred to the vault.
@@ -230,7 +230,7 @@ The following table lists the behavior of backups due to customer-initiated fail
230230

231231
## Next steps
232232

233-
* Learn how to [Back up Azure files](backup-afs.md)
234-
* Learn how to [Restore Azure files](restore-afs.md)
235-
* Learn how to [Manage Azure files backups](manage-afs-backup.md)
233+
* [Back up Azure Files using Azure portal](backup-afs.md).
234+
* [Restore Azure Files using Azure portal](restore-afs.md).
235+
* [Manage Azure Files backups using Azure portal](manage-afs-backup.md).
236236

articles/backup/backup-azure-afs-automation.md

Lines changed: 6 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,18 @@
11
---
2-
title: Back up Azure files by using PowerShell
3-
description: In this article, learn how to back up Azure Files by using the Azure Backup service and PowerShell.
2+
title: Back up Azure files using PowerShell
3+
description: Learn how to use Azure PowerShell to back up Azure Files through an Azure Backup Recovery Services vault.
44
ms.topic: how-to
5-
ms.date: 03/05/2025
5+
ms.date: 02/27/2025
66
ms.custom: devx-track-azurepowershell
77
ms.service: azure-backup
88
author: jyothisuri
99
ms.author: jsuri
1010
---
1111

12-
# Back up Azure Files by using Azure PowerShell
12+
# Back up Azure Files using Azure PowerShell
1313

1414
This article describes how to use Azure PowerShell to back up Azure Files through an [Azure Backup](backup-overview.md) Recovery Services vault.
1515

16-
This article explains how to:
17-
18-
> [!div class="checklist"]
19-
>
20-
> * Set up PowerShell and register the Recovery Services provider.
21-
> * Create a Recovery Services vault.
22-
> * Configure backup for Azure Files.
23-
> * Run a backup job.
24-
2516
## Prerequisites
2617

2718
Before you back up Azure Files, ensure that the following prerequisites are met:
@@ -451,5 +442,5 @@ Azure Files snapshots are used while the backups are taken. Usually the job fini
451442

452443
## Next steps
453444

454-
* Learn about [backing up Azure Files in the Azure portal](backup-afs.md).
455-
* Refer to the [sample script on GitHub](https://github.com/Azure-Samples/Use-PowerShell-for-long-term-retention-of-Azure-Files-Backup) for using an Azure Automation runbook to schedule backups.
445+
- [Restore Azure Files using Azure PowerShell](restore-afs-powershell.md).
446+
- [Sample script on GitHub](https://github.com/Azure-Samples/Use-PowerShell-for-long-term-retention-of-Azure-Files-Backup) for using an Azure Automation runbook to schedule backups.

articles/backup/backup-azure-files.md

Lines changed: 13 additions & 64 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Back up Azure Files in the Azure portal
33
description: Learn how to use the Azure portal to back up Azure Files in the Recovery Services vault
44
ms.topic: how-to
5-
ms.date: 03/05/2025
5+
ms.date: 02/27/2025
66
ms.service: azure-backup
77
ms.custom: engagement-fy23
88
author: jyothisuri
@@ -15,19 +15,24 @@ This article describes how to back up [Azure Files](../storage/files/storage-fil
1515

1616
Azure Files backup is a native cloud solution that protects your data and eliminates on-premises maintenance overheads. Azure Backup seamlessly integrates with Azure File Sync, centralizing your file share data and backups. The simple, reliable, and secure solution allows you to protect your enterprise file shares using [snapshot](azure-file-share-backup-overview.md?tabs=snapshot) and [vaulted](azure-file-share-backup-overview.md?tabs=vault-standard) backups, ensuring data recovery for accidental or malicious deletion.
1717

18+
[Azure Backup](backup-overview.md) supports configuring [snapshot](azure-file-share-backup-overview.md?tabs=snapshot) and [vaulted](azure-file-share-backup-overview.md?tabs=vault-standard) backups for Azure Files in your storage accounts. You can:
19+
20+
- Define backup schedules and retention settings.
21+
- Store backup data in the Recovery Service vault, retaining it for up to **10 years**.
22+
23+
1824
## Prerequisites
1925

2026
* Ensure the file share is present in one of the supported storage account types. Review the [support matrix](azure-file-share-support-matrix.md).
21-
* Identify or create a [Recovery Services vault](#create-a-recovery-services-vault) in the same region and subscription as the storage account that hosts the file share.
27+
* Identify or create a [Recovery Services vault](tutorial-backup-azure-files-vault-tier-portal.md#create-a-recovery-services-vault) in the same region and subscription as the storage account that hosts the file share.
28+
* [Create a backup policy for protection of Azure Files](quick-backup-azure-files-vault-tier-portal.md).
2229
* If the storage account access has restrictions, check the firewall settings of the account to ensure the exception **Allow Azure services on the trusted services list to access this storage account** is in grant state. You can refer to [this](../storage/common/storage-network-security.md?tabs=azure-portal#manage-exceptions) link for the steps to grant an exception.
2330
* Ensure that you allow the **Storage account key access** in the required storage account.
2431

2532
>[!Important]
2633
>To perform [Cross Subscription Backup (CSB) for protecting Azure Files (preview)](azure-file-share-backup-overview.md#how-cross-subscription-backup-for-azure-files-preview-works) in another subscription, ensure you register `Microsoft.RecoveryServices` in the **subscription of the file share** in addition to the given prerequisites. Learn about the [supported regions for Cross Subscription Backup (preview)](azure-file-share-support-matrix.md#supported-regions-for-cross-subscription-backup-preview).
2734
2835

29-
[!INCLUDE [How to create a Recovery Services vault](../../includes/backup-create-rs-vault.md)]
30-
3136
## Configure the backup
3237

3338
You can configure *snapshot backup* and *vaulted backup* for Azure Files from the *Recovery Services vault* or *File share pane*.
@@ -87,7 +92,7 @@ To configure backup for multiple file shares from the Recovery Services vault, f
8792
1. Configure the *Snapshot retention* and *Vault retention* duration to determine the expiry date of the recovery points.
8893

8994
>[!Note]
90-
>The *vault tier * provides longer retention than the *snapshot tier*.
95+
>The *vault tier* provides longer retention than the *snapshot tier*.
9196
1. Select **OK** to create the backup policy.
9297

9398
:::image type="content" source="./media/backup-afs/create-backup-policy-for-azure-file-share.png" alt-text="Screenshot shows how to create a new backup policy for Azure Files." lightbox="./media/backup-afs/create-backup-policy-for-azure-file-share.png":::
@@ -172,68 +177,12 @@ The following steps explain how you can configure backup for individual file sha
172177

173178
---
174179

175-
## Run an on-demand backup job
176-
177-
Occasionally, you might want to generate a backup snapshot, or recovery point, outside of the times scheduled in the backup policy. A common reason to generate an on-demand backup is right after you configure the backup policy. Based on the schedule in the backup policy, it might be hours or days until a snapshot is taken. To protect your data until the backup policy engages, initiate an on-demand backup. Creating an on-demand backup is often required before you make planned changes to your file shares.
178-
179-
**Choose an entry point**
180-
181-
# [Recovery Services vault](#tab/recovery-services-vault)
182-
183-
To run an on-demand backup, follow these steps:
184-
185-
1. Go to the **Recovery Services vault** and select **Backup items** from the menu.
186-
187-
1. On the **Backup items** pane, select the **Backup Management Type** as **Azure Storage (Azure Files)**.
188-
189-
1. Select the item for which you want to run an on-demand backup job.
190-
191-
1. In the **Backup Item** menu, select **Backup now**. Because this backup job is on demand, there's no retention policy associated with the recovery point.
192-
193-
:::image type="content" source="./media/backup-afs/azure-file-share-backup-now.png" alt-text="Screenshot showing to select Backup now." lightbox="./media/backup-afs/azure-file-share-backup-now.png":::
194-
195-
1. The **Backup Now** pane opens. Specify the last day you want to retain the recovery point. You can have a maximum retention of 10 years for an on-demand backup.
196-
197-
:::image type="content" source="./media/backup-afs/azure-file-share-on-demand-backup-retention.png" alt-text="Screenshot showing to choose retention date.":::
198-
199-
1. Select **OK** to confirm the on-demand backup job that runs.
200-
201-
1. Monitor the portal notifications to keep track of backup job run completion.
202-
203-
To monitor the job progress in the **Recovery Services vault** dashboard, go to **Recovery Services vault** > **Backup Jobs** > **In progress**.
204-
205-
# [File share pane](#tab/file-share-pane)
206-
207-
To run an on-demand backup, follow these steps:
208-
209-
1. Open the file share’s **Overview** pane for which you want to take an on-demand backup.
210-
211-
1. Under the **Operation** section, select **Backup**.
212-
213-
The context pane appears that lists **Vault Essentials**. Select **Backup Now** to take an on-demand backup.
214-
215-
![Screenshot shows how to select Backup Now.](./media/backup-afs/select-backup-now.png)
216-
217-
1. The **Backup Now** pane opens. Specify the retention for the recovery point. You can have a maximum retention of 10 years for an on-demand backup.
218-
219-
![Screenshot shows the option how to retain backup date.](./media/backup-afs/retain-backup-date.png)
220-
221-
1. Select **OK** to confirm.
222-
223-
>[!NOTE]
224-
>Azure Backup locks the storage account when you configure protection for any file share in the corresponding account. This feature provides protection against accidental deletion of a storage account with backed up file shares.
225-
226-
---
227-
228-
## Best practices
229-
230-
* Don't delete snapshots created by Azure Backup. Deleting snapshots can result in loss of recovery points and/or restore failures.
180+
Once the backup configuration is complete, you can [run an on-demand backup](tutorial-backup-azure-files-vault-tier-portal.md#run-an-on-demand-backup-job) to create the recovery point.
231181

232-
* Don't remove the lock taken on the storage account by Azure Backup. Deletion of the lock can make your storage account prone to accidental deletion. Learn more [about protect your resources with lock](/azure/azure-resource-manager/management/lock-resources).
233182

234183
## Next steps
235184

236185
Learn how to:
237186

238-
* [Restore Azure Files](restore-afs.md).
239-
* [Manage Azure Files backups](manage-afs-backup.md).
187+
* [Restore Azure Files using Azure portal](restore-afs.md).
188+
* [Manage Azure Files backups using Azure portal](manage-afs-backup.md).

articles/backup/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ metadata:
1313
ms.topic: landing-page
1414
author: jyothisuri
1515
ms.author: jsuri
16-
ms.date: 03/05/2025
16+
ms.date: 02/27/2025
1717
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | tutorial | video | whats-new
1818

1919
landingContent:

articles/backup/manage-afs-backup-cli.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,17 @@
11
---
22
title: Manage Azure Files backups with the Azure CLI
3-
description: Learn how to use the Azure CLI to manage and monitor Azure Files backed up by Azure Backup.
3+
description: Learn how to manage and monitor the backed-up Azure Files using Azure CLI.
44
ms.topic: how-to
55
ms.custom: devx-track-azurecli
6-
ms.date: 03/05/2025
6+
ms.date: 02/27/2025
77
author: jyothisuri
88
ms.author: jsuri
99

1010
---
1111

1212
# Manage Azure Files backups with the Azure CLI
1313

14-
This article describes how to manage and monitor the backed-up Azure Files ([snapshot](azure-file-share-backup-overview.md?tabs=snapshot) and [vaulted](azure-file-share-backup-overview.md?tabs=vault-standard) backups) via [Azure Backup](./backup-overview.md) using Azure CLI. The Azure CLI provides a command-line experience for managing Azure resources. It's a great tool for building custom automation to use Azure resources. You can also perform these steps with the [Azure portal](https://portal.azure.com/).
14+
This article describes how to manage and monitor the backed-up Azure Files ([snapshot](azure-file-share-backup-overview.md?tabs=snapshot) and [vaulted](azure-file-share-backup-overview.md?tabs=vault-standard) backups) using Azure CLI. The Azure CLI provides a command-line experience for managing Azure resources. It's a great tool for building custom automation to use Azure resources. You can also perform these steps with the [Azure portal](https://portal.azure.com/).
1515

1616
## Prerequisites
1717

@@ -489,4 +489,4 @@ az backup container unregister --vault-name azurefilesvault --resource-group azu
489489

490490
## Next steps
491491

492-
For more information, see [Troubleshoot Azure Files backup](troubleshoot-azure-files.md).
492+
[Troubleshoot Azure Files backup](troubleshoot-azure-files.md).

articles/backup/quick-backup-azure-files-vault-tier-arm.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: Quickstart - Azure Resource Manager template for Azure Files vaulted backup
3-
description: Learn how to back up your Azure Files to vault-tier with an Azure Resource Manager template.
2+
title: Quickstart - Configure vaulted backup for Azure Files using Azure Resource Manager
3+
description: Learn how to configure vaulted backup for Azure Files using Azure Resource Manager.
44
ms.devlang: azurecli
55
ms.custom:
66
- ignite-2024
77
ms.topic: quickstart
8-
ms.date: 10/07/2024
8+
ms.date: 02/27/2025
99
ms.service: azure-backup
1010
author: jyothisuri
1111
ms.author: jsuri
@@ -307,6 +307,6 @@ New-AzResourceGroupDeployment -existingResourceGroupName $existingResourceGroupN
307307

308308
## Next steps
309309

310-
- [Track the backup job](manage-afs-powershell.md#track-backup-and-restore-jobs)
311-
- [Restore Azure Files using Azure PowerShell](restore-afs-powershell.md)
310+
- [Track the backup job using Azure PowerShell](manage-afs-powershell.md#track-backup-and-restore-jobs).
311+
- [Restore Azure Files using Azure PowerShell](restore-afs-powershell.md).
312312

articles/backup/quick-backup-azure-files-vault-tier-bicep.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: Quickstart - Azure Bicep template for Azure Files vaulted backup
3-
description: Learn how to back up your Azure Files to vault-tier with an Azure Bicep template.
2+
title: Quickstart - Configure vaulted backup for Azure Files using Azure Bicep
3+
description: Learn how to configure vaulted backup for Azure Files using Azure Bicep.
44
ms.devlang: azurecli
55
ms.custom:
66
- ignite-2024
77
ms.topic: quickstart
8-
ms.date: 10/07/2024
8+
ms.date: 02/27/2025
99
ms.service: azure-backup
1010
author: jyothisuri
1111
ms.author: jsuri
@@ -231,6 +231,6 @@ To deploy the template, follow these steps:
231231
232232
## Next steps
233233
234-
- [Track the backup job](manage-afs-powershell.md#track-backup-and-restore-jobs)
235-
- [Restore Azure Files using Azure PowerShell](restore-afs-powershell.md)
234+
- [Track the backup job using Azure PowerShell](manage-afs-powershell.md#track-backup-and-restore-jobs).
235+
- [Restore Azure Files using Azure PowerShell](restore-afs-powershell.md).
236236

articles/backup/quick-backup-azure-files-vault-tier-cli.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
---
2-
title: Quickstart - Azure CLI for Azure Files vaulted backup
3-
description: Learn how to back up your Azure Files to vault-tier with Azure CLI.
2+
title: Quickstart - Configure vaulted backup for Azure Files using Azure CLI
3+
description: Learn how to configure vaulted backup for Azure Files using Azure CLI.
44
ms.devlang: azurecli
55
ms.custom:
66
- ignite-2024
77
ms.topic: quickstart
8-
ms.date: 10/07/2024
8+
ms.date: 02/27/2025
99
ms.service: azure-backup
1010
author: jyothisuri
1111
ms.author: jsuri
1212
---
1313

1414
# Quickstart: Configure vaulted backup for Azure Files using Azure CLI
1515

16-
This quickstart describes how to configure vaulted backup for Azure Files using Azure CLI. The Azure CLI is used to create and manage Azure resources from the command line or in scripts. You can also perform these steps with [Azure PowerShell](quick-backup-azure-files-vault-tier-powershell.md) or in the [Azure portal](quick-backup-azure-files-vault-tier-portal.md).
16+
This quickstart describes how to configure vaulted backup for Azure Files using Azure CLI. The Azure CLI is used to create and manage Azure resources from the command line or in scripts. You can also perform these steps with [Azure PowerShell](quick-backup-azure-files-vault-tier-powershell.md) or in the [Azure portal](tutorial-backup-azure-files-vault-tier-portal.md#configure-backup).
1717

1818
[Azure Backup](backup-overview.md) supports configuring [snapshot](azure-file-share-backup-overview.md?tabs=snapshot) and [vaulted](azure-file-share-backup-overview.md?tabs=vault-standard) backups for Azure Files in your storage accounts. Vaulted backups offer an offsite solution, storing data in a general v2 storage account to protect against ransomware and malicious admin actions. You can:
1919

@@ -93,10 +93,10 @@ output
9393
}
9494
```
9595

96-
## Next step
96+
## Next steps
9797

98-
- [Restore Azure Files using CLI](restore-afs-cli.md)
99-
- [Manage Azure Files backups using CLI](manage-afs-backup-cli.md?tabs=vault-standard)
98+
- [Restore Azure Files using CLI](restore-afs-cli.md).
99+
- [Manage Azure Files backups using CLI](manage-afs-backup-cli.md?tabs=vault-standard).
100100

101101

102102

0 commit comments

Comments
 (0)