search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.28k stars 21.45k forks source link

Add Azure PowerShell code #110156

Open dcaro opened 1 year ago

dcaro commented 1 year ago

Can we add Azure PowerShell code to keep parity with Azure cli? cc: @Alex-wdy @mikefrobbins

Document Details

⚠ Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

Alex-wdy commented 1 year ago

I took a look at the Tutorial documents of MicrosoftDocs/azure-docs, and most of them basically do not have PS. If we expect all Tutorial documents to add PS examples, what kind of support do we need to provide? Another point is that the CLI may be well-known by the service, so it must be developed first. PS generally lags behind, so there is no way to reflect it in the document at the same time. We want to scan the document every quarter to find out what is not included PS, we hope to support the part of adding PS in a way.

SaibabaBalapur-MSFT commented 1 year ago

@dcaro Thanks for your feedback! We will investigate and update as appropriate.

htaubenfeld commented 1 year ago

@dcaro deploying the Azure Linux Container Host for AKS with Azure Powershell is not a capability that has been developed yet. Therefore, we cannot add that to our documentation.

Alex-wdy commented 1 year ago

Azure Linux Container Host, Azure PowerShell will be released around July 4th, please add after this release, feel free to ask me if you have questions about using the command line.

htaubenfeld commented 11 months ago

@dcaro, as @Alex-wdy mentioned previously, most tutorials in MicrosoftDocs/azure-docs do not have PS but rather use CLI as the example. We plan to just stick with one form of deployment in the tutorial to align with other tutorials. If customers are looking to use PS they can follow our newly added quickstart here: https://learn.microsoft.com/en-us/azure/azure-linux/quickstart-azure-powershell. Therefore, as it stands we will not be adding PS to this tutorial.

alexandair commented 11 months ago

@htaubenfeld It's unfortunate that you come to conclusion that most of tutorials don't have PowerShell examples. The fact that there are more tutorials with CLI examples doesn't mean that that's OK and that customers are happy with the current state. On the contrary, they are complaining all the time that they have a feeling PowerShell is not treated as a first class citizen.

Last year I was involved in bringing PowerShell examples to parity with CLI examples in Azure docs. The feedback I got for "fixing" the docs was a proof that customers and PowerShell community really needed it. If Microsoft provides PowerShell and CLI it should be users' choice to pick a tool and that decision should be supported with the proper documentation that provides examples for both tools.