Azure · Celinadhh · May 14, 2026 · May 15, 2026 · May 15, 2026 · May 15, 2026
diff --git a/Commands/policy/assignment/_create.md b/Commands/policy/assignment/_create.md
@@ -6,9 +6,9 @@ Create a policy assignment with the given scope and name. Policy assignments app
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 -->
 
 #### examples
 
@@ -19,7 +19,7 @@ Create a policy assignment with the given scope and name. Policy assignments app
 
 - Create a resource policy assignment and provide rule parameter values
     ```bash
-        Create a resource policy assignment and provide rule parameter values policy assignment create --policy {policyName} -p "{ 'allowedLocations': { 'value': [ 'australiaeast', 'eastus', 'japaneast' ] } }"
+        policy assignment create --policy {policyName} -p "{ 'allowedLocations': { 'value': [ 'australiaeast', 'eastus', 'japaneast' ] } }"
     ```
 
 - Create a resource policy assignment with a system assigned identity

diff --git a/Commands/policy/assignment/_delete.md b/Commands/policy/assignment/_delete.md
@@ -6,9 +6,9 @@ Delete the policy assignment with the given name and scope.
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/_list.md b/Commands/policy/assignment/_list.md
@@ -6,11 +6,11 @@ Retrieve the list of all policy assignments applicable to the given subscription
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lhc3NpZ25tZW50cw==/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lhc3NpZ25tZW50cw==/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policyassignments 2024-05-01 -->
-<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policyassignments 2024-05-01 -->
-<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.authorization/policyassignments 2024-05-01 -->
+<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policyassignments 2025-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policyassignments 2025-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/resourcegroups/{}/providers/microsoft.authorization/policyassignments 2025-11-01 -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/_show.md b/Commands/policy/assignment/_show.md
@@ -6,9 +6,9 @@ Retrieve and show the details of a single policy assignment with the given name
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/_update.md b/Commands/policy/assignment/_update.md
@@ -6,9 +6,9 @@ Update the policy assignment with the given name and scope by applying the given
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/identity/_assign.md b/Commands/policy/assignment/identity/_assign.md
@@ -6,9 +6,9 @@ Assign the system or user assigned managed identity to the policy assignment mat
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 identity -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 identity -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/identity/_remove.md b/Commands/policy/assignment/identity/_remove.md
@@ -6,9 +6,9 @@ Remove the system or user assigned managed identity from the policy assignment m
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 identity -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 identity -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/identity/_show.md b/Commands/policy/assignment/identity/_show.md
@@ -6,9 +6,9 @@ Retrieve and show the details of the system or user assigned managed identity of
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 identity -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 identity -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/identity/readme.md b/Commands/policy/assignment/identity/readme.md
@@ -1,6 +1,6 @@
 # [Group] _policy assignment identity_
 
-Managed identity of the policy assignment.
+Manage identity of the policy assignment.
 
 The system or user assigned managed identity used by the enclosing policy assignment for remediation tasks.
 

diff --git a/Commands/policy/assignment/non-compliance-message/_create.md b/Commands/policy/assignment/non-compliance-message/_create.md
@@ -6,9 +6,9 @@ Create a customized message used to report non-compliance by the policy assignme
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 properties.nonComplianceMessages[] -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 properties.nonComplianceMessages[] -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/non-compliance-message/_delete.md b/Commands/policy/assignment/non-compliance-message/_delete.md
@@ -6,9 +6,9 @@ Delete a non-compliance message from the policy assignment matching the given na
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 properties.nonComplianceMessages[] -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 properties.nonComplianceMessages[] -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/non-compliance-message/_list.md b/Commands/policy/assignment/non-compliance-message/_list.md
@@ -6,9 +6,9 @@ Retrieve all non-compliance messages from the policy assignment matching the giv
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 properties.nonComplianceMessages -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 properties.nonComplianceMessages -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/non-compliance-message/_show.md b/Commands/policy/assignment/non-compliance-message/_show.md
@@ -6,9 +6,9 @@ Retrieve and show the details of a non-compliance message belonging to the polic
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 properties.nonComplianceMessages[] -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 properties.nonComplianceMessages[] -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/non-compliance-message/_update.md b/Commands/policy/assignment/non-compliance-message/_update.md
@@ -6,9 +6,9 @@ Update a non-compliance message belonging to the policy assignment matching the
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3tzY29wZX0vcHJvdmlkZXJzL21pY3Jvc29mdC5hdXRob3JpemF0aW9uL3BvbGljeWFzc2lnbm1lbnRzL3t9/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2024-05-01 properties.nonComplianceMessages[] -->
+<!-- mgmt-plane /{scope}/providers/microsoft.authorization/policyassignments/{} 2025-11-01 properties.nonComplianceMessages[] -->
 
 #### examples
 

diff --git a/Commands/policy/assignment/non-compliance-message/readme.md b/Commands/policy/assignment/non-compliance-message/readme.md
@@ -1,6 +1,6 @@
 # [Group] _policy assignment non-compliance-message_
 
-Non-compliance message used by the policy assignment.
+Manage non-compliance message used by the policy assignment.
 
 Customized message used by the enclosing policy assignment to report non-compliance.
 

diff --git a/Commands/policy/assignment/readme.md b/Commands/policy/assignment/readme.md
@@ -7,10 +7,10 @@ Policy assignments are used to apply a policy definition or policy set definitio
 ## Subgroups
 
 - [identity](/Commands/policy/assignment/identity/readme.md)
-: Managed identity of the policy assignment.
+: Manage identity of the policy assignment.
 
 - [non-compliance-message](/Commands/policy/assignment/non-compliance-message/readme.md)
-: Non-compliance message used by the policy assignment.
+: Manage non-compliance message used by the policy assignment.
 
 ## Commands
 

diff --git a/Commands/policy/definition/_create.md b/Commands/policy/definition/_create.md
@@ -6,10 +6,10 @@ Create a policy definition in the given subscription or management group with th
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fQ==/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fQ==/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{} 2024-05-01 -->
-<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{} 2024-05-01 -->
+<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{} 2025-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{} 2025-11-01 -->
 
 #### examples
 
@@ -32,3 +32,13 @@ Create a policy definition in the given subscription or management group with th
     ```bash
         policy definition create --name TagsPolicyDefinition --subscription "MySubscription" --mode Indexed --rules "{ 'if': { 'field': 'tags', 'exists': 'false' }, 'then': { 'effect': 'deny' } }"
     ```
+
+- Create a read-only storage policy with newer version
+    ```bash
+        policy definition create --name readOnlyStorage --rules "{ 'if': { 'field': 'type', 'equals': 'Microsoft.Storage/storageAccounts/write' }, 'then': { 'effect': 'deny' } }" --version 2.0.0
+    ```
+
+- Create a policy definition with external evaluation enforcement settings
+    ```bash
+        policy definition create --name externalPolicy --rules "{ 'if': { 'value': '[claims().isValid]', 'equals': 'true' }, 'then': { 'effect': 'deny' } }" --external-settings "{ 'roleDefinitionIds': [ '/providers/Microsoft.Authorization/roleDefinitions/b24988ac-6180-42a0-ab88-20f7382dd24c' ], 'endpointSettings': { 'kind': 'CoinFlip' } }"
+    ```
diff --git a/Commands/policy/definition/_delete.md b/Commands/policy/definition/_delete.md
@@ -6,10 +6,10 @@ Delete the policy definition in the given subscription or management group with
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fQ==/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fQ==/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{} 2024-05-01 -->
-<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{} 2024-05-01 -->
+<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{} 2025-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{} 2025-11-01 -->
 
 #### examples
 

diff --git a/Commands/policy/definition/_list.md b/Commands/policy/definition/_list.md
@@ -1,16 +1,16 @@
 # [Command] _policy definition list_
 
-Retrieve policy definitions.
+Retrieves policy definition.
 
 Retrieve the list of all policy definitions in the given subscription or management group.
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucw==/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucw==/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /providers/microsoft.authorization/policydefinitions 2024-05-01 -->
-<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions 2024-05-01 -->
-<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions 2024-05-01 -->
+<!-- mgmt-plane /providers/microsoft.authorization/policydefinitions 2025-11-01 -->
+<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions 2025-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions 2025-11-01 -->
 
 #### examples
 

diff --git a/Commands/policy/definition/_show.md b/Commands/policy/definition/_show.md
@@ -6,10 +6,10 @@ Retrieve and show the details of the policy definition in the given subscription
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fQ==/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fQ==/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{} 2024-05-01 -->
-<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{} 2024-05-01 -->
+<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{} 2025-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{} 2025-11-01 -->
 
 #### examples
 

diff --git a/Commands/policy/definition/_update.md b/Commands/policy/definition/_update.md
@@ -6,10 +6,10 @@ Update the policy definition in the given subscription or management group with
 
 ## Versions
 
-### [2024-05-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fQ==/2024-05-01.xml) **Stable**
+### [2025-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fQ==/2025-11-01.xml) **Stable**
 
-<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{} 2024-05-01 -->
-<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{} 2024-05-01 -->
+<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{} 2025-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{} 2025-11-01 -->
 
 #### examples
 

diff --git a/Commands/policy/definition/readme.md b/Commands/policy/definition/readme.md
@@ -4,6 +4,11 @@ Manage policy definitions.
 
 Policy definitions are rules that specify allowed or disallowed Azure resource configurations.
 
+## Subgroups
+
+- [version](/Commands/policy/definition/version/readme.md)
+: Manage policy definition versions.
+
 ## Commands
 
 - [create](/Commands/policy/definition/_create.md)
@@ -13,7 +18,7 @@ Policy definitions are rules that specify allowed or disallowed Azure resource c
 : Delete a policy definition.
 
 - [list](/Commands/policy/definition/_list.md)
-: Retrieve policy definitions.
+: Retrieves policy definition.
 
 - [show](/Commands/policy/definition/_show.md)
 : Retrieves a policy definition.

diff --git a/Commands/policy/definition/version/_create.md b/Commands/policy/definition/version/_create.md
@@ -0,0 +1,19 @@
+# [Command] _policy definition version create_
+
+Create a policy definition version.
+
+Create a policy definition version in the given subscription or management group with the given name and other properties.
+
+## Versions
+
+### [2025-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fS92ZXJzaW9ucy97fQ==/2025-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{}/versions/{} 2025-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{}/versions/{} 2025-11-01 -->
+
+#### examples
+
+- Create a policy definition with older version
+    ```bash
+        policy definition version create --name readOnlyStorage --rules "{ 'if': { 'field': 'type', 'equals': 'Microsoft.Storage/storageAccounts/write' }, 'then': { 'effect': 'deny' } }" --version 1.1.0
+    ```
diff --git a/Commands/policy/definition/version/_delete.md b/Commands/policy/definition/version/_delete.md
@@ -0,0 +1,19 @@
+# [Command] _policy definition version delete_
+
+Delete a policy definition version.
+
+Delete the policy definition version in the given subscription or management group with the given name and other properties.
+
+## Versions
+
+### [2025-11-01](/Resources/mgmt-plane/L3Byb3ZpZGVycy9taWNyb3NvZnQubWFuYWdlbWVudC9tYW5hZ2VtZW50Z3JvdXBzL3t9L3Byb3ZpZGVycy9taWNyb3NvZnQuYXV0aG9yaXphdGlvbi9wb2xpY3lkZWZpbml0aW9ucy97fS92ZXJzaW9ucy97fQ==/2025-11-01.xml) **Stable**
+
+<!-- mgmt-plane /providers/microsoft.management/managementgroups/{}/providers/microsoft.authorization/policydefinitions/{}/versions/{} 2025-11-01 -->
+<!-- mgmt-plane /subscriptions/{}/providers/microsoft.authorization/policydefinitions/{}/versions/{} 2025-11-01 -->
+
+#### examples
+
+- Delete a policy definition version
+    ```bash
+        policy definition version delete --name ResourceNaming --version 1.2.1
+    ```