Add workaround example for New-AzPortalDashboard using Invoke-AzRestMethod (#28428)

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: isra-fel <[email protected]>

Author: Copilot

src/Portal/Portal.Autorest/docs/New-AzPortalDashboard.md

@@ -61,6 +61,30 @@ eastasia my-dashboard03 Microsoft.Portal/dashboards
 
 Create a new dashboard using the provided dashboard template file.
 
+### Example 2: Workaround for dashboard creation issues using Invoke-AzRestMethod
+```powershell
+$SubscriptionId = (Get-AzContext).Subscription.Id
+$ResourceGroupName = 'mydash-rg'
+$DashboardName = 'my-dashboard03'
+$DashboardPath = ".\resources\dash1.json"
+$Location = "East US"
+$ApiVersion = "2022-12-01-preview"
+$Dashboard = Get-Content -Path $DashboardPath -Raw | ConvertFrom-Json
+$Payload = @{
+    properties = $Dashboard.properties
+    location = $Location
+} | ConvertTo-Json -Depth 10
+Invoke-AzRestMethod -SubscriptionId $SubscriptionId -ResourceGroupName $ResourceGroupName -ResourceProviderName "Microsoft.Portal" -ResourceType "dashboards" -Name $DashboardName -ApiVersion $ApiVersion -Method PUT -Payload $Payload
+```
+
+```output
+StatusCode        : 200
+Content           : {"id":"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mydash-rg/providers/Microsoft.Portal/dashboards/my-dashboard03","name":"my-dashboard03","type":"Microsoft.Portal/dashboards","location":"East US","properties":{...}}
+Headers           : {[Content-Length, 1234], [Content-Type, application/json; charset=utf-8], [Date, Wed, 01 Jan 2025 00:00:00 GMT]}
+```
+
+Use this workaround when `New-AzPortalDashboard` succeeds but the dashboard fails to render with "Dashboard not found" error. This issue is with the underlying REST API and this method provides a reliable alternative.
+
 ## PARAMETERS
 
 ### -DashboardPath

src/Portal/Portal.Autorest/examples/New-AzPortalDashboard.md

@@ -7,8 +7,32 @@ New-AzPortalDashboard -DashboardPath .\resources\dash1.json -ResourceGroupName m
 Location Name           Type
 -------- ----           ----
 eastasia my-dashboard03 Microsoft.Portal/dashboards
-`````
+```
 
 Create a new dashboard using the provided dashboard template file.
 
+### Example 2: Workaround for dashboard creation issues using Invoke-AzRestMethod
+```powershell
+$SubscriptionId = (Get-AzContext).Subscription.Id
+$ResourceGroupName = 'mydash-rg'
+$DashboardName = 'my-dashboard03'
+$DashboardPath = ".\resources\dash1.json"
+$Location = "East US"
+$ApiVersion = "2022-12-01-preview"
+$Dashboard = Get-Content -Path $DashboardPath -Raw | ConvertFrom-Json
+$Payload = @{
+    properties = $Dashboard.properties
+    location = $Location
+} | ConvertTo-Json -Depth 10
+Invoke-AzRestMethod -SubscriptionId $SubscriptionId -ResourceGroupName $ResourceGroupName -ResourceProviderName "Microsoft.Portal" -ResourceType "dashboards" -Name $DashboardName -ApiVersion $ApiVersion -Method PUT -Payload $Payload
+```
+
+```output
+StatusCode        : 200
+Content           : {"id":"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mydash-rg/providers/Microsoft.Portal/dashboards/my-dashboard03","name":"my-dashboard03","type":"Microsoft.Portal/dashboards","location":"East US","properties":{...}}
+Headers           : {[Content-Length, 1234], [Content-Type, application/json; charset=utf-8], [Date, Wed, 01 Jan 2025 00:00:00 GMT]}
+```
+
+Use this workaround when `New-AzPortalDashboard` succeeds but the dashboard fails to render with "Dashboard not found" error. This issue is with the underlying REST API and this method provides a reliable alternative.
+
 

src/Portal/Portal/help/New-AzPortalDashboard.md

@@ -65,6 +65,30 @@ eastasia my-dashboard03 Microsoft.Portal/dashboards
 
 Create a new dashboard using the provided dashboard template file.
 
+### Example 2: Workaround for dashboard creation issues using Invoke-AzRestMethod
+```powershell
+$SubscriptionId = (Get-AzContext).Subscription.Id
+$ResourceGroupName = 'mydash-rg'
+$DashboardName = 'my-dashboard03'
+$DashboardPath = ".\resources\dash1.json"
+$Location = "East US"
+$ApiVersion = "2022-12-01-preview"
+$Dashboard = Get-Content -Path $DashboardPath -Raw | ConvertFrom-Json
+$Payload = @{
+    properties = $Dashboard.properties
+    location = $Location
+} | ConvertTo-Json -Depth 10
+Invoke-AzRestMethod -SubscriptionId $SubscriptionId -ResourceGroupName $ResourceGroupName -ResourceProviderName "Microsoft.Portal" -ResourceType "dashboards" -Name $DashboardName -ApiVersion $ApiVersion -Method PUT -Payload $Payload
+```
+
+```output
+StatusCode        : 200
+Content           : {"id":"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mydash-rg/providers/Microsoft.Portal/dashboards/my-dashboard03","name":"my-dashboard03","type":"Microsoft.Portal/dashboards","location":"East US","properties":{...}}
+Headers           : {[Content-Length, 1234], [Content-Type, application/json; charset=utf-8], [Date, Wed, 01 Jan 2025 00:00:00 GMT]}
+```
+
+Use this workaround when `New-AzPortalDashboard` succeeds but the dashboard fails to render with "Dashboard not found" error. This issue is with the underlying REST API and this method provides a reliable alternative.
+
 ## PARAMETERS
 
 ### -DashboardPath