From a7ad7d76945b34a7911294eb28807e14fc4b1a09 Mon Sep 17 00:00:00 2001
From: Qi Pan <43341456+Pan-Qi@users.noreply.github.com>
Date: Thu, 2 Oct 2025 01:30:57 +1000
Subject: [PATCH] Update breaking change doc (#3728)

---
 .../breaking-changes-generated-modules.md     | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/docs-conceptual/azps-14.4.0/breaking-changes-generated-modules.md b/docs-conceptual/azps-14.4.0/breaking-changes-generated-modules.md
index 65fc0c6ee5..2e5fefd65a 100644
--- a/docs-conceptual/azps-14.4.0/breaking-changes-generated-modules.md
+++ b/docs-conceptual/azps-14.4.0/breaking-changes-generated-modules.md
@@ -22,6 +22,40 @@ upgrading the code generation tool for Azure PowerShell modules.
 > breaking changes may occur, please refer to the
 > [breaking change list](/powershell/azure/upcoming-breaking-changes) for the specific module.
 
+## Identity Parameter Updates
+
+Removed -IdentityType parameter and introduced clearer switches and parameters:
+
+ - -EnableSystemAssignedIdentity
+
+    Default value: false.
+    Must be explicitly added if a SystemAssigned Identity is required.
+
+ - -UserAssignedIdentity
+
+    Type: array of id strings
+    Accepts one or more User Assigned Managed Identities.
+
+### How to mitigate the impact of breaking changes
+
+- Replace old -IdentityType values with explicit parameters:
+
+    - SystemAssigned → -EnableSystemAssignedIdentity
+    - UserAssigned → -UserAssignedIdentity, specifying the desired identity IDs
+    - SystemAssigned,UserAssigned → use both -EnableSystemAssignedIdentity and -UserAssignedIdentity
+
+- Replace any previously used parameters for User Assigned identities (such as -IdentityUserAssigned or other variations, regardless of type) with -UserAssignedIdentity, which accepts an array of strings.
+
+All original functionality remains, but scripts must be updated to use the new explicit parameters. Refer to the cmdlet documentation for exact syntax and usage.
+
+## Removal of parameter sets
+
+Certain complex or cumbersome parameter sets have been removed from the cmdlet. All existing functionality remains available, but users must now use the supported parameter combinations as documented.
+
+### How to mitigate the impact of breaking changes
+
+Users should refer to the latest cmdlet documentation to ensure they are using supported parameter set combinations.
+
 ## List replaces array in generated C# classes
 
 We now generate collection-like properties as