Repository navigation
appservice plan create defaults to Linux but Windows examples omit --is-linux false #33821
Description
Activity
Thank you for opening this issue, we will look into it.
We should keep linux as default just fix the help samples
Bug Analysis
Command:
az appservice plan create
Module:appservice
Issue: The help text examples claim omitting--is-linuxcreates a Windows plan, but the actual default is Linux (--is-linuxdefaults totrue). An App Service plan OS cannot be changed after creation, so users silently get the wrong OS.Root cause: The
_help.pyexamples forappservice plan createwere written when the Windows plan was the default, but the default was later changed to Linux. The examples were not updated to reflect this.Fix required (as confirmed by the issue author):
- Keep Linux as the default (preserve
--is-linuxdefaulting totrue) - Update the help examples in
src/azure-cli/azure/cli/command_modules/appservice/_help.pyso that Windows examples explicitly pass--is-linux false
For example, change:
az appservice plan create -g MyResourceGroup -n MyPlanto:
az appservice plan create -g MyResourceGroup -n MyPlan --is-linux falseAlso update the example description text from "Create a Windows app service plan." to reflect that
--is-linux falseis required for Windows, or relabel the examples as Linux examples.Use this EXACT PR title:
[AppService] Fix #33821:az appservice plan create: fix Windows examples to include --is-linux falsePR title & description format (required)
This repo enforces a PR format (guide). Please author the PR exactly as follows or CI's Check the Format of Pull Request Title and Content will fail.
Use this EXACT PR title (copy verbatim, do not reword):
[AppService] Fix #33821: `az appservice plan create`: fix Windows examples to include --is-linux falseKeep the backticks around the command and the
Fix #33821:prefix. You may only adjust the wording after the command (the final summary) if the fix changes; the[AppService]prefix, issue link, and backticked command must stay.Description — follow the PR template and fill in:
- Link the issue — start the Description with a closing keyword so the PR auto-links and closes it:
Fixes #33821. - Related command — the
az ...command this affects. - Description (mandatory) — why the bug happens, what you changed, and the resulting behavior.
- Testing Guide — example command(s) showing the fix works.
- History Notes — leave the title to drive the history note, or add extra lines in the same format (component in brackets + the command in backticks), e.g.
[AppService] `az <command>`: <note>. - Keep the template checklist and tick the items you've satisfied.
Posted by agent-assist (autonomous bug-fix pipeline).
- Keep Linux as the default (preserve
- linked a pull request that will close this issue{AppService} `az appservice plan create`: Fix Windows plan help examples to include `--is-linux false` #33828
on Aug 1, 2026
Describe the bug
az appservice plan createdefaults to a Linux plan when--is-linuxis omitted, but examples in the same command help state that omitting the flag creates a Windows plan. This silently creates an App Service plan with the opposite OS from the documented examples. An existing plan cannot be converted between Windows and Linux.Related command
Errors
No error is emitted. The create command exits
0, but the resulting plan is Linux:{ "kind": "linux", "name": "<plan-name>" }The raw ARM resource also reports
properties.reserved=true.Issue script & Debug output
Relevant output from
az appservice plan create --help:Examples from the same help output:
The issue is the contradiction between the implemented default and these generated examples. No credentials or resource identifiers are needed to observe the help inconsistency.
Expected behavior
The default behavior and examples should agree. One of the following would avoid silently selecting the wrong OS:
--is-linuxis omitted.--is-linux falseand clearly document the changed default.Environment Summary
Additional context
Workaround:
A repository search found #33180, but that issue concerns
az functionapp plan createignoring an explicit--is-linux false; this report concerns the contradictory default and examples foraz appservice plan create.Suggested assignee: Jordan Selig (@seligj95)