[Doc]: Add-AzApplicationGatewaySslCertificate example omits required Set-AzApplicationGateway to persist changes

Open Beginner friendly

#28,974 opened on Dec 12, 2025 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty: 1/5
Estimated time: Under an hour
Newbie friendliness: 76/100

Issue type: Documentation
Clarity: Clearly specified
Activity status: Quiet
Tech stack: azure, powershell
Domain: documentation

Research direction

Open src/Network/Network/help/Add-AzApplicationGatewaySslCertificate.md and review the existing example for the certificate workflow. Add the required persistence step using Set-AzApplicationGateway -ApplicationGateway $AppGW, then verify the rendered example clearly shows that the change is saved to Azure.

Written by the indexing model from the issue text.

Description

act-quality-productivity-squad customer-reported Network - Application Gateway Possible-Solution Service Attention Similar-Issue

Type of issue

Other (describe below)

Feedback

The current example shows how to add an SSL certificate to an Application Gateway by updating the in-memory object returned by Get-AzApplicationGateway and then calling Add-AzApplicationGatewaySslCertificate. However, it does not demonstrate the final step needed to persist those changes back to the Azure resource.
Without calling Set-AzApplicationGateway -ApplicationGateway $AppGW (or Update-AzApplicationGateway in some patterns), users may assume the change is applied, but the certificate is not actually pushed to the Application Gateway.

# Persist the change to Azure (required)
Set-AzApplicationGateway -ApplicationGateway $AppGW

Page URL

https://learn.microsoft.com/en-us/powershell/module/az.network/add-azapplicationgatewaysslcertificate?view=azps-15.1.0&viewFallbackFrom=azps-14.1.0

Content source URL

https://github.com/Azure/azure-powershell/blob/main/src/Network/Network/help/Add-AzApplicationGatewaySslCertificate.md

Author

@mikefrobbins

Document Id

d9014bc0-dbaa-ad6f-bb29-f30fe3c2a3bd

Platform Id

805a1f56-1b93-78c3-7724-9427da6332a5

Dominant language: C#
Stars: 4.8k
Forks: 4.3k
Avg merge: 3d 21h
Merged PRs (30d): 49

Contributor guide

Open the contributing guide

First steps

Read the whole issue, then the project's contributing guide.
Comment on the issue to say you are picking it up — it saves two people doing the same work.
Fork the repository and make your change on a branch.
Open a pull request that references the issue number.

Similar issues

[quality-improver] Repository Quality: AzureFoundry Extension Missing from Self-Registration Acceptance Test Open

type/automation type/tech-debt

Difficulty 2/5 1-3 hours Newbie friendliness 78/100

microsoft/testfx#11431 · Opened Sep 21, 2026
[Bug]: Composite `ui screenshot` success output ignores `--quiet` Open

bug

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

microsoft/winappCli#914 · Opened Sep 21, 2026
GeometryHelper.FlattenArc / FlattenCubicBezier / FlattenQuadraticBezier emit a NaN point when the segment count truncates to 0 (0/0) — a Path with a sub-pixel arc fail-fasts Windows with D2DERR_BAD_NUMBER (root cause of #8512, #13757) Open

t/bug

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

dotnet/maui#38751 · 1 reaction · Opened Sep 21, 2026
[CI Failure] Flaky: MauiBuildQueueTests.CancelQueuedResource_CompletesGracefullyAndDoesNotAcquireSemaphore asserts exact exception type but sometimes gets TaskCanceledException instead of OperationCanceledException Open

ci-failure-cause test-failure

Difficulty 2/5 1-3 hours Newbie friendliness 82/100

microsoft/aspire#20284 · Opened Sep 21, 2026
The login flow's text-link submit is 42 px tall on a narrow screen; its docblock says 44 Open

area:auth FE mvp P3

Difficulty 2/5 1-3 hours Newbie friendliness 88/100

klasolsson81/jobbliggaren#1788 · Opened Sep 21, 2026

More C# issues