Azure / azure-cli

Azure Command-Line Interface
MIT License
4.03k stars 3.01k forks source link

Customer feedback | az sf cluster setting | UUF - missing example | azDO 317849 #30015

Open dbradish-microsoft opened 1 month ago

dbradish-microsoft commented 1 month ago

Describe the bug

This GitHub issue is being moved from UUF azDO work item 317849.

Engineering request

Thank you for providing a JSON example in --settings-section --settings-section-description parameter description. Please add a second example to az sf cluster setting remove and az sf cluster setting set that shows the use of the --settings-section parameter being passed as a file.

See Azure CLI reference guidelines for reference content example requirements.

Customer feedback

Verbatim: Would be helpful if you provided examples of how to load parameters from a file. "Use @{file} to load from a file." does not provide enough clarity. Do I use Get-Content first? -Raw? Unsure how to do this to apply multiple settings for one section.

Verbatim Id: 5783dbcd-af7b-ef11-a670-6045bd037be1

Live URL: https://learn.microsoft.com/en-us/cli/azure/sf/cluster/setting

GitHub URL: https://github.com/MicrosoftDocs/azure-docs-cli/blob/live/latest/docs-ref-autogen/sf/cluster/setting.yml

Related command

az sf cluster setting

Errors

n/a

Issue script & Debug output

n/a

Expected behavior

n/a

Environment Summary

Azure CLI 2.64.0

Additional context

No response

yonzhan commented 1 month ago

Thank you for opening this issue, we will look into it.

dbradish-microsoft commented 1 month ago

We are routing this to the appropriate team for follow-up. cc @mwesigwaguma, @a-Santamaria, @LukeSlev, @jkochhar