Azure CLI is not Azure Cloud

[skrabbe001]

Type of issue

Other (describe below)

Feedback

When documenting Azure CLI you MUST separate the cloud based from the local command based stuff.

That means that the first authentication method is NOT Azure CLI - it is Azure Cloud:

Azure Cloud Shell - Azure Cloud Shell automatically logs you in and is the easiest way to get started.

Almost all of your documentation confuses the two methods of doing stuff, ie locally (az) vs using the cloud (browser + powershell syntax).

What I do not understand, is why you can not implement the same syntax for both cloud and local usage AND why you in most articles refer to the the cloud based (Azure Cloud Powershell) as Azure CLI - it makes it extremely time consuming to find the right article OR to figure out which Azuyre CLI az command that corresponds with which Azure Cloud PowerShell command.

As I see it, your entire documentation needs a rewrite.

Page URL

https://learn.microsoft.com/en-us/cli/azure/authenticate-azure-cli

Content source URL

https://github.com/MicrosoftDocs/azure-docs-cli/blob/main/docs-ref-conceptual/authenticate-azure-cli.md

Author

@dbradish-microsoft

Document Id

1155045b-ce8c-2def-7b0e-043283f8be01

[skrabbe001]

If you look at this page, it lists some of the commands. We need a page containing all commands for all extensions:

https://learn.microsoft.com/en-us/cli/azure/choose-the-right-azure-command-line-tool

And we need all pages to list both methods OR inform us of if only one of the methods work AND inform us of if it can only be done in the GUI AND inform us of subtle differences that result of doing it in the GUI vs the CLI.