Merge branch 'release-afs-backup' into Feb-12-2025-AFSv2

Author: AbhishekMallick01

articles/backup/backup-afs-cli.md

@@ -1,22 +1,22 @@
 ---
-title: Back up Azure file shares with Azure CLI
-description: Learn how to use Azure CLI to back up Azure file shares in the Recovery Services vault
+title: Back up Azure Files with Azure CLI
+description: Learn how to use Azure CLI to back up Azure Files in the Recovery Services vault
 ms.topic: how-to
 ms.custom: devx-track-azurecli, engagement-fy24
-ms.date: 03/20/2024
+ms.date: 03/05/2025
 author: jyothisuri
 ms.author: jsuri
 ---
 
-# Back up Azure file shares with Azure CLI
+# Back up Azure Files with 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. This article details how to back up Azure file shares with Azure CLI. You can also perform these steps via [Azure PowerShell](./backup-azure-afs-automation.md) or the [Azure portal](backup-afs.md).
+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. This article details how to back up Azure Files with Azure CLI. You can also perform these steps via [Azure PowerShell](./backup-azure-afs-automation.md) or the [Azure portal](backup-afs.md).
 
 By the end of this tutorial, you'll learn how to perform the operations below with Azure CLI:
 
 * Create a Recovery Services vault
-* Enable backup for Azure file shares
-* Trigger an on-demand backup for file shares
+* Enable backup for Azure Files
+* Trigger an on-demand backup for File Shares
 
 [!INCLUDE [azure-cli-prepare-your-environment.md](~/reusable-content/azure-cli/azure-cli-prepare-your-environment.md)]
 
@@ -54,13 +54,13 @@ Follow these steps to create a Recovery Services vault:
     eastus      azurefilesvault     azurefiles
     ```
 
-## Enable backup for Azure file shares
+## Enable backup for Azure Files
 
-This section assumes that you already have an Azure file share for which you want to configure backup. If you don't have one, create an Azure file share using the [az storage share create](/cli/azure/storage/share#az-storage-share-create) command.
+This section assumes that you already have an Azure Files for which you want to configure backup. If you don't have one, create an Azure Files using the [az storage share create](/cli/azure/storage/share#az-storage-share-create) command.
 
-To enable backup for file shares, you need to create a protection policy that defines when a backup job runs and how long recovery points are stored. You can create a backup policy using the [az backup policy create](/cli/azure/backup/policy#az-backup-policy-create) cmdlet.
+To enable backup for File Shares, you need to create a protection policy that defines when a backup job runs and how long recovery points are stored. You can create a backup policy using the [az backup policy create](/cli/azure/backup/policy#az-backup-policy-create) cmdlet.
 
-The following example uses the [az backup protection enable-for-azurefileshare](/cli/azure/backup/protection#az-backup-protection-enable-for-azurefileshare) cmdlet to enable backup for the *azurefiles* file share in the *afsaccount* storage account using the *schedule 1* backup policy:
+The following example uses the [az backup protection enable-for-azurefileshare](/cli/azure/backup/protection#az-backup-protection-enable-for-azurefileshare) cmdlet to enable backup for the *azurefiles* File Share in the *afsaccount* storage account using the *schedule 1* backup policy:
 
 ```azurecli-interactive
 az backup protection enable-for-azurefileshare --vault-name azurefilesvault --resource-group  azurefiles --policy-name schedule1 --storage-account afsaccount --azure-file-share azurefiles  --output table
@@ -74,14 +74,14 @@ Name                                  ResourceGroup
 
 The **Name** attribute in the output corresponds to the name of the job that's created by the backup service for your **enable backup** operation. To track status of the job, use the [az backup job show](/cli/azure/backup/job#az-backup-job-show) cmdlet.
 
-## Trigger an on-demand backup for file share
+## Trigger an on-demand backup for File Share
 
-If you want to trigger an on-demand backup for your file share instead of waiting for the backup policy to run the job at the scheduled time, use the [az backup protection backup-now](/cli/azure/backup/protection#az-backup-protection-backup-now) cmdlet.
+If you want to trigger an on-demand backup for your File Share instead of waiting for the backup policy to run the job at the scheduled time, use the [az backup protection backup-now](/cli/azure/backup/protection#az-backup-protection-backup-now) cmdlet.
 
 You need to define the following parameters to trigger an on-demand backup:
 
-* **--container-name** is the name of the storage account hosting the file share. To retrieve the **name** or **friendly name** of your container, use the [az backup container list](/cli/azure/backup/container#az-backup-container-list) command.
-* **--item-name** is the name of the file share for which you want to trigger an on-demand backup. To retrieve the **name** or **friendly name** of your backed-up item, use the [az backup item list](/cli/azure/backup/item#az-backup-item-list) command.
+* **--container-name** is the name of the storage account hosting the File Share. To retrieve the **name** or **friendly name** of your container, use the [az backup container list](/cli/azure/backup/container#az-backup-container-list) command.
+* **--item-name** is the name of the File Share for which you want to trigger an on-demand backup. To retrieve the **name** or **friendly name** of your backed-up item, use the [az backup item list](/cli/azure/backup/item#az-backup-item-list) command.
 * **--retain-until** specifies the date until when you want to retain the recovery point. The value should be set in UTC time format (dd-mm-yyyy).
 
 The following example triggers an on-demand backup for the *azurefiles* fileshare in the *afsaccount* storage account with retention until *20-01-2020*.
@@ -100,5 +100,5 @@ The **Name** attribute in the output corresponds to the name of the job that's c
 
 ## Next steps
 
-* Learn how to [Restore Azure file shares with CLI](restore-afs-cli.md)
-* Learn how to [Manage Azure file share backups with CLI](manage-afs-backup-cli.md)
+* Learn how to [Restore Azure Files with CLI](restore-afs-cli.md)
+* Learn how to [Manage Azure Files backups with CLI](manage-afs-backup-cli.md)

articles/backup/backup-support-automation.md

@@ -72,7 +72,7 @@ You  can automate most backup related tasks using programmatic methods in Azure
 
 | **Category** | **Operation** | **PowerShell** | **CLI** | **REST API** | **Azure Policy** | **ARM Template** | **Bicep** | **Terraform** |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| Backup | Create backup policy and configure backup | Supported    <br><br> [See the examples](./backup-azure-afs-automation.md#configure-a-backup-policy). | Supported    <br><br> [See the examples](./backup-afs-cli.md#enable-backup-for-azure-file-shares). | Supported    <br><br> [See the examples](./backup-azure-file-share-rest-api.md#configure-backup-for-an-unprotected-azure-files-using-rest-api). | Currently not supported | Supported    <br><br> [See the examples](./backup-rm-template-samples.md). | Supported | Supported <br><br> [See the examples](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/backup_protected_file_share). |
+| Backup | Create backup policy and configure backup | Supported    <br><br> [See the examples](./backup-azure-afs-automation.md#configure-a-backup-policy). | Supported    <br><br> [See the examples](./backup-afs-cli.md#enable-backup-for-azure-files). | Supported    <br><br> [See the examples](./backup-azure-file-share-rest-api.md#configure-backup-for-an-unprotected-azure-file-share-using-rest-api). | Currently not supported | Supported    <br><br> [See the examples](./backup-rm-template-samples.md). | Supported | Supported <br><br> [See the examples](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/backup_protected_file_share). |
 | Backup | Run on-demand backup | Supported    <br><br> [See the examples](./backup-azure-afs-automation.md#trigger-an-on-demand-backup). | Supported    <br><br> [See the examples](./backup-afs-cli.md#trigger-an-on-demand-backup-for-file-share). | Supported    <br><br> [See the examples](./backup-azure-file-share-rest-api.md#trigger-an-on-demand-backup-for-file-share). | N/A | N/A | N/A | N/A |
 | Restore | Restore to original or alternate location | Supported    <br><br> [See the examples](./restore-afs-powershell.md). | Supported    <br><br> [See the examples](./restore-afs-cli.md). | Supported    <br><br> [See the examples](./restore-azure-file-share-rest-api.md). | N/A | N/A |N/A | N/A |
 | Manage | Monitor jobs | Supported    <br><br> [See the examples](./manage-afs-powershell.md#track-backup-and-restore-jobs). | Supported    <br><br> [See the examples](./manage-afs-backup-cli.md#monitor-jobs). | Supported    <br><br> [See the examples](./manage-azure-file-share-rest-api.md#monitor-jobs). | N/A | N/A |N/A | N/A |

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

@@ -11,21 +11,21 @@ author: jyothisuri
 ms.author: jsuri
 ---
 
-#  Quickstart: Configure vaulted backup for Azure File share using Azure Resource Manager
+#  Quickstart: Configure vaulted backup for Azure Files using Azure Resource Manager
 
-This quickstart describes how to configure vaulted backup for Azure File share using Azure Resource Manager (ARM) template.
+This quickstart describes how to configure vaulted backup for Azure Files using Azure Resource Manager (ARM) template.
 
-Azure Backup supports configuring snapshot and vaulted backups for Azure File shares in your storage accounts. Vaulted backup offers an offsite solution, storing data in a general v2 storage account to protect against ransomware and malicious admin actions.
+Azure Backup 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 backup offers an offsite solution, storing data in a general v2 storage account to protect against ransomware and malicious admin actions.
 
 An Azure Resource Manager template is a JavaScript Object Notation (JSON) that defines your project's infrastructure and configuration using declarative syntax. It allows you to specify your intended deployment without writing programming commands.
 
 ## Prerequisites
 
-Before you configure vaulted backup for Azure Files, ensure that you have a storage account with an existing file share. To create a new storage account and file share, see [create an Azure storage account with file share template](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.storage/storage-file-share).
+Before you configure vaulted backup for Azure Files, ensure that you have a storage account with an existing File Share. To create a new storage account and File Share, see [create an Azure storage account with File Share template](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.storage/storage-file-share).
 
 ## Review the template
 
-The [Azure Quickstart Template](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.recoveryservices/recovery-services-backup-file-share) configures protection for an existing File share in a Storage Account. It creates or uses a Recovery Services Vault and Backup Policy based on parameter values.
+The [Azure Quickstart Template](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.recoveryservices/recovery-services-backup-file-share) configures protection for an existing File Share in a Storage Account. It creates or uses a Recovery Services Vault and Backup Policy based on parameter values.
 
 ```json
 {

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

@@ -11,11 +11,11 @@ author: jyothisuri
 ms.author: jsuri
 ---
 
-#  Quickstart: Configure vaulted backup for Azure File share using Azure Bicep
+#  Quickstart: Configure vaulted backup for Azure Files using Azure Bicep
 
-This quickstart describes how to configure vaulted backup for Azure File share using Azure Bicep template.
+This quickstart describes how to configure vaulted backup for Azure Files using Azure Bicep template.
 
-[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 File shares in your storage accounts. Vaulted backup offers an offsite solution, storing data in a general v2 storage account to protect against ransomware and malicious admin actions.
+[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 backup offers an offsite solution, storing data in a general v2 storage account to protect against ransomware and malicious admin actions.
 
 Bicep is a language for declaratively deploying Azure resources, offering a simpler syntax and better development experience compared to JSON. It abstracts ARM template JSON, providing all its capabilities. During deployment, the Bicep CLI converts a Bicep file into Azure Resource Manager (ARM) template JSON. A Bicep file specifies Azure resources and properties without needing programming commands. Resource types, API versions, and properties valid in ARM templates are also valid in Bicep files.
 
@@ -29,7 +29,7 @@ Before you configure vaulted backup for Azure Files, ensure that you set up your
 
 ## Review the template
 
-The [Azure Quickstart Template](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.recoveryservices/recovery-services-backup-file-share) configures protection for an existing File share in a Storage Account. It creates or uses a Recovery Services Vault and Backup Policy based on parameter values.
+The [Azure Quickstart Template](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.recoveryservices/recovery-services-backup-file-share) configures protection for an existing File Share in a Storage Account. It creates or uses a Recovery Services Vault and Backup Policy based on parameter values.
 
 ```json
 @description('Name of the existing Resource Group in which the existing Storage Account is present.')

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

@@ -13,7 +13,7 @@ ms.author: jsuri
 
 #  Quickstart: Configure vaulted backup for Azure Files using Azure portal
 
-This quickstart describes how to configure vaulted backup for Azure Files using the Azure portal. You can also configure backup with Azure CLI or Azure PowerShell.
+This quickstart describes how to configure vaulted backup for Azure Files using the Azure portal. You can also configure backup with [Azure CLI](quick-backup-azure-files-vault-tier-cli.md) or [Azure PowerShell](quick-backup-azure-files-vault-tier-powershell.md).
 
 [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:
 

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

@@ -13,7 +13,7 @@ ms.author: jsuri
 
 #  Quickstart: Configure vaulted backup for Azure Files using Azure PowerShell
 
-This quickstart describes how to configure vaulted backup for Azure Files using Azure PowerShell. You can also configure backup with Azure CLI or in the Azure portal.
+This quickstart describes how to configure vaulted backup for Azure Files using Azure PowerShell. You can also configure backup with [Azure CLI](quick-backup-azure-files-vault-tier-cli.md) or in the [Azure portal](quick-backup-azure-files-vault-tier-portal.md).
 
 [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:
 
@@ -28,16 +28,16 @@ Before you configure vaulted backup for Azure Files, ensure that the following p
 - Ensure that File Share is in a supported storage account type. See the [Azure Files backup support matrix](azure-file-share-support-matrix.md).
 
 - Allow **Azure services on the trusted services list**  in the **Firewall settings** to access the storage account, if access is restricted. Learn [how to grant an exception](/azure/storage/common/storage-network-security?tabs=azure-portal#manage-exceptions).
-- Use an existing Recovery Services vault. If you don't have the vault, [create one](backup-azure-afs-automation.md#create-a-recovery-services-vault).
-- [Configure a Backup policy](backup-azure-afs-automation.md#configure-a-backup-policy) for the backup operation.
+- Use an existing Recovery Services vault. If you don't have the vault, [create one](backup-azure-afs-automation.md?tabs=vault-standard#create-a-recovery-services-vault).
+- [Configure a Backup policy](backup-azure-afs-automation.md?tabs=vault-standard#configure-a-backup-policy) for the backup operation.
 
 ## Configure backup
 
 To configure vaulted backup for Azure Files, use the [`Enable-AzRecoveryServicesBackupProtection`](/powershell/module/az.recoveryservices/enable-azrecoveryservicesbackupprotection) cmdlet. 
 
 >[!Note]
 >After the policy is associated with the vault, backups are triggered in accordance with the policy schedule.
-The following example cmdlet configures protection for the Azure file share `testAzureFS` in storage account `testStorageAcct`, with the policy `dailyafs`:
+The following example cmdlet configures protection for the Azure Files `testAzureFS` in storage account `testStorageAcct`, with the policy `dailyafs`:
 
 ```azurepowershell-interactive
 Enable-AzRecoveryServicesBackupProtection -StorageAccountName "testStorageAcct" -Name "testAzureFS" -Policy $afsPol
@@ -53,8 +53,8 @@ testAzureFS       ConfigureBackup      Completed            11/12/2018 2:15:26 P
 
 ## Next step
 
-- [Restore Azure file shares using Azure PowerShell](restore-afs-powershell.md)
-- [Manage Azure file share backups using Azure PowerShell](manage-afs-powershell.md)
+- [Restore Azure Files using Azure PowerShell](restore-afs-powershell.md)
+- [Manage Azure Files backups using Azure PowerShell](manage-afs-powershell.md?tabs=vault-standard)