az version --query "azure-cli" should return version number and not throw error

Describe the bug

When I run az version --query "azure-cli" it should return the version number: "2.4.0"

Command Name az version

Errors:

az version: error: argument --query: invalid jmespath_type value: "azure-cli"'

To Reproduce:

Steps to reproduce the behavior. Note that argument values have been redacted, as they may contain sensitive information.

• az version --query "azure-cli"

Expected Behavior

According to the tutorial pages you suggest people use to learn about JMESPath, it should work like this:

I copied the output from a plain az version execution, and selected the field I wanted manually in the online tool.

I would expect az version --query "azure-cli" to perform the same logical function and return 2.4.0

Environment Summary

Windows-10-10.0.17134-SP0
Python 3.6.6
Installer: MSI

azure-cli 2.4.0

Additional Context

[jiasli]

This is the design of JMESPath that - is parsed as minus. See https://github.com/jmespath/jmespath.py/issues/109#issuecomment-240315651.

So in the query azure-cli needs to be quoted as "azure-cli" as you did in the screenshot:

However, since the terminal interprets double quotes, the command needs to be escaped.

In Windows CMD:

>az version --query "\"azure-cli\""
"2.4.0"

In Windows PowerShell (Actually \ shouldn’t be necessary, but we need them here due to https://github.com/PowerShell/PowerShell/issues/1995):

> az version --query '\"azure-cli\"'
"2.4.0"
> az version --query "\`"azure-cli\`""
"2.4.0"

In Bash:

$ az version --query "\"azure-cli\""
"2.4.0"
$ az version --query '"azure-cli"'
"2.4.0"

[jiasli]

@silentbobbert, I added some new contents in the doc. Maybe you are interested: https://github.com/Azure/azure-cli/pull/13249/files#diff-2f68bb7d55730e192dc93f133467a721R162-R175