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

lijinpei2008 · 2025-07-22T06:52:45Z

…shell v3->v4

Description

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

…shell v3->v4

azure-client-tools-bot-prd · 2025-07-22T06:52:48Z

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

lijinpei2008 · 2025-08-08T08:52:33Z

/azp run

azure-pipelines · 2025-08-08T08:52:49Z

Azure Pipelines successfully started running 3 pipeline(s).

… jinpei/main/ApplicationInsights-v4

github-actions · 2025-08-18T05:20:17Z

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 Az.ApplicationInsights module's generation tool from autorest.powershell v3 to v4. The update includes the regeneration of cmdlets and documentation using the newer version of the autorest tool, leading to multiple API signature changes and parameter type updates across various Application Insights commands.

Key changes:

Parameter type changes from strongly-typed enums to string types across multiple cmdlets
Addition of new parameter sets with JSON input options for Update and Create operations
Updates to help documentation reflecting new parameter types and parameter sets

Reviewed Changes

Copilot reviewed 104 out of 104 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
tools/StaticAnalysis/Exceptions/Az.ApplicationInsights/BreakingChangeIssues.csv	Documents expected breaking changes from the v3 to v4 migration
src/ApplicationInsights/ApplicationInsights/help/*.md	Updates help documentation to reflect new parameter types and sets
src/ApplicationInsights/ApplicationInsights/Az.ApplicationInsights.psd1	Updates module metadata including dependency versions and format paths
src/ApplicationInsights/ApplicationInsights.sln	Adds new solution configurations and project references
src/ApplicationInsights/ApplicationInsights.Autorest/test/	Updates test files with new parameter expectations
src/ApplicationInsights/ApplicationInsights.Autorest/examples/	Updates example documentation with corrected parameter usage
src/ApplicationInsights/ApplicationInsights.Autorest/docs/	Updates auto-generated documentation to match new cmdlet signatures

Copilot · 2025-08-18T06:45:18Z

src/ApplicationInsights/ApplicationInsights/help/Get-AzApplicationInsightsWebTest.md

 Name                                 Location WebTestKind ResourceGroupName
 ----                                 -------- ----------- -----------------
-basic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test
+bsaic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test


There's a typo in the name 'bsaic-portal-appinsights-portal01'. It should be 'basic-portal-appinsights-portal01' to match the pattern in other examples.

Suggested change

bsaic-portal-appinsights-portal01 westus2 ping azpwsh-rg-test

basic-portal-appinsights-portal01 westus2 ping azpwsh-rg-test

Copilot · 2025-08-18T06:45:18Z

src/ApplicationInsights/ApplicationInsights/help/Get-AzApplicationInsightsWebTest.md

 Name                                 Location WebTestKind ResourceGroupName
 ----                                 -------- ----------- -----------------
-basic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test
+bsaic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test


There's a typo in the name 'bsaic-portal-appinsights-portal01'. It should be 'basic-portal-appinsights-portal01' to match the pattern in other examples.

Suggested change

bsaic-portal-appinsights-portal01 westus2 ping azpwsh-rg-test

basic-portal-appinsights-portal01 westus2 ping azpwsh-rg-test

Copilot · 2025-08-18T06:45:19Z

src/ApplicationInsights/ApplicationInsights/help/Get-AzApplicationInsightsWebTest.md

 Name                                 Location WebTestKind ResourceGroupName   Enabled
 ----                                 -------- ----------- -----------------   -------
-basic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test      True
+bsaic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test      True


There's a typo in the name 'bsaic-portal-appinsights-portal01'. It should be 'basic-portal-appinsights-portal01' to match the pattern in other examples.

Suggested change

bsaic-portal-appinsights-portal01 westus2 ping azpwsh-rg-test True

basic-portal-appinsights-portal01 westus2 ping azpwsh-rg-test True

Copilot · 2025-08-18T06:45:19Z

src/ApplicationInsights/ApplicationInsights/help/Remove-AzApplicationInsightsApiKey.md

 ### Example 1: Remove an application insights api key for an application insights resource
 ```powershell
-Remove-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 00001111-aaaa-2222-bbbb-3333cccc4444
+Remove-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId dd173f38-4fd1-4c75-8af5-99c29aa0f867


[nitpick] The example shows a different UUID format than the original example which used '00001111-aaaa-2222-bbbb-3333cccc4444'. For consistency across documentation, consider using a standardized placeholder format for UUIDs in examples.

Suggested change

Remove-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId dd173f38-4fd1-4c75-8af5-99c29aa0f867

Remove-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 00001111-aaaa-2222-bbbb-3333cccc4444

Copilot · 2025-08-18T06:45:19Z

src/ApplicationInsights/ApplicationInsights/help/Get-AzApplicationInsightsApiKey.md

 ### Example 2: Get specific API key for an application insights resource
 ```powershell
-Get-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 00001111-aaaa-2222-bbbb-3333cccc4444
+Get-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 7c4c61dc-b392-4aa4-992f-ee92b84e5dee


[nitpick] The example shows a different UUID format than the original example which used '00001111-aaaa-2222-bbbb-3333cccc4444'. For consistency across documentation, consider using a standardized placeholder format for UUIDs in examples.

Suggested change

Get-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 7c4c61dc-b392-4aa4-992f-ee92b84e5dee

Get-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 00001111-aaaa-2222-bbbb-3333cccc4444

Az.ApplicationInsights update generation tool version: autorest.power…

7afe9d0

…shell v3->v4

lijinpei2008 mentioned this pull request Jul 25, 2025

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

Merged

6 tasks

lijinpei2008 added 3 commits August 8, 2025 17:46

create BreakingChangeIssues.csv

1556d74

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

cbc935b

… jinpei/main/ApplicationInsights-v4

update examples

cf6ee71

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

Pan-Qi marked this pull request as ready for review August 18, 2025 06:43

Copilot AI review requested due to automatic review settings August 18, 2025 06:43

Copilot AI reviewed Aug 18, 2025

View reviewed changes

lijinpei2008 and others added 4 commits August 22, 2025 18:21

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

2bec8bb

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

4936e31

Unit test recode pass

260b455

Update changelog

64ff1de

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

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

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

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

Uh oh!

lijinpei2008 commented Jul 22, 2025

Uh oh!

azure-client-tools-bot-prd bot commented Jul 22, 2025

Uh oh!

lijinpei2008 commented Aug 8, 2025

Uh oh!

azure-pipelines bot commented Aug 8, 2025

Uh oh!

github-actions bot commented Aug 18, 2025

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Aug 18, 2025

Uh oh!

Copilot AI Aug 18, 2025

Uh oh!

Copilot AI Aug 18, 2025

Uh oh!

Copilot AI Aug 18, 2025

Uh oh!

Copilot AI Aug 18, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	bsaic-portal-appinsights-portal01 westus2 ping azpwsh-rg-test
	basic-portal-appinsights-portal01 westus2 ping azpwsh-rg-test

	Remove-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId dd173f38-4fd1-4c75-8af5-99c29aa0f867
	Remove-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 00001111-aaaa-2222-bbbb-3333cccc4444

	Get-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 7c4c61dc-b392-4aa4-992f-ee92b84e5dee
	Get-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 00001111-aaaa-2222-bbbb-3333cccc4444

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

Are you sure you want to change the base?

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

Uh oh!

Conversation

lijinpei2008 commented Jul 22, 2025

Description

Mandatory Checklist

Uh oh!

azure-client-tools-bot-prd bot commented Jul 22, 2025

Uh oh!

lijinpei2008 commented Aug 8, 2025

Uh oh!

azure-pipelines bot commented Aug 8, 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

Reviewed Changes

Uh oh!

Copilot AI Aug 18, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 18, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 18, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 18, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 18, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants