Removed EnableSoftDelete parameter from New-AzSqlServer and Set-AzSqlServer commands by rambabu-yalla · Pull Request #29576 · Azure/azure-powershell

rambabu-yalla · 2026-05-12T16:10:00Z

Description

This PR removes EnableSoftDelete parameter from New-AzSqlServer and Set-AzSqlServer commands as earlier announced.

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 · 2026-05-12T16:10:04Z

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

github-actions · 2026-05-12T16:15:22Z

To the author of the pull request,
This PR was labeled "Contains Breaking Change" because breaking changes have been detected by the static analysis pipeline.

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 removes the deprecated -EnableSoftDelete switch from the Az.Sql server cmdlets and consolidates soft-delete configuration on the -SoftDeleteRetentionDays parameter, updating help docs, resources, and tests accordingly.

Changes:

Removed -EnableSoftDelete from New-AzSqlServer and Set-AzSqlServer and deleted the associated validation/translation logic.
Updated cmdlet help markdown and module ChangeLog entry to reflect the API change.
Updated unit/scenario tests and session recordings to stop using -EnableSoftDelete.

Reviewed changes

Copilot reviewed 10 out of 17 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/Sql/Sql/Server/Cmdlet/SetAzureSqlServer.cs	Removes `EnableSoftDelete` parameter usage and adjusts soft-delete retention update behavior.
src/Sql/Sql/Server/Cmdlet/NewAzureSqlServer.cs	Removes `EnableSoftDelete` parameter and sends `SoftDeleteRetentionDays` directly.
src/Sql/Sql/Server/Cmdlet/AzureSqlServerCmdletBase.cs	Simplifies validation to only validate `SoftDeleteRetentionDays` range.
src/Sql/Sql/Properties/Resources.resx	Removes strings only used by the old `EnableSoftDelete` validation paths.
src/Sql/Sql/Properties/Resources.Designer.cs	Regenerates designer to match resource removals.
src/Sql/Sql/help/Set-AzSqlServer.md	Removes `-EnableSoftDelete` from syntax and parameter documentation.
src/Sql/Sql/help/New-AzSqlServer.md	Removes `-EnableSoftDelete` from syntax and parameter documentation.
src/Sql/Sql/ChangeLog.md	Adds an upcoming-release note describing the breaking change and replacement parameter.
src/Sql/Sql.Test/UnitTests/AzureSqlDatabaseServerAttributeTests.cs	Updates attribute tests to no longer expect `EnableSoftDelete`.
src/Sql/Sql.Test/SessionRecords/.../TestRestoreNonExistentDeletedServer.json	Updates recorded HTTP interactions after test changes/rerecording.
src/Sql/Sql.Test/ScenarioTests/ServerCrudTests.ps1	Updates scenarios to use `SoftDeleteRetentionDays` only and adjusts expectations.

Files not reviewed (1)

src/Sql/Sql/Properties/Resources.Designer.cs: Language not supported

+            // If the user supplied -SoftDeleteRetentionDays use it; otherwise fall back to the value returned by GET.
+            // The GET value may be -1 when soft-delete was never configured on the server, which the backend safely
+            // ignores in a PUT request (no-op), so existing server state is preserved.
+            updateData[0].SoftDeleteRetentionDays = this.SoftDeleteRetentionDays ?? updateData[0].SoftDeleteRetentionDays;


VeryEarly · 2026-05-12T16:38:46Z

/azp run

azure-pipelines · 2026-05-12T16:39:03Z

Azure Pipelines successfully started running 3 pipeline(s).

VeryEarly · 2026-05-13T09:38:52Z

/azp run

azure-pipelines · 2026-05-13T09:39:08Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 11 out of 18 changed files in this pull request and generated no new comments.

Files not reviewed (1)

src/Sql/Sql/Properties/Resources.Designer.cs: Language not supported

VeryEarly · 2026-05-14T09:38:50Z

/azp run

azure-pipelines · 2026-05-14T09:39:06Z

Azure Pipelines successfully started running 3 pipeline(s).

YanaXu · 2026-05-15T02:22:35Z

Hi @rambabu-yalla, please resolve the conflicts of the following files:

src/Sql/Sql/ChangeLog.md
src/Sql/Sql/Properties/Resources.Designer.cs

YanaXu · 2026-05-18T05:57:30Z

Hi @rambabu-yalla, FYI, the code complete date of Major Release is 05/26.

rambabu-yalla · 2026-05-18T06:23:32Z

Hi @rambabu-yalla, FYI, the code complete date of Major Release is 05/26.

Hi @YanaXu : I have just resolved merge conflicts. Could you please proceed with merge.?. thanks

YanaXu · 2026-05-18T07:02:40Z

/azp run azure-powershell - security-tools

azure-pipelines · 2026-05-18T07:02:50Z

Azure Pipelines successfully started running 1 pipeline(s).

YanaXu · 2026-05-19T02:07:24Z

 ## Version 6.5.0
 * Added support for User Assigned Managed Identity (UAMI) authentication in Data Sync cmdlets (`New-AzSqlSyncGroup`, `Update-AzSqlSyncGroup`, `New-AzSqlSyncMember`, `Update-AzSqlSyncMember`)
 * Removed legacy usage of 2014 APIs in Firewall Rule cmdlets
+* Removed the `EnableSoftDelete` parameter from `New-AzSqlServer` and `Set-AzSqlServer` cmdlets. Use the `SoftDeleteRetentionDays` parameter instead: setting `SoftDeleteRetentionDays` to 1-7 enables soft-delete, and setting it to 0 disables soft-delete.


Remove this line.

YanaXu · 2026-05-19T02:09:04Z

/azp run

azure-pipelines · 2026-05-19T02:09:19Z

Azure Pipelines successfully started running 3 pipeline(s).

YanaXu · 2026-05-19T06:08:49Z

/azp run azure-powershell - security-tools

azure-pipelines · 2026-05-19T06:08:59Z

Azure Pipelines successfully started running 1 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 11 out of 18 changed files in this pull request and generated 1 comment.

Files not reviewed (1)

src/Sql/Sql/Properties/Resources.Designer.cs: Language not supported

+"Az.Sql","Microsoft.Azure.Commands.Sql.Server.Cmdlet.NewAzureSqlServer","New-AzSqlServer","0","1050","The parameter set '__AllParameterSets' for cmdlet 'New-AzSqlServer' has been removed.","Add parameter set '__AllParameterSets' back to cmdlet 'New-AzSqlServer'."
+"Az.Sql","Microsoft.Azure.Commands.Sql.Server.Cmdlet.SetAzureSqlServer","Set-AzSqlServer","0","2000","The cmdlet 'Set-AzSqlServer' no longer supports the parameter 'EnableSoftDelete' and no alias was found for the original parameter name.","Add the parameter 'EnableSoftDelete' back to the cmdlet 'Set-AzSqlServer', or add an alias to the original parameter name."
+"Az.Sql","Microsoft.Azure.Commands.Sql.Server.Cmdlet.SetAzureSqlServer","Set-AzSqlServer","0","1050","The parameter set '__AllParameterSets' for cmdlet 'Set-AzSqlServer' has been removed.","Add parameter set '__AllParameterSets' back to cmdlet 'Set-AzSqlServer'."
+"Module","ClassName","Target","Severity","ProblemId","Description","Remediation"


VeryEarly · 2026-05-19T06:38:52Z

/azp run

azure-pipelines · 2026-05-19T06:39:16Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot AI review requested due to automatic review settings May 12, 2026 16:10

Copilot started reviewing on behalf of rambabu-yalla May 12, 2026 16:12 View session

rambabu-yalla added this to the Az 16.0.0 (06/02/2026) milestone May 12, 2026

rambabu-yalla added Contains Breaking Change This PR contains breaking change SQL SQL - Backup & Restore labels May 12, 2026

rambabu-yalla assigned pixia May 12, 2026

Copilot AI reviewed May 12, 2026

View reviewed changes

rambabu-yalla assigned YanaXu May 12, 2026

pixia approved these changes May 12, 2026

View reviewed changes

rambabu-yalla force-pushed the ramyal/RemoveEnableSoftDeleteParam branch from 3807e4e to c9841a2 Compare May 13, 2026 09:29

YanaXu suggested changes May 14, 2026

View reviewed changes

Comment thread src/Sql/Sql/ChangeLog.md Outdated

Copilot AI review requested due to automatic review settings May 14, 2026 09:21

Copilot started reviewing on behalf of rambabu-yalla May 14, 2026 09:24 View session

Copilot AI reviewed May 14, 2026

View reviewed changes

ram2ybabu added 2 commits May 18, 2026 11:22

Removed EnableSoftDelete parameter

d3ffb29

supress breaking exceptions

65ae31d

Updated ChangedLog

f6e1ea9

rambabu-yalla force-pushed the ramyal/RemoveEnableSoftDeleteParam branch from 224c696 to f6e1ea9 Compare May 18, 2026 06:20

YanaXu suggested changes May 19, 2026

View reviewed changes

Updated ChangedLog and added exception bypass

c456012

Copilot AI review requested due to automatic review settings May 19, 2026 06:07

Copilot started reviewing on behalf of rambabu-yalla May 19, 2026 06:12 View session

Copilot AI reviewed May 19, 2026

View reviewed changes

Updated exception bypass

51681bf

YanaXu approved these changes May 19, 2026

View reviewed changes

YanaXu merged commit 4a374f8 into Azure:main May 19, 2026
12 checks passed

Uh oh!

Conversation

rambabu-yalla commented May 12, 2026 • edited 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 May 12, 2026

Uh oh!

github-actions Bot commented May 12, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

VeryEarly commented May 12, 2026

Uh oh!

azure-pipelines Bot commented May 12, 2026

Uh oh!

VeryEarly commented May 13, 2026

Uh oh!

azure-pipelines Bot commented May 13, 2026

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

VeryEarly commented May 14, 2026

Uh oh!

azure-pipelines Bot commented May 14, 2026

Uh oh!

YanaXu commented May 15, 2026

Uh oh!

YanaXu commented May 18, 2026

Uh oh!

rambabu-yalla commented May 18, 2026

Uh oh!

YanaXu commented May 18, 2026

Uh oh!

azure-pipelines Bot commented May 18, 2026

Uh oh!

YanaXu May 19, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

YanaXu commented May 19, 2026

Uh oh!

azure-pipelines Bot commented May 19, 2026

Uh oh!

YanaXu commented May 19, 2026

Uh oh!

azure-pipelines Bot commented May 19, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

VeryEarly commented May 19, 2026

Uh oh!

azure-pipelines Bot commented May 19, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

rambabu-yalla commented May 12, 2026 •

edited

Loading