Skip to content

Commit 85ee62e

Browse files
committed
Merge branch 'main' into release-automation-separate-troubleshooting-section
2 parents ff4347f + 611e986 commit 85ee62e

44 files changed

Lines changed: 486 additions & 284 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

articles/azure-vmware/configure-storage-policy.md

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -171,6 +171,84 @@ Run the `Update-StoragePolicyOfUnassociatedVsanObjects` cmdlet to modify curre
171171

172172
3. Check **Notifications** to see the progress.
173173

174+
## Delete unassociated vSAN objects using Run Command
175+
176+
Unassociated vSAN objects can remain in a cluster due to interrupted operations, policy mismatches, or failed workflows. These objects consume storage capacity and may block certain cluster operations.
177+
178+
This article explains how to **list** and **delete** unassociated vSAN objects in **Azure VMware Solution (AVS)** using **Run Command**.
179+
180+
### Prerequisites
181+
182+
Before listing or deleting unassociated vSAN objects, ensure that:
183+
184+
- You have access to the Azure portal with permissions equivalent to the **cloudadmin** role for the AVS private cloud.
185+
- The cluster meets the minimum host requirements for its vSAN configuration (OSA or ESA).
186+
- You are using the latest supported version of the **Microsoft.AVS.Management** Run Command package.
187+
- You have validated that the objects to be deleted are **not required** by any workload, management VM, or system component.
188+
189+
### List unassociated vSAN objects
190+
191+
Before deleting any objects, list and review them to confirm that they are truly unassociated.
192+
193+
Use the **Get‑UnassociatedVsanObjectsWithPolicy** Run Command to list unassociated vSAN objects and obtain their UUIDs.
194+
195+
For detailed steps, see:
196+
197+
- [List storage policies for Unassociated objects](configure-storage-policy.md#list-storage-policies-for-unassociated-objects)
198+
199+
The output of this command includes the **UUID** of each unassociated vSAN object, which is required for deletion.
200+
201+
202+
### Delete unassociated vSAN objects
203+
204+
After reviewing the list of unassociated objects, delete them **individually** by specifying their UUID and ClusterName.
205+
206+
> [!IMPORTANT]
207+
> Deleting a vSAN object is irreversible. Ensure that the object is not associated with any VM, management component, or system service before proceeding.
208+
209+
### Run Command parameters: `Remove-AvsUnassociatedObject`
210+
211+
| Field | Description |
212+
|------|-------------|
213+
| **UUID** | UUID of the unassociated vSAN object to delete. Obtain this value from the output of `Get‑UnassociatedVsanObjectsWithPolicy`. |
214+
| **ClusterName** | Name of the vSAN cluster that contains the unassociated object. |
215+
| **Retain up to** | Retention period for the Run Command output. |
216+
| **Specify name for execution** | Alphanumeric name used to identify this Run Command execution. |
217+
| **Timeout** | Time after which the command exits if it does not complete. |
218+
219+
1. Navigate to your AVS private cloud in the Azure portal.
220+
2. Select **Run command** > **Packages** > **Microsoft.AVS.Management**.
221+
3. Select **Remove-AvsUnassociatedObject**.
222+
223+
:::image type="content" source="media/run-command/run-command-overview-remove-unassociated-object.png" alt-text="Screenshot showing the Remove-AvsUnassociatedObject Run Command in the Azure portal." lightbox="media/run-command/run-command-overview-remove-unassociated-object.png":::
224+
225+
4. Provide the **UUID** and **ClusterName** of the unassociated object you want to remove.
226+
227+
:::image type="content" source="media/run-command/run-command-remove-unassociated-object.png" alt-text="Screenshot of the Remove-AvsUnassociatedObject Run Command execution." lightbox="media/run-command/run-command-remove-unassociated-object.png":::
228+
229+
5. Select **Run** and monitor execution progress.
230+
231+
Once the command completes successfully, the specified vSAN object is permanently removed from the cluster.
232+
233+
### Best practices and safety guidance
234+
235+
- Always **list objects first** and review them carefully before deletion.
236+
- Delete objects **one at a time** to minimize risk.
237+
- Avoid deleting objects with names or attributes associated with:
238+
- Management VMs
239+
- vCenter
240+
- NSX
241+
- HCX
242+
- SRM
243+
- Backup or replication components
244+
- If you are unsure about an object, do not delete it and investigate further.
245+
246+
### Next steps
247+
248+
- Review storage policy assignments to prevent future unassociated objects.
249+
- Monitor vSAN health checks regularly.
250+
- Use Run Command outputs and retention settings to maintain auditability.
251+
174252
## Specify a storage policy for a cluster
175253

176254
Run the `Set-ClusterDefaultStoragePolicy` cmdlet to specify a default storage policy for a cluster.
136 KB
Loading
115 KB
Loading

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

Lines changed: 3 additions & 1 deletion
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: 09/26/2025
5+
ms.date: 02/17/2026
66
ms.service: azure-backup
77
ms.custom:
88
- engagement-fy23
@@ -18,6 +18,8 @@ Azure Files backup is a native cloud solution that protects your data and elimin
1818

1919
Azure Backup now offers general availability of Vaulted Backup for Azure Files, enabling secure, long-term protection with ransomware defense, cross-region recovery, and compliance-ready retention—all managed through a unified backup policy. For more insights, see the [Microsoft Community Hub blog](https://techcommunity.microsoft.com/blog/azurestorageblog/general-availability-vaulted-backup-for-azure-files---boost-your-data-security-a/4395344). To know the latest product enhancements and feature updates in Azure, see [Microsoft Azure Updates](https://azure.microsoft.com/updates?id=482659).
2020

21+
To learn about the supported Azure Files backup and restore scenarios, region availability, and limitations, see the [support matrix](azure-file-share-support-matrix.md). For common questions, see the [frequently asked questions](backup-azure-files-faq.yml).
22+
2123
## Key benefits of Azure Files backup
2224

2325
Protection of Azure Files provides the following benefits by using *Snapshot* and *Vaulted* backup tiers:

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

Lines changed: 2 additions & 2 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: 09/26/2025
5+
ms.date: 02/17/2026
66
ms.custom: references_regions, engagement-fy24
77
ms.service: azure-backup
88
author: AbhishekMallick-MS
@@ -14,7 +14,7 @@ ms.author: v-mallicka
1414

1515
This article summarizes the supported settings and limitations when backing up Azure Files by using Azure Backup.
1616

17-
You can use the [Azure Backup service](./backup-overview.md) to back up Azure Files. This article summarizes support settings when you back up Azure Files with Azure Backup.
17+
You can use the [Azure Backup service](./backup-overview.md) to back up Azure Files. This article summarizes support settings when you back up Azure Files with Azure Backup. For common questions, see the [frequently asked questions](backup-azure-files-faq.yml).
1818

1919
Azure Backup now offers general availability of Vaulted Backup for Azure Files (Standard tier), enabling secure, long-term protection with ransomware defense, cross-region recovery, and compliance-ready retention—all managed through a unified backup policy. For more insights, see the [Microsoft Community Hub blog](https://techcommunity.microsoft.com/blog/azurestorageblog/general-availability-vaulted-backup-for-azure-files---boost-your-data-security-a/4395344). To know the latest product enhancements and feature updates in Azure, see [Microsoft Azure Updates](https://azure.microsoft.com/updates?id=482659).
2020

articles/backup/backup-afs-cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Back up Azure Files with Azure CLI
33
description: Learn how to use Azure CLI to back up Azure Files in the Recovery Services vault
44
ms.topic: how-to
55
ms.custom: devx-track-azurecli, engagement-fy24
6-
ms.date: 05/22/2025
6+
ms.date: 02/17/2026
77
author: AbhishekMallick-MS
88
ms.author: v-mallicka
99
# Customer intent: As an IT administrator, I want to back up Azure Files using Azure CLI, so that I can automate the backup process and ensure data protection effectively.

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

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Back up Azure files using PowerShell
33
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: 05/22/2025
5+
ms.date: 02/17/2026
66
ms.custom: devx-track-azurepowershell
77
ms.service: azure-backup
88
author: AbhishekMallick-MS
@@ -12,7 +12,8 @@ ms.author: v-mallicka
1212

1313
# Back up Azure Files using Azure PowerShell
1414

15-
This article describes how to use Azure PowerShell to back up Azure Files through an [Azure Backup](backup-overview.md) Recovery Services vault.
15+
This article describes how to use Azure PowerShell to back up Azure Files through an [Azure Backup](backup-overview.md) Recovery Services vault. You can also back up Azure Files using [Azure portal](backup-azure-files.md), [CLI](backup-afs-cli.md), and [REST API](backup-azure-file-share-rest-api.md).
16+
1617

1718
## Prerequisites
1819

articles/backup/backup-azure-file-share-rest-api.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
title: Back up Azure Files with REST API
33
description: Learn how to use REST API to back up Azure Files in the Recovery Services vault
44
ms.topic: how-to
5-
ms.date: 05/22/2025
5+
ms.date: 02/17/2026
66
author: AbhishekMallick-MS
77
ms.author: v-mallicka
88
# Customer intent: As a cloud administrator, I want to use the REST API to backup Azure Files stored in a Recovery Services vault, so that I can automate the protection and management of file shares without relying solely on graphical interfaces.
99
---
1010

1111
# Backup Azure Files using Azure Backup via REST API
1212

13-
This article describes how to back up an Azure Files using Azure Backup via REST API.
13+
This article describes how to back up an Azure Files using Azure Backup via REST API. You can also back up Azure Files using [Azure portal](backup-azure-files.md), [CLI](backup-afs-cli.md), and [Azure PowerShell](backup-azure-afs-automation.md).
1414

1515
This article assumes you've already created a Recovery Services vault and policy for configuring backup for your File Share. If you haven’t, refer to the [create vault](./backup-azure-arm-userestapi-createorupdatevault.md) and [create policy](./backup-azure-arm-userestapi-createorupdatepolicy.md) REST API tutorials for creating new vaults and policies.
1616

@@ -26,6 +26,9 @@ For this article, we'll use the following resources:
2626

2727
- **File Share**: `testshare`
2828

29+
To learn about the supported Azure Files backup and restore scenarios, region availability, and limitations, see the [support matrix](azure-file-share-support-matrix.md). For common questions, see the [frequently asked questions](backup-azure-files-faq.yml).
30+
31+
2932
## Configure backup for an unprotected Azure Files using REST API
3033

3134
### Discover storage accounts with unprotected Azure Files

articles/backup/backup-azure-files-faq.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22
metadata:
33
title: Back up Azure Files FAQ
44
description: In this article, discover answers to common questions about how to protect your Azure file shares with the Azure Backup service.
5-
ms.date: 06/11/2025
5+
ms.date: 02/17/2026
66
ms.topic: faq
77
ms.service: azure-backup
88
author: AbhishekMallick-MS
99
ms.author: v-mallicka
1010
title: Frequently asked questions about backing up Azure Files
1111
summary: |
12-
This article answers common questions about backing up Azure Files. In some of the answers, there are links to the articles that have comprehensive information. You can also post questions about the Azure Backup service in the [Microsoft Q&A question page for discussion](/answers/topics/azure-backup.html).
12+
This article answers common questions about backing up Azure Files. In some of the answers, there are links to the articles that have comprehensive information. You can also post questions about the Azure Backup service in the [Microsoft Q&A question page for discussion](/answers/topics/azure-backup.html). To learn about the supported Azure Files backup and restore scenarios, region availability, and limitations, see the [support matrix](azure-file-share-support-matrix.md).
1313
1414
To quickly scan the sections in this article, use the links to the right, under **In this article**.
1515

articles/backup/backup-azure-files.md

Lines changed: 3 additions & 2 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: 07/09/2025
5+
ms.date: 02/17/2026
66
ms.service: azure-backup
77
ms.custom: engagement-fy23
88
author: AbhishekMallick-MS
@@ -12,7 +12,7 @@ ms.author: v-mallicka
1212

1313
# Back up Azure Files
1414

15-
This article describes how to back up [Azure Files](../storage/files/storage-files-introduction.md) from the Azure portal.
15+
This article describes how to back up [Azure Files](../storage/files/storage-files-introduction.md) from the Azure portal. You can also back up Azure Files using [CLI](backup-afs-cli.md), [Azure PowerShell](backup-azure-afs-automation.md), and [REST API](backup-azure-file-share-rest-api.md).
1616

1717
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.
1818

@@ -34,6 +34,7 @@ Azure Files backup is a native cloud solution that protects your data and elimin
3434
>[!IMPORTANT]
3535
>To perform [Cross Subscription Backup (CSB) for protecting Azure Files](azure-file-share-backup-overview.md#how-cross-subscription-backup-for-azure-files-works) in another subscription, ensure you register `Microsoft.RecoveryServices` in the **subscription of the file share** in addition to the given prerequisites.
3636
37+
To learn about the supported Azure Files backup and restore scenarios, region availability, and limitations, see the [support matrix](azure-file-share-support-matrix.md). For common questions, see the [frequently asked questions](backup-azure-files-faq.yml).
3738

3839
## Configure the backup
3940

0 commit comments

Comments
 (0)