[Az.ContainerInstance] Update generation tool version: autorest.powershell v3->v4 by lijinpei2008 · Pull Request #28376 · Azure/azure-powershell

lijinpei2008 · 2025-08-11T04:59:19Z

Description

Preannouncement PR:

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

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

…ell v3->v4

azure-client-tools-bot-prd · 2025-08-11T04:59:22Z

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

Copilot

Pull Request Overview

This PR updates the autorest.powershell generation tool from version 3 to version 4 for the Az.ContainerInstance module. The update modernizes the SDK generation process and updates parameter handling patterns.

Updates generation tool to leverage autorest.powershell v4 features
Consolidates parameter sets and introduces new Json input patterns for update operations
Modernizes identity management patterns with new EnableSystemAssignedIdentity parameter

Reviewed Changes

Copilot reviewed 89 out of 89 changed files in this pull request and generated 8 comments.

File	Description
tools/StaticAnalysis/Exceptions/Az.ContainerInstance/BreakingChangeIssues.csv	Adds breaking change exceptions for property type changes and parameter patterns
src/ContainerInstance/ContainerInstance/help/*.md	Updates help documentation with new parameter sets and type references
src/ContainerInstance/ContainerInstance.Autorest/test/New-AzContainerGroup.Tests.ps1	Updates test to use new identity parameter pattern
src/ContainerInstance/ContainerInstance.Autorest/examples/*.md	Updates example usage to reflect new identity management approach

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

Copilot · 2025-08-14T12:03:06Z

 ## SYNOPSIS
 Restarts all containers in a container group in place.
-If container image has updates, new image will be downloaded.
+If container image has restart  new image will be downloaded.


There appears to be a word missing in this line. It should read 'If container image has updates, new image will be downloaded.' The word 'updates' seems to have been replaced with 'restart' incorrectly.

Suggested change

If container image has restart new image will be downloaded.

If container image has updates, new image will be downloaded.

Copilot · 2025-08-14T12:03:06Z

 ## DESCRIPTION
 Restarts all containers in a container group in place.
-If container image has updates, new image will be downloaded.
+If container image has restart  new image will be downloaded.


Same issue as above - 'restart' should be 'updates' for consistency and correctness.

Suggested change

If container image has restart new image will be downloaded.

If the container image has updates, the new image will be downloaded.

Copilot · 2025-08-14T12:03:06Z

 ```

-This command updates a container group profile using piping.
+This command updates a container group profile using pipeing.


The word 'pipeing' is misspelled. It should be 'piping'.

Suggested change

This command updates a container group profile using pipeing.

This command updates a container group profile using piping.

Copilot · 2025-08-14T12:03:07Z

 ```

-This command updates a container group using piping.
+This command updates a container group using pipeing.


The word 'pipeing' is misspelled. It should be 'piping'.

Suggested change

This command updates a container group using pipeing.

This command updates a container group using piping.

Copilot · 2025-08-14T12:03:07Z

 ```

-This command updates a container group profile using piping.
+This command updates a container group profile using pipeing.


The word 'pipeing' is misspelled. It should be 'piping'.

Suggested change

This command updates a container group profile using pipeing.

This command updates a container group profile using piping.

Copilot · 2025-08-14T12:03:07Z

 ```

-This command updates a container group using piping.
+This command updates a container group using pipeing.


The word 'pipeing' is misspelled. It should be 'piping'.

Suggested change

This command updates a container group using pipeing.

This command updates a container group using piping.

Copilot · 2025-08-14T12:03:08Z

 ## SYNOPSIS
 Restarts all containers in a container group in place.
-If container image has updates, new image will be downloaded.
+If container image has restart  new image will be downloaded.


There appears to be a word missing or incorrect in this line. It should read 'If container image has updates, new image will be downloaded.' The word 'updates' seems to have been replaced with 'restart' incorrectly.

Suggested change

If container image has restart new image will be downloaded.

If container image has updates, new image will be downloaded.

Copilot · 2025-08-14T12:03:08Z

 ## DESCRIPTION
 Restarts all containers in a container group in place.
-If container image has updates, new image will be downloaded.
+If container image has restart  new image will be downloaded.


Same issue as above - 'restart' should be 'updates' for consistency and correctness.

Suggested change

If container image has restart new image will be downloaded.

If the container image has updates, a new image will be downloaded.

lijinpei2008 · 2025-08-15T02:05:55Z

/azp run

azure-pipelines · 2025-08-15T02:06:11Z

Azure Pipelines successfully started running 3 pipeline(s).

github-actions · 2025-08-18T03:56:22Z

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.

github-actions · 2025-08-18T05:21:49Z

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.

… jinpei/main/ContainerInstance-v4

Copilot

Pull request overview

Copilot reviewed 87 out of 87 changed files in this pull request and generated 2 comments.

Copilot · 2026-02-06T02:05:33Z

 ## SYNOPSIS
 Restarts all containers in a container group in place.
-If container image has updates, new image will be downloaded.
+If container image has restart  new image will be downloaded.


The text "If container image has restart" appears to be a corrupted sentence. The original text "If container image has updates" makes more sense. The word "updates" was incorrectly changed to "restart".

Copilot · 2026-02-06T02:05:34Z

 -->

 ## Upcoming Release
+* Improved user experience and consistency. This may introduce breaking changes. Please refer to [here](https://go.microsoft.com/fwlink/?linkid=2340249).


The ChangeLog entry lacks specific details about what changed for users. According to guideline 1000003, ChangeLog entries should be written from the user's perspective and explain what changed and how it affects their usage. The current entry just references a link without describing the actual improvements or breaking changes users will experience.

isra-fel · 2026-02-06T02:09:44Z

/azp run

azure-pipelines · 2026-02-06T02:10:01Z

Azure Pipelines successfully started running 3 pipeline(s).

isra-fel · 2026-02-06T03:09:41Z

/azp run

azure-pipelines · 2026-02-06T03:09:56Z

Azure Pipelines successfully started running 3 pipeline(s).

JunKai-v · 2026-02-06T05:22:16Z

/azp run

azure-pipelines · 2026-02-06T05:22:34Z

Azure Pipelines successfully started running 3 pipeline(s).

…erInstance-v4

NoriZC · 2026-03-27T03:08:53Z

/azp run

azure-pipelines · 2026-03-27T03:09:07Z

Azure Pipelines successfully started running 3 pipeline(s).

JunKai-v · 2026-03-27T04:50:14Z

/azp run

azure-pipelines · 2026-03-27T04:50:39Z

Azure Pipelines successfully started running 3 pipeline(s).

NoriZC · 2026-03-27T07:39:26Z

/azp run

azure-pipelines · 2026-03-27T07:39:39Z

Azure Pipelines successfully started running 3 pipeline(s).

Copilot

Pull request overview

Copilot reviewed 87 out of 87 changed files in this pull request and generated 12 comments.

Copilot · 2026-03-27T07:48:12Z

 Restarts all containers in a container group in place.
-If container image has updates, new image will be downloaded.
+If container image has restart  new image will be downloaded.



The synopsis/description text is corrupted: "If container image has restart new image will be downloaded." should describe image updates (and remove the double space). Please correct the wording to match the intended behavior.

Copilot · 2026-03-27T07:48:12Z

 ## OUTPUTS

-### System.String
+### Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.Models.ILogs



The output type in this help file was changed to Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.Models.ILogs, but the exported cmdlet (generated/ContainerInstance/.../Get-AzContainerInstanceLog.ps1) still declares [OutputType([System.String])]. Please align the help OUTPUTS section with the actual cmdlet output (or update the cmdlet if the output type truly changed).

Copilot · 2026-03-27T07:48:12Z


 ## OUTPUTS

-### System.String
+### Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.Models.ILogs



The output type in this reference doc was changed to Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.Models.ILogs, but the cmdlet export still reports System.String as its OutputType. Please keep docs and cmdlet output consistent (either revert docs to System.String or update the cmdlet implementation/metadata).

Copilot · 2026-03-27T07:48:12Z

 ---
 Module Name: Az.ContainerInstance
-Module Guid: 28e34b68-2d28-4aec-8797-6db484c2f903
+Module Guid: 393cc40d-8cda-42fb-8517-e52ebc003c3f


Module Guid in this front-matter does not match the module manifest GUID (src/ContainerInstance/ContainerInstance/Az.ContainerInstance.psd1 has GUID ddf74844-4a25-4263-8a5c-f27979292e4e). Please update the docs front-matter to match the manifest (or update the manifest if the GUID intentionally changed).

Suggested change

Module Guid: 393cc40d-8cda-42fb-8517-e52ebc003c3f

Module Guid: ddf74844-4a25-4263-8a5c-f27979292e4e

Copilot · 2026-03-27T07:48:13Z

 ## SYNOPSIS
 Restarts all containers in a container group in place.
-If container image has updates, new image will be downloaded.
+If container image has restart  new image will be downloaded.



The synopsis/description text is corrupted: "If container image has restart new image will be downloaded." should describe image updates (and remove the double space). Please correct the wording to match the intended behavior.

Copilot · 2026-03-27T07:48:13Z

+"Az.ContainerInstance","New-AzContainerGroup","7","2","Invalid_Parameter_Name","5011","1","New-AzContainerGroup -EnableSystemAssignedIdentity is not a valid parameter name.","-EnableSystemAssignedIdentity","Check validity of the parameter -EnableSystemAssignedIdentity."
+"Az.ContainerInstance","New-AzContainerGroup","7","2","Invalid_Parameter_Name","5011","1","New-AzContainerGroup -UserAssignedIdentity is not a valid parameter name.","-UserAssignedIdentity","Check validity of the parameter -UserAssignedIdentity."
+"Az.ContainerInstance","New-AzContainerGroup","7","2","Invalid_Parameter_Name","5011","1","New-AzContainerGroup -EnableSystemAssignedIdentity is not a valid parameter name.","-EnableSystemAssignedIdentity","Check validity of the parameter -EnableSystemAssignedIdentity."
+"Az.ContainerInstance","New-AzContainerGroup","7","2","Invalid_Parameter_Name","5011","1","New-AzContainerGroup -UserAssignedIdentity is not a valid parameter name.","-UserAssignedIdentity","Check validity of the parameter -UserAssignedIdentity."


These exceptions suppress "Invalid_Parameter_Name" for -EnableSystemAssignedIdentity and -UserAssignedIdentity in New-AzContainerGroup examples. That indicates the published cmdlet metadata still doesn't recognize these parameters; rather than adding exceptions, please regenerate/update the cmdlet so the examples match the actual parameter names (and then remove the exceptions).

Copilot · 2026-03-27T07:48:14Z

 ### [Restart-AzContainerGroup](Restart-AzContainerGroup.md)
 Restarts all containers in a container group in place.
-If container image has updates, new image will be downloaded.
+If container image has restart  new image will be downloaded.



This module index repeats the same corrupted Restart-AzContainerGroup description ("If container image has restart new image will be downloaded."). Please fix the wording here as well so the index matches the cmdlet help.

Copilot · 2026-03-27T07:48:14Z

 ## Upcoming Release
+* Improved user experience and consistency. This may introduce breaking changes. Please refer to [here](https://go.microsoft.com/fwlink/?linkid=2340249).
+


The changelog entry is very generic and lacks an issue reference. Since this PR updates the generation tool and introduces preannounced breaking changes, please describe the user-visible impact more concretely (e.g., identity parameter changes / JSON input support) and reference the related issues/PRs in the required [#[id]] format.

Copilot · 2026-03-27T07:48:14Z

+    ${Extension},
+
+    [Parameter(ParameterSetName='CreateExpanded')]
+    [Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.PSArgumentCompleterAttribute("Unsecure", "TenantReuse", "SubscriptionReuse", "ResourceGroupReuse", "Noreuse")]


Argument completer includes value "Noreuse" but the parameter description and REST enum use "NoReuse" (capital R). Please fix the completer value to avoid suggesting an invalid string to users.

Suggested change

[Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.PSArgumentCompleterAttribute("Unsecure", "TenantReuse", "SubscriptionReuse", "ResourceGroupReuse", "Noreuse")]

[Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.PSArgumentCompleterAttribute("Unsecure", "TenantReuse", "SubscriptionReuse", "ResourceGroupReuse", "NoReuse")]

Copilot · 2026-03-27T07:48:14Z

      "name": "Restart-AzContainerGroup",
-      "description": "Restarts all containers in a container group in place.\nIf container image has updates, new image will be downloaded.",
+      "description": "Restarts all containers in a container group in place.\nIf container image has restart  new image will be downloaded.",
      "path": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerInstance/containerGroups/{containerGroupName}/restart",
      "help": {


The UX metadata repeats the same corrupted Restart-AzContainerGroup description ("If container image has restart new image will be downloaded."). Please correct the wording here so generated help/UX stays accurate.

…erInstance-v4

JunKai-v · 2026-04-07T04:10:26Z

/azp run

azure-pipelines · 2026-04-07T04:10:41Z

Azure Pipelines successfully started running 3 pipeline(s).

Az.ContainerInstance update generation tool version: autorest.powersh…

97372fb

…ell v3->v4

lijinpei2008 mentioned this pull request Aug 14, 2025

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

Merged

6 tasks

lijinpei2008 added 2 commits August 14, 2025 17:42

update

b43a6d8

create BreakingChangeIssues.csv

ee2d5f8

lijinpei2008 marked this pull request as ready for review August 14, 2025 12:01

Copilot AI review requested due to automatic review settings August 14, 2025 12:01

Copilot AI reviewed Aug 14, 2025

View reviewed changes

lijinpei2008 added the Contains Breaking Change This PR contains breaking change label Aug 18, 2025

lijinpei2008 marked this pull request as draft August 18, 2025 04:04

lijinpei2008 added Contains Breaking Change This PR contains breaking change and removed Contains Breaking Change This PR contains breaking change labels Aug 18, 2025

lijinpei2008 and others added 2 commits August 18, 2025 16:34

Update

db2f511

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

f4ffc28

lijinpei2008 marked this pull request as ready for review August 22, 2025 10:34

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

b4ae985

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

lijinpei2008 added 3 commits October 22, 2025 17:21

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

487a336

… jinpei/main/ContainerInstance-v4

update

22ef815

update changelog

c754a2f

isra-fel assigned Pan-Qi Jan 29, 2026

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

rebuild with Autorest 4.0.752

c122496

Copilot AI review requested due to automatic review settings February 6, 2026 01:55

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

Copilot AI reviewed Feb 6, 2026

View reviewed changes

update example issues csv

e00870f

Merge remote-tracking branch 'upstream/main' into jinpei/main/Contain…

9462d81

…erInstance-v4

rebuild

0a33b03

Copilot AI review requested due to automatic review settings March 27, 2026 07:39

Copilot started reviewing on behalf of JunKai-v March 27, 2026 07:42 View session

Copilot AI reviewed Mar 27, 2026

View reviewed changes

JunKai-v added 2 commits April 7, 2026 12:00

Merge remote-tracking branch 'upstream/main' into jinpei/main/Contain…

1c2ba3e

…erInstance-v4

rebuild

aeef173

	If container image has restart new image will be downloaded.
	If container image has updates, new image will be downloaded.

	If container image has restart new image will be downloaded.
	If the container image has updates, the new image will be downloaded.

	This command updates a container group profile using pipeing.
	This command updates a container group profile using piping.

	This command updates a container group using pipeing.
	This command updates a container group using piping.

	If container image has restart new image will be downloaded.
	If the container image has updates, a new image will be downloaded.

	Module Guid: 393cc40d-8cda-42fb-8517-e52ebc003c3f
	Module Guid: ddf74844-4a25-4263-8a5c-f27979292e4e

		## Upcoming Release
		* Improved user experience and consistency. This may introduce breaking changes. Please refer to [here](https://go.microsoft.com/fwlink/?linkid=2340249).

	[Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.PSArgumentCompleterAttribute("Unsecure", "TenantReuse", "SubscriptionReuse", "ResourceGroupReuse", "Noreuse")]
	[Microsoft.Azure.PowerShell.Cmdlets.ContainerInstance.PSArgumentCompleterAttribute("Unsecure", "TenantReuse", "SubscriptionReuse", "ResourceGroupReuse", "NoReuse")]

Conversation

lijinpei2008 commented Aug 11, 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 Aug 11, 2025

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI Aug 14, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 14, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 14, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 14, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 14, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 14, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 14, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 14, 2025

Choose a reason for hiding this comment

Uh oh!

lijinpei2008 commented Aug 15, 2025

Uh oh!

azure-pipelines bot commented Aug 15, 2025

Uh oh!

github-actions bot commented Aug 18, 2025

Uh oh!

github-actions bot commented Aug 18, 2025

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!

isra-fel commented Feb 6, 2026

Uh oh!

azure-pipelines bot commented Feb 6, 2026

Uh oh!

isra-fel commented Feb 6, 2026

Uh oh!

azure-pipelines bot commented Feb 6, 2026

Uh oh!

JunKai-v commented Feb 6, 2026

Uh oh!

azure-pipelines bot commented Feb 6, 2026

Uh oh!

NoriZC commented Mar 27, 2026

Uh oh!

azure-pipelines bot commented Mar 27, 2026

Uh oh!

JunKai-v commented Mar 27, 2026

Uh oh!

azure-pipelines bot commented Mar 27, 2026

Uh oh!

NoriZC commented Mar 27, 2026

Uh oh!

azure-pipelines bot commented Mar 27, 2026

Uh oh!

Copilot AI left a comment

lijinpei2008 commented Aug 11, 2025 •

edited by JunKai-v

Loading