[Az.Databricks] Update generation tool version: autorest.powershell v3->v4 #28554

lijinpei2008 · 2025-09-12T09:41:51Z

Description

Preannouncement PR:

[Az.Databricks] The code base is going to be refactored, the following cmdlet adds a BreakingChange announcement #28560
[BC] Databricks Module Breaking Changes Announcement Date Update #29149

Mandatory Checklist

Please choose the target release of Azure PowerShell. (⚠️Target release is a different concept from API readiness. Please click below links for details.)
- General release
- Public preview
- Private preview
- Engineering build
- No need for a release
Check this box to confirm: I have read the Submitting Changes section of CONTRIBUTING.md and reviewed the following information:

SHOULD update ChangeLog.md file(s) appropriately
- Update src/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.
  - A snippet outlining the change(s) made in the PR should be written under the ## Upcoming Release header in the past tense.
- Should not change ChangeLog.md if no new release is required, such as fixing test case only.
SHOULD regenerate markdown help files if there is cmdlet API change. Instruction
SHOULD have proper test coverage for changes in pull request.
SHOULD NOT adjust version of module manually in pull request

azure-client-tools-bot-prd · 2025-09-12T09:41:54Z

Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status.

github-actions · 2025-09-12T09:42:21Z

To the author of the pull request,
This PR was labeled "Breaking Change Release" because it contains breaking changes.

According to our policy, breaking changes can only take place during major release and they must be preannounced.
Please follow our guide on the detailed steps.
Required: Please fill in the task below to facilitate our contact,you will receive notifications related to breaking changes.

Copilot

Pull Request Overview

This PR updates the Azure Databricks PowerShell module by upgrading the AutoRest PowerShell generation tool from version 3 to version 4. The update modernizes the code generation process and aligns with newer AutoRest standards while maintaining backward compatibility.

Key changes include:

Upgrade from AutoRest PowerShell v3 to v4 for code generation
Extensive parameter type updates from enum types to string types across cmdlets
Breaking change exception configurations for maintaining API compatibility
Test configuration updates and example corrections

Reviewed Changes

Copilot reviewed 45 out of 48 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
tools/StaticAnalysis/Exceptions/Az.Databricks/BreakingChangeIssues.csv	Adds comprehensive breaking change exceptions to maintain API compatibility during the tool upgrade
src/Databricks/Databricks/help/*.md	Updates help documentation with corrected parameter types and improved descriptions
src/Databricks/Databricks.Autorest/test/*.ps1	Updates test cases to use new parameter syntax (switch parameters instead of boolean values)
src/Databricks/Databricks.Autorest/custom/*.ps1	Refactors custom cmdlet implementations to use string types and new parameter sets
src/Databricks/Databricks.Autorest/README.md	Updates AutoRest configuration to remove v3-specific settings and directives

Comments suppressed due to low confidence (6)

… jinpei/main/Databricks-v4

VeryEarly · 2025-11-10T03:24:03Z

src/Databricks/Databricks.Autorest/custom/Update-AzDatabricksVNetPeering.ps1

        [Microsoft.Azure.PowerShell.Cmdlets.Databricks.Category('Body')]
-        [System.Boolean]
-        # [System.Management.Automation.SwitchParameter]
+        [System.Management.Automation.SwitchParameter]


why change the type from boolean to switch?

Hi @VeryEarly, this change in parameter type is due to the internals of Update-AzDatabricksVNetPeering. The AllowVirtualNetworkAccess parameter is defined as a SwitchParameter internally, so we're following the internal parameter type definition.

JunKai-v · 2026-02-06T04:11:18Z

/azp run

azure-pipelines · 2026-02-06T04:11:34Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 47 out of 50 changed files in this pull request and generated 6 comments.

Copilot · 2026-02-06T04:20:47Z

src/Databricks/Databricks/help/Update-AzDatabricksWorkspace.md


 ### -AutomaticClusterUpdate
-Status of automated cluster updates feature.
+.


The parameter description for AutomaticClusterUpdate is over-simplified (just a period: "."). This should be replaced with a meaningful description explaining what the parameter does, such as "Status of automated cluster updates feature" or similar descriptive text that helps users understand the parameter's purpose.

Copilot · 2026-02-06T04:20:47Z

src/Databricks/Databricks/help/Update-AzDatabricksWorkspace.md


 ### -EnhancedSecurityCompliance
-Status of Compliance Security Profile feature.
+.


The parameter description for EnhancedSecurityCompliance is over-simplified (just a period: "."). This should be replaced with a meaningful description such as "Status of Compliance Security Profile feature" or similar descriptive text that helps users understand the parameter's purpose.

Copilot · 2026-02-06T04:20:47Z

src/Databricks/Databricks/help/Update-AzDatabricksWorkspace.md


 ### -EnhancedSecurityMonitoring
-Status of Enhanced Security Monitoring feature.
+.


The parameter description for EnhancedSecurityMonitoring is over-simplified (just a period: "."). This should be replaced with a meaningful description such as "Status of Enhanced Security Monitoring feature" or similar descriptive text that helps users understand the parameter's purpose.

Copilot · 2026-02-06T04:20:47Z

src/Databricks/Databricks/help/New-AzDatabricksWorkspace.md


 ### -AutomaticClusterUpdate
-Status of automated cluster updates feature.
+.


The parameter description for AutomaticClusterUpdate is over-simplified (just a period: "."). This should be replaced with a meaningful description such as "Status of automated cluster updates feature" or similar descriptive text that helps users understand the parameter's purpose.

Copilot · 2026-02-06T04:20:48Z

src/Databricks/Databricks/help/New-AzDatabricksWorkspace.md


 ### -EnhancedSecurityCompliance
-Status of Compliance Security Profile feature.
+.


The parameter description for EnhancedSecurityCompliance is over-simplified (just a period: "."). This should be replaced with a meaningful description such as "Status of Compliance Security Profile feature" or similar descriptive text that helps users understand the parameter's purpose.

Copilot · 2026-02-06T04:20:48Z

src/Databricks/Databricks/help/New-AzDatabricksWorkspace.md


 ### -EnhancedSecurityMonitoring
-Status of Enhanced Security Monitoring feature.
+.


The parameter description for EnhancedSecurityMonitoring is over-simplified (just a period: "."). This should be replaced with a meaningful description such as "Status of Enhanced Security Monitoring feature" or similar descriptive text that helps users understand the parameter's purpose.

Az.Databricks update generation tool version: autorest.powershell v3->v4

eb57d00

lijinpei2008 added the Contains Breaking Change This PR contains breaking change label Sep 12, 2025

update

6a5b2e9

lijinpei2008 mentioned this pull request Sep 15, 2025

[Az.Databricks] The code base is going to be refactored, the following cmdlet adds a BreakingChange announcement #28560

Merged

6 tasks

lijinpei2008 and others added 2 commits September 15, 2025 16:41

update examples and create BreakingChangeIssues.csv

838993b

Merge branch 'main' into jinpei/main/Databricks-v4

0bd99b3

github-actions bot mentioned this pull request Oct 1, 2025

Monthly issue metrics report #28630

Closed

lijinpei2008 and others added 2 commits October 15, 2025 18:05

recode unit test

beb061d

Merge branch 'main' into jinpei/main/Databricks-v4

a4936fa

lijinpei2008 marked this pull request as ready for review October 15, 2025 10:07

Copilot AI review requested due to automatic review settings October 15, 2025 10:07

Copilot AI reviewed Oct 15, 2025

View reviewed changes

update changelog

099e294

isra-fel added the autorest v4 migration pr migrating module from generated by autorest.powershell v3 to v4 label Oct 20, 2025

lijinpei2008 added 3 commits October 30, 2025 10:20

Merge branch 'main' of https://github.com/Azure/azure-powershell into…

c224507

… jinpei/main/Databricks-v4

re-generation

e57b7f2

update changelog

0b28278

VeryEarly reviewed Nov 10, 2025

View reviewed changes

isra-fel assigned Pan-Qi Jan 28, 2026

isra-fel added this to the Az 16.0.0 (TBD) milestone Jan 28, 2026

rebuild with Autorest 4.0.752

ef55ae6

Copilot AI review requested due to automatic review settings February 6, 2026 04:10

Copilot started reviewing on behalf of JunKai-v February 6, 2026 04:13 View session

Copilot AI reviewed Feb 6, 2026

View reviewed changes

[Az.Databricks] Update generation tool version: autorest.powershell v3->v4 #28554

Are you sure you want to change the base?

[Az.Databricks] Update generation tool version: autorest.powershell v3->v4 #28554

Uh oh!

Conversation

lijinpei2008 commented Sep 12, 2025 • edited by JunKai-v Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Mandatory Checklist

Uh oh!

azure-client-tools-bot-prd bot commented Sep 12, 2025

Uh oh!

github-actions bot commented Sep 12, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

VeryEarly Nov 10, 2025

Choose a reason for hiding this comment

Uh oh!

JunKai-v Feb 5, 2026

Choose a reason for hiding this comment

Uh oh!

JunKai-v commented Feb 6, 2026

Uh oh!

azure-pipelines bot commented Feb 6, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 6, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

lijinpei2008 commented Sep 12, 2025 •

edited by JunKai-v

Loading