Merge pull request #311893 from MicrosoftDocs/main

Auto Publish – main to live - 2026-02-17 18:00 UTC

Author: learn-build-service-prod[bot]

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

@@ -171,6 +171,84 @@ Run the `Update-StoragePolicyOfUnassociatedVsanObjects` cmdlet to modify curre
 
    3. Check **Notifications** to see the progress.
 
+## Delete unassociated vSAN objects using Run Command
+ 
+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.
+ 
+This article explains how to **list** and **delete** unassociated vSAN objects in **Azure VMware Solution (AVS)** using **Run Command**.
+ 
+### Prerequisites
+ 
+Before listing or deleting unassociated vSAN objects, ensure that:
+ 
+- You have access to the Azure portal with permissions equivalent to the **cloudadmin** role for the AVS private cloud.
+- The cluster meets the minimum host requirements for its vSAN configuration (OSA or ESA).
+- You are using the latest supported version of the **Microsoft.AVS.Management** Run Command package.
+- You have validated that the objects to be deleted are **not required** by any workload, management VM, or system component.
+ 
+### List unassociated vSAN objects
+ 
+Before deleting any objects, list and review them to confirm that they are truly unassociated.
+ 
+Use the **Get‑UnassociatedVsanObjectsWithPolicy** Run Command to list unassociated vSAN objects and obtain their UUIDs.
+ 
+For detailed steps, see:
+
+- [List storage policies for Unassociated objects](configure-storage-policy.md#list-storage-policies-for-unassociated-objects)
+ 
+The output of this command includes the **UUID** of each unassociated vSAN object, which is required for deletion.
+ 
+ 
+### Delete unassociated vSAN objects
+ 
+After reviewing the list of unassociated objects, delete them **individually** by specifying their UUID and ClusterName.
+ 
+> [!IMPORTANT]  
+> Deleting a vSAN object is irreversible. Ensure that the object is not associated with any VM, management component, or system service before proceeding.
+ 
+### Run Command parameters: `Remove-AvsUnassociatedObject`
+  
+| Field | Description |
+|------|-------------|
+| **UUID** | UUID of the unassociated vSAN object to delete. Obtain this value from the output of `Get‑UnassociatedVsanObjectsWithPolicy`. |
+| **ClusterName** | Name of the vSAN cluster that contains the unassociated object. |
+| **Retain up to** | Retention period for the Run Command output. |
+| **Specify name for execution** | Alphanumeric name used to identify this Run Command execution. |
+| **Timeout** | Time after which the command exits if it does not complete. |
+
+1. Navigate to your AVS private cloud in the Azure portal.
+2. Select **Run command** > **Packages** > **Microsoft.AVS.Management**.
+3. Select **Remove-AvsUnassociatedObject**.
+
+  :::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":::
+ 
+4. Provide the **UUID** and **ClusterName** of the unassociated object you want to remove.
+
+ :::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":::
+ 
+5. Select **Run** and monitor execution progress.
+ 
+Once the command completes successfully, the specified vSAN object is permanently removed from the cluster.
+ 
+### Best practices and safety guidance
+ 
+- Always **list objects first** and review them carefully before deletion.
+- Delete objects **one at a time** to minimize risk.
+- Avoid deleting objects with names or attributes associated with:
+  - Management VMs
+  - vCenter
+  - NSX
+  - HCX
+  - SRM
+  - Backup or replication components
+- If you are unsure about an object, do not delete it and investigate further.
+ 
+### Next steps
+ 
+- Review storage policy assignments to prevent future unassociated objects.
+- Monitor vSAN health checks regularly.
+- Use Run Command outputs and retention settings to maintain auditability.
+
 ## Specify a storage policy for a cluster
 
 Run the `Set-ClusterDefaultStoragePolicy` cmdlet to specify a default storage policy for a cluster.

articles/azure-vmware/media/run-command/run-command-overview-remove-unassociated-object.png

@@ -4,6 +4,7 @@ description: Learn about the next steps after you migrate a single workload from
 ms.author: rhackenberg
 ai-usage: ai-assisted
 ms.date: 02/13/2026
+author: reginahack
 ms.topic: concept-article
 ms.custom: migration-hub
 ms.service: azure

articles/azure-vmware/media/run-command/run-command-remove-unassociated-object.png

@@ -2,6 +2,7 @@
 title: Decommission Your Amazon Web Services (AWS) Workload After You Migrate to Azure
 description: Learn how to decommission AWS resources after you migrate a single workload from AWS to Azure. Create final backups, delete resources, and establish new baselines.
 ms.author: rhackenberg
+author: reginahack
 ai-usage: ai-assisted
 ms.date: 02/13/2026
 ms.topic: concept-article

articles/migration/migrate-workload-from-aws-conclusion.md

@@ -2,6 +2,7 @@
 title: Evaluate your Workload from Amazon Web Services (AWS) After You Migrate to Azure
 description: Learn how to evaluate the migration of a single workload from AWS to Azure. Monitor performance, verify baselines, and confirm data cutover.
 ms.author: rhackenberg
+author: reginahack
 ai-usage: ai-assisted
 ms.date: 02/13/2026
 ms.topic: concept-article

articles/migration/migrate-workload-from-aws-decommission.md

@@ -2,6 +2,7 @@
 title: Execute Your Migration from Amazon Web Services (AWS) to Azure
 description: Learn how to execute the migration from AWS to Azure. Follow proven cutover strategies, sync data, validate workloads, and ensure rollback readiness.
 ms.author: rhackenberg
+author: reginahack
 ai-usage: ai-assisted
 ms.date: 02/13/2026
 ms.topic: concept-article

articles/migration/migrate-workload-from-aws-evaluate.md

@@ -2,6 +2,7 @@
 title: Migrate a Workload from Amazon Web Services (AWS) to Azure
 description: Learn how to migrate a single workload from AWS to Azure. Plan, prepare, execute, evaluate, and decommission your previous workload with minimal risk.
 ms.author: rhackenberg
+author: reginahack
 ai-usage: ai-assisted
 ms.date: 02/13/2026
 ms.topic: concept-article

articles/migration/migrate-workload-from-aws-execute.md

@@ -2,6 +2,7 @@
 title: Plan Your Workload Migration from Amazon Web Services (AWS) to Azure
 description: Plan your AWS to Azure migration. Assess the workload, design the architecture, and use detailed runbooks to minimize risk and ensure success.
 ms.author: rhackenberg
+author: reginahack
 ai-usage: ai-assisted
 ms.date: 02/13/2026
 ms.topic: concept-article

articles/migration/migrate-workload-from-aws-introduction.md

@@ -2,6 +2,7 @@
 title: Prepare Your Workload Migration from Amazon Web Services (AWS) to Azure
 description: Learn how to prepare a single workload for migration from AWS to Azure. Deploy infrastructure, refactor code, and test security for a smooth transition.
 ms.author: rhackenberg
+author: reginahack
 ai-usage: ai-assisted
 ms.date: 02/13/2026
 ms.topic: concept-article
@@ -13,7 +14,7 @@ ms.collection:
 ---
 # Prepare your workload migration from Amazon Web Services (AWS) to Azure
 
-This article is part of a series about how to [migrate a workload from Amazon Web Services (AWS) to Azure](/azure/migration/migrate-workload-from-aws-introduction). 
+This article is part of a series about how to [migrate a workload from Amazon Web Services (AWS) to Azure](/azure/migration/migrate-workload-from-aws-introduction).
 
 The preparation phase consists of these steps: