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

src/ApplicationInsights/ApplicationInsights.Autorest/Properties/AssemblyInfo.cs

@@ -0,0 +1,26 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the Apache License, Version 2.0 (the ""License"");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+// http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an ""AS IS"" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// Code generated by Microsoft (R) AutoRest Code Generator.Changes may cause incorrect behavior and will be lost if the code
+// is regenerated.
+
+using System;
+using System.Reflection;
+using System.Runtime.CompilerServices;
+using System.Runtime.InteropServices;
+
+[assembly: System.Reflection.AssemblyCompanyAttribute("Microsoft")]
+[assembly: System.Reflection.AssemblyCopyrightAttribute("Copyright © Microsoft")]
+[assembly: System.Reflection.AssemblyProductAttribute("Microsoft Azure PowerShell")]
+[assembly: System.Reflection.AssemblyTitleAttribute("Microsoft Azure PowerShell - ApplicationInsightsManagementClient")]
+[assembly: System.Reflection.AssemblyFileVersionAttribute("2.3.0")]
+[assembly: System.Reflection.AssemblyVersionAttribute("2.3.0")]
+[assembly: System.Runtime.InteropServices.ComVisibleAttribute(false)]
+[assembly: System.CLSCompliantAttribute(false)]

src/ApplicationInsights/ApplicationInsights.Autorest/README.md

@@ -429,4 +429,109 @@ directive:
           - Location
           - Kind
           - Category
+
+# #breaking change message
+  - where:
+      verb: Get|Remove
+      subject: ApiKey
+    set:
+      breaking-change:
+        deprecated-output-properties:
+          - LinkedReadProperty
+          - LinkedWriteProperty
+        new-output-properties:
+          - LinkedReadProperty
+          - LinkedWriteProperty
+        change-description: The types of the properties LinkedReadProperty, LinkedWriteProperty will be changed from 'System.String[]' to 'System.Collections.Generic.List`1[System.String]'.
+        deprecated-by-version: 9.0.0
+        deprecated-by-azversion: 15.0.0
+        change-effective-date: 2025/11/03
+
+  - where:
+      verb: Get|New|Update
+      subject: MyWorkbook
+    set:
+      breaking-change:
+        deprecated-output-properties:
+          - PropertiesTag
+        new-output-properties:
+          - PropertiesTag
+        change-description: The types of the properties PropertiesTag will be changed from 'System.String[]' to 'System.Collections.Generic.List`1[System.String]'.
+        deprecated-by-version: 9.0.0
+        deprecated-by-azversion: 15.0.0
+        change-effective-date: 2025/11/03
+
+  - where:
+      verb: New
+      subject: MyWorkbook|Workbook
+    set:
+      breaking-change:
+        deprecated-output-properties:
+          - IdentityType
+          - IdentityUserAssignedIdentity
+        new-output-properties:
+          - EnableSystemAssignedIdentity
+          - UserAssignedIdentity
+        change-description: IdentityType will be removed. EnableSystemAssignedIdentity will be used to enable/disable system assigned identity and UserAssignedIdentity will be used to specify user assigned identities.
+        deprecated-by-version: 9.0.0
+        deprecated-by-azversion: 15.0.0
+        change-effective-date: 2025/11/03
+
+  - where:
+      verb: Get|Update
+      subject: WebTest
+    set:
+      breaking-change:
+        deprecated-output-properties:
+          - RequestHeader
+          - PropertiesLocations
+        new-output-properties:
+          - RequestHeader
+          - PropertiesLocations
+        change-description: The type of property 'RequestHeader' will be changed from 'Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IHeaderField' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IHeaderField]'. And the property 'PropertiesLocations' of type 'Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20220615.IWebTest' will be removed.
+        deprecated-by-version: 9.0.0
+        deprecated-by-azversion: 15.0.0
+        change-effective-date: 2025/11/03
+
+  - where:
+      verb: Get|New|Update
+      subject: Workbook
+    set:
+      breaking-change:
+        deprecated-output-properties:
+          - PropertiesTag
+        new-output-properties:
+          - PropertiesTag
+        change-description: The type of property 'PropertiesTag' of type 'Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20220401.IWorkbook' has changed from 'System.String[]' to 'System.Collections.Generic.List`1[System.String]'.
+        deprecated-by-version: 9.0.0
+        deprecated-by-azversion: 15.0.0
+        change-effective-date: 2025/11/03
+
+  - where:
+      verb: Get
+      subject: WorkbookRevision
+    set:
+      breaking-change:
+        deprecated-output-properties:
+          - PropertiesTag
+        new-output-properties:
+          - PropertiesTag
+        change-description: The type of property 'PropertiesTag' of type 'Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20220401.IWorkbook' has changed from 'System.String[]' to 'System.Collections.Generic.List`1[System.String]'.
+        deprecated-by-version: 9.0.0
+        deprecated-by-azversion: 15.0.0
+        change-effective-date: 2025/11/03
+
+  - where:
+      verb: Get|New|Update
+      subject: WorkbookTemplate
+    set:
+      breaking-change:
+        deprecated-output-properties:
+          - Gallery
+        new-output-properties:
+          - Gallery
+        change-description: The type of property 'Gallery' of type 'Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20201120.IWorkbookTemplate' has changed from 'Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IWorkbookTemplateGallery' to 'System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IWorkbookTemplateGallery]'.
+        deprecated-by-version: 9.0.0
+        deprecated-by-azversion: 15.0.0
+        change-effective-date: 2025/11/03
 ```

src/ApplicationInsights/ApplicationInsights.Autorest/custom/Get-AzApplicationInsights.ps1

@@ -23,6 +23,7 @@ https://learn.microsoft.com/powershell/module/az.applicationinsights/get-azappli
 #>
 function Get-AzApplicationInsights {
     [OutputType([Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api202002.IApplicationInsightsComponent], [Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.PSApplicationInsightsComponentWithPricingPlan])]
+    [Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api202002.IApplicationInsightsComponent", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IApplicationInsightsComponent", DeprecatedOutputProperties = ("PrivateLinkScopedResource Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IPrivateLinkScopedResource"), NewOutputProperties = ("PrivateLinkScopedResource System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IPrivateLinkScopedResource]"))]
     [CmdletBinding(DefaultParameterSetName='ListBySubscription', PositionalBinding=$false)]
     param(
         [Parameter(ParameterSetName='Get', Mandatory)]

src/ApplicationInsights/ApplicationInsights.Autorest/custom/New-AzApplicationInsights.ps1

@@ -26,6 +26,7 @@ https://learn.microsoft.com/powershell/module/az.applicationinsights/new-azappli
 #>
 function New-AzApplicationInsights {
     [OutputType([Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api202002.IApplicationInsightsComponent])]
+    [Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api202002.IApplicationInsightsComponent", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IApplicationInsightsComponent", DeprecatedOutputProperties = ("PrivateLinkScopedResource Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IPrivateLinkScopedResource"), NewOutputProperties = ("PrivateLinkScopedResource System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IPrivateLinkScopedResource]"))]
     [CmdletBinding(PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')]
     param(
         [Parameter(Mandatory)]

src/ApplicationInsights/ApplicationInsights.Autorest/custom/New-AzApplicationInsightsApiKey.ps1

@@ -23,6 +23,7 @@ https://learn.microsoft.com/powershell/module/az.applicationinsights/new-azappli
 #>
 function New-AzApplicationInsightsApiKey {
     [OutputType([Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20150501.IApplicationInsightsComponentApiKey])]
+    [Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20150501.IApplicationInsightsComponentApiKey", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IApplicationInsightsComponentApiKey", DeprecatedOutputProperties = ("LinkedReadProperty and LinkedWriteProperty System.String[]"), NewOutputProperties = ("LinkedReadProperty and LinkedWriteProperty System.Collections.Generic.List`1[System.String]"))]
     [CmdletBinding(DefaultParameterSetName='ComponentNameParameterSet', PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')]
     param(
         [Parameter(ParameterSetName="ComponentNameParameterSet")]

src/ApplicationInsights/ApplicationInsights.Autorest/custom/New-AzApplicationInsightsWebTest.ps1

@@ -46,6 +46,7 @@ https://learn.microsoft.com/powershell/module/az.applicationinsights/new-azappli
 #>
 function New-AzApplicationInsightsWebTest {
     [OutputType([Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20220615.IWebTest])]
+    [Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20220615.IWebTest", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IWebTest", DeprecatedOutputProperties = ("RequestHeader System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IHeaderField]"), NewOutputProperties = ("RequestHeader System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IHeaderField]"))]
     [CmdletBinding(DefaultParameterSetName='CreateStandard', PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')]
     param(
         [Parameter(Mandatory)]

src/ApplicationInsights/ApplicationInsights.Autorest/custom/Set-AzApplicationInsightsDailyCap.ps1

@@ -24,6 +24,7 @@ https://learn.microsoft.com/powershell/module/az.applicationinsights/set-azappli
 #>
 function Set-AzApplicationInsightsDailyCap {
     [OutputType([Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20150501.IApplicationInsightsComponentBillingFeatures])]
+    [Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20150501.IApplicationInsightsComponentBillingFeatures", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IApplicationInsightsComponentBillingFeatures", DeprecatedOutputProperties = ("CurrentBillingFeature System.String[]"), NewOutputProperties = ("CurrentBillingFeature System.Collections.Generic.List`1[System.String]"))]
     [CmdletBinding(DefaultParameterSetName='UpdateExpanded', PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')]
     param(
         [Parameter(Mandatory)]

src/ApplicationInsights/ApplicationInsights.Autorest/custom/Set-AzApplicationInsightsPricingPlan.ps1

@@ -24,6 +24,7 @@ https://learn.microsoft.com/powershell/module/az.applicationinsights/set-azappli
 #>
 function Set-AzApplicationInsightsPricingPlan {
     [OutputType([Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20150501.IApplicationInsightsComponentBillingFeatures])]
+    [Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api20150501.IApplicationInsightsComponentBillingFeatures", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IApplicationInsightsComponentBillingFeatures", DeprecatedOutputProperties = ("CurrentBillingFeature System.String[]"), NewOutputProperties = ("CurrentBillingFeature System.Collections.Generic.List`1[System.String]"))]
     [CmdletBinding(DefaultParameterSetName='UpdateExpanded', PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')]
     param(
         [Parameter(Mandatory)]

src/ApplicationInsights/ApplicationInsights.Autorest/custom/Update-AzApplicationInsights.ps1

@@ -26,6 +26,7 @@ https://learn.microsoft.com/powershell/module/az.applicationinsights/update-azap
 #>
 function Update-AzApplicationInsights {
     [OutputType([Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api202002.IApplicationInsightsComponent])]
+    [Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.Api202002.IApplicationInsightsComponent", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IApplicationInsightsComponent", DeprecatedOutputProperties = ("PrivateLinkScopedResource Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IPrivateLinkScopedResource"), NewOutputProperties = ("PrivateLinkScopedResource System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.ApplicationInsights.Models.IPrivateLinkScopedResource]"))]
     [CmdletBinding(PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')]
     param(
         [Parameter(Mandatory)]

src/ApplicationInsights/ApplicationInsights.Autorest/docs/Az.ApplicationInsights.md

@@ -1,6 +1,6 @@
 ---
 Module Name: Az.ApplicationInsights
-Module Guid: 031a685e-5904-433f-b2f8-4fcef3cd15d8
+Module Guid: 82352bfb-97f5-4cce-8aac-bb4b6b1cd49c
 Download Help Link: https://learn.microsoft.com/powershell/module/az.applicationinsights
 Help Version: 1.0.0.0
 Locale: en-US

src/ApplicationInsights/ApplicationInsights.Autorest/docs/Get-AzApplicationInsightsApiKey.md

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

src/ApplicationInsights/ApplicationInsights.Autorest/docs/Get-AzApplicationInsightsWebTest.md

@@ -55,7 +55,7 @@ Get-AzApplicationInsightsWebTest
 ```output
 Name                                 Location WebTestKind ResourceGroupName
 ----                                 -------- ----------- -----------------
-bsaic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test
+basic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test
 basic-portal02-appinsights-portal01  westus2  ping        azpwsh-rg-test
 basic-portal03-appinsights-portal01  westus2  ping        azpwsh-rg-test
 standard-portal-appinsights-portal01 westus2  standard    azpwsh-rg-test
@@ -72,7 +72,7 @@ Get-AzApplicationInsightsWebTest -ResourceGroupName azpwsh-rg-test
 ```output
 Name                                 Location WebTestKind ResourceGroupName
 ----                                 -------- ----------- -----------------
-bsaic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test
+basic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test
 basic-portal02-appinsights-portal01  westus2  ping        azpwsh-rg-test
 basic-portal03-appinsights-portal01  westus2  ping        azpwsh-rg-test
 standard-portal-appinsights-portal01 westus2  standard    azpwsh-rg-test
@@ -89,7 +89,7 @@ Get-AzApplicationInsightsWebTest -ResourceGroupName azpwsh-rg-test -AppInsightsN
 ```output
 Name                                 Location WebTestKind ResourceGroupName   Enabled
 ----                                 -------- ----------- -----------------   -------
-bsaic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test      True
+basic-portal-appinsights-portal01    westus2  ping        azpwsh-rg-test      True
 basic-portal02-appinsights-portal01  westus2  ping        azpwsh-rg-test      True
 basic-portal03-appinsights-portal01  westus2  ping        azpwsh-rg-test      True
 standard-portal-appinsights-portal01 westus2  standard    azpwsh-rg-test      True

src/ApplicationInsights/ApplicationInsights.Autorest/docs/New-AzApplicationInsightsWebTest.md

@@ -81,7 +81,21 @@ This command creates or updates a standard kind of the Application Insights web
 
 The switch parameter "-Enabled" must be set explicitly to $false to disable the test.
 
-### Example 3: Creates or updates a ping kind of the Application Insights web test
+### Example 3: Creates a standard kind of the Application Insights web test with a custom header
+```powershell
+$headerField = New-AzApplicationInsightsWebTestHeaderFieldObject -Name "HeaderName1" -Value "HeaderValue1"
+New-AzApplicationInsightsWebTest -ResourceGroupName exampleRG -Name expwshelltestheader2 -Location 'westus2' -Tag @{"hidden-link:<RESOURCE URL>" = "Resource"} -RequestUrl "https://www.bing.com" -RequestHttpVerb "GET" -TestName 'expwshelltestheader2' -RuleExpectedHttpStatusCode 200 -Frequency 300 -Enabled -Timeout 120 -Kind 'standard' -RetryEnabled -GeoLocation $geoLocation -RequestHeader $headerField
+```
+
+```output
+Name            	Location 	WebTestKind 	ResourceGroupName  	Enabled
+----            	-------- 	----------- 	-----------------  	-------
+expwshellheader2 	westus2  	standard    	exampleRG		    True
+```
+
+This command creates a standard kind of the Application Insights web test with a custom header
+
+### Example 4: Creates or updates a ping kind of the Application Insights web test
 ```powershell
 $geoLocation = @()
 $geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "emea-nl-ams-azr"
@@ -101,7 +115,7 @@ pingwebtest-pwsh01 westus2  ping        azpwsh-rg-test      True
 
 This command creates or updates an ping kind of the Application Insights web test.
 
-### Example 4: Creates or updates a ping kind of the Application Insights web test with custom configuration
+### Example 5: Creates or updates a ping kind of the Application Insights web test with custom configuration
 ```powershell
 $geoLocation = @()
 $geoLocation += New-AzApplicationInsightsWebTestGeolocationObject -Location "emea-nl-ams-azr"

src/ApplicationInsights/ApplicationInsights.Autorest/docs/Remove-AzApplicationInsightsApiKey.md

@@ -31,7 +31,7 @@ Delete an API Key of an Application Insights component.
 
 ### Example 1: Remove an application insights api key for an application insights resource
 ```powershell
-Remove-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId dd173f38-4fd1-4c75-8af5-99c29aa0f867
+Remove-AzApplicationInsightsApiKey -ResourceGroupName "testGroup" -Name "test" -ApiKeyId 00001111-aaaa-2222-bbbb-3333cccc4444
 ```
 
 Remove an application insights api key for an application insights resource

src/ApplicationInsights/ApplicationInsights.Autorest/examples/Get-AzApplicationInsightsApiKey.md

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