Minor change required in the text of the intro paragraph.

Document Details

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

• ID: fe1526a9-7f22-504e-484c-0f3edc11b178
• Version Independent ID: c5dec108-efcd-aa77-04b5-803b6b894dba
• Content
• Content Source
• Service: multiple

Hi,

I'm trying my hand at azcli. Great examples on JMEPath queries, I had no idea this was a thing!
In the example --query "[].{VMName:name, OSType:storageProfile.osDisk.osType}" I needed to add an extra space behind the comma to get it to work... That worked for me... Just thought I'd drop a line letting you know...

Rg./Irwin

I get this message after trying to az login.
after getting the code, i enter it in the specified link. then i need to login with my Azure User and finally i get this error and cannot move forward to work with Azure CLI.

I didn't find anything online regarding this error
please assist.

Document Details

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

• ID: 1c268a98-afcb-d2c2-87c7-880d52900533
• Version Independent ID: 4c835da4-38bc-22a8-67b4-dd522adcc0e3
• Content: Get started with Azure CLI 2.0
• Content Source: docs-ref-conceptual/get-started-with-azure-cli.md
• Service: multiple
• GitHub Login: @sptramer
• Microsoft Alias: sttramer

Moving from Azure/azure-cli#6029
Originally submitted by @NightFantomJ2

It took 2 minutes for this page to load, most of which was loading "menucss/" (1.5min TTFB).

Document Details
⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.
ID: e99d25ff-03e2-e015-37f4-a29b59ec50d4
Version Independent ID: 1a8e88ed-72c7-fbe7-b0ad-68f23b3946cd
Content: az ad sp
Content Source: src/command_modules/azure-cli-role/azure/cli/command_modules/role/_help.py
Service: active-directory
GitHub Login: @rloutlaw
Microsoft Alias: routlaw

I'm learning...

Document Details

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

• ID: 8246b90a-efb1-03ce-f642-d3eb2441fc30
• Version Independent ID: 2fdd20ef-7bd3-57bc-7957-93f4bb5377ce
• Content
• Content Source
• Service: multiple

Upstream distribution information resides in /etc/upstream-release/lsb-release

The first line of the installation script could be modified to:

AZ_REPO=$(lsb_release -cs)
if [ -f /etc/upstream-release/lsb-release ]
then
. /etc/upstream-release/lsb-release
AZ_REPO=$DISTRIB_CODENAME
fi

Document Details

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

• ID: fe1526a9-7f22-504e-484c-0f3edc11b178
• Version Independent ID: c5dec108-efcd-aa77-04b5-803b6b894dba
• Content
• Content Source
• Service: multiple

The latest version mentioned in this page is 2.0.25 but the installer button in https://docs.microsoft.com/en-us/cli/azure/install-azure-cli-windows?view=azure-cli-latest page shows "2.0.26" and it fails to download

Document Details

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

• ID: c0e8d9ef-f25b-bb46-7f1a-bd3588be3343
• Version Independent ID: cd392600-a90d-0145-5ea6-6b01ab8f4ab9
• Content
• Content Source
• Service: multiple

az login -u -p

Is it correct to have the password as a direct input? This may lead to unintentional password leak!

Document Details

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

• ID: 93174b3a-3e97-8304-83fc-807be75198fe
• Version Independent ID: 1155045b-ce8c-2def-7b0e-043283f8be01
• Content: Log in with Azure CLI 2.0
• Content Source: docs-ref-conceptual/authenticate-azure-cli.md
• Service: multiple
• GitHub Login: @sptramer
• Microsoft Alias: sttramer

Is there a resource somewhere that tells you what the meaning of the various properties in the JSON output are? For example, what's the difference between 'provisioningState' and 'status'?

Document Details

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

• ID: 48273ba7-da5a-95f0-7ffc-8c6d5282313d
• Version Independent ID: 83d348f9-fd1f-1041-0304-d8634e5526d4
• Content
• Content Source
• Service: multiple

I get scared when I find an article like this for something that looks exactly like what I need - but there's no date anywhere.
So I have no idea if it's 5 years old and now obsolete - or the latest and greatest way to manage my Azure account.

Document Details

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

• ID: 8246b90a-efb1-03ce-f642-d3eb2441fc30
• Version Independent ID: 2fdd20ef-7bd3-57bc-7957-93f4bb5377ce
• Content
• Content Source
• Service: multiple

The az configure --defaults description and example is not correct, directing users to use extraneous quotes.
az configure --help is correct in it's examples where the key=value pairs are not in one quoted string.

Using azure-cli-2.0.29,
az configure --defaults "location=westus2 group=MyResourceGroup"
results in
$ cat ~/.azure/config
[defaults]
location = westus2 group=MyResourceGroup

where as,
az configure --defaults location=westus2 group=MyResourceGroup
results in
$ cat ~/.azure/config
[defaults]
location = westus2
group = MyResourceGroup

Document Details

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

• ID: fb42002e-9aa3-233d-9832-353235b7cd0f
• Version Independent ID: e8b320b1-5805-67ba-46b2-48111861facc
• Content: Azure CLI configuration options
• Content Source: docs-ref-conceptual/azure-cli-configuration.md
• Service: multiple
• GitHub Login: @sptramer
• Microsoft Alias: sttramer

Windows 10
Python 3.6.4
pip. 9.0.9

Traceback (most recent call last):
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\knack\cli.py", line 194, in invoke
cmd_result = self.invocation.execute(args)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\azure\cli\core\commands_init_.py", line 342, in execute
six.reraise(*sys.exc_info())
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\six.py", line 693, in reraise
raise value
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\azure\cli\core\commands_init_.py", line 315, in execute
result = cmd(params)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\azure\cli\core\commands_init_.py", line 175, in call
return super(AzCliCommand, self).call(*args, **kwargs)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\knack\commands.py", line 109, in call
return self.handler(*args, **kwargs)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\azure\cli\core_init_.py", line 349, in default_command_handler
result = op(**command_args)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\azure\cli\command_modules\profile\custom.py", line 134, in login
allow_no_subscriptions=allow_no_subscriptions)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\azure\cli\core_profile.py", line 137, in find_subscriptions_on_login
tenant, self._ad_resource_uri)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\azure\cli\core_profile.py", line 679, in find_through_interactive_flow
code = context.acquire_user_code(resource, _CLIENT_ID)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\adal\authentication_context.py", line 250, in acquire_user_code
return code_request.get_user_code_info(language)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\adal\code_request.py", line 66, in get_user_code_info
return self._get_user_code_info(oauth_parameters)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\adal\code_request.py", line 46, in _get_user_code_info
return client.get_user_code_info(oauth_parameters)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\adal\oauth2_client.py", line 301, in get_user_code_info
timeout=self._call_context.get('timeout', None))
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\requests\api.py", line 112, in post
return request('post', url, data=data, json=json, **kwargs)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\requests\api.py", line 58, in request
return session.request(method=method, url=url, **kwargs)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\requests\sessions.py", line 508, in request
resp = self.send(prep, **send_kwargs)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\requests\sessions.py", line 618, in send
r = adapter.send(request, **kwargs)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\requests\adapters.py", line 440, in send
timeout=timeout
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\urllib3\connectionpool.py", line 601, in urlopen
chunked=chunked)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\urllib3\connectionpool.py", line 346, in _make_request
self._validate_conn(conn)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\urllib3\connectionpool.py", line 850, in validate_conn
conn.connect()
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\urllib3\connection.py", line 326, in connect
ssl_context=context)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\urllib3\util\ssl.py", line 313, in ssl_wrap_socket
context.load_verify_locations(ca_certs, ca_cert_dir)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\urllib3\contrib\pyopenssl.py", line 416, in load_verify_locations
self._ctx.load_verify_locations(cafile, capath)
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\OpenSSL\SSL.py", line 775, in load_verify_locations
_raise_current_error()
File "C:\Program Files (x86)\Microsoft SDKs\Azure\CLI2\lib\site-packages\OpenSSL_util.py", line 54, in exception_from_error_queue
raise exception_type(errors)
OpenSSL.SSL.Error: []

Porting this over from azure-cli repo Azure/azure-cli#5471

Can you please add link to documentation on how to opt-in to download invoices via azure CLI?

Can there be an command in Azure CLI to opt-in?. It looks like going through UI pages again to opt-in seems like extra work

cc @sethusrinivasan

Document Details

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

• ID: 8866b243-5c18-7e9a-f233-0033d0eb64f9
• Version Independent ID: c98a81e3-ec68-5819-4a8f-897043f97371
• Content
• Content Source
• Service: unspecified

I noticed strange behavior using Firefox on two different machines while downloading the .msi file from https://aka.ms/InstallAzureCliWindows. It is a redirect to an Azure blob storage which will fail the first 3 times serving the file as download. The fourth time it will download after all.

Document Details

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

• ID: 8b7bd326-07b2-caaa-7155-5852fc2dfa3f
• Version Independent ID: c44d0547-d5cd-8934-00f8-79e2f4df53ac
• Content
• Content Source
• Service: multiple

az --version

Document Details

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

• ID: b233e045-b444-e6d9-7893-36a72ee4a70b
• Version Independent ID: f2c47d3a-4976-ebe4-e732-e7c18dd4bed8
• Content
• Content Source
• Service: multiple

I ran the command-line as instructed above to create a UbuntuLTS VM in westus2 and got an error message similar to the following:

"error": {
"code": "SkuNotAvailable",
"message": "The requested size for resource '/subscriptions/<big_hex_num>/resourceGroups/MyWestus2ResourceGroup/providers/Microsoft.Compute/virtualMachines/MyLinuxVM' is currently not available in location 'westus2' zones '' for subscription '< big_hex_num>'. Please try another size or deploy to a different location or zones

It would be really nice if the instructions in this "hello world" tutorial worked seamlessly.

Document Details

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

• ID: 1c268a98-afcb-d2c2-87c7-880d52900533
• Version Independent ID: 4c835da4-38bc-22a8-67b4-dd522adcc0e3
• Content
• Content Source
• Service: multiple

While walking through this information on our public documentation on creating NSG rules using PowerShell:
https://docs.microsoft.com/en-us/azure/hdinsight/hdinsight-extend-hadoop-virtual-network?toc=%2Fen-us%2Fazure%2Fhdinsight%2Fstorm%2FTOC.json&bc=%2Fen-us%2Fazure%2Fbread%2Ftoc.json#azure-powershell

I’ve found a small bug in the code on the very last line:

$vnet | Set-AzureRmVirtual Network

Should be

$vnet | Set-AzureRmVirtualNetwork

Document Details

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

• ID: 93174b3a-3e97-8304-83fc-807be75198fe
• Version Independent ID: 1155045b-ce8c-2def-7b0e-043283f8be01
• Content: Log in with Azure CLI 2.0
• Content Source: docs-ref-conceptual/authenticate-azure-cli.md
• Service: multiple
• GitHub Login: @sptramer
• Microsoft Alias: sttramer

Currently, install recommends Python 3.5.
https://docs.microsoft.com/en-us/cli/azure/install-azure-cli#windows

Would suggest Python 3.6 as 3.6 has a fix for the MAX_PATH limitation on Windows.
https://docs.python.org/3/using/windows.html#removing-the-max-path-limitation

Usage of --sdk-auth for service principal generation is missing.

Usage of output from previous as CLI credentials is missing. Otoh CLI itself has no such a feature.

Document Details

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

• ID: a3f84bdc-9ed0-eb85-f3af-9711e8083a95
• Version Independent ID: 03a47d06-5fbf-4764-0882-99cd8bd41110
• Content
• Content Source

Currently, most resources only have create, update, delete, show, list...
Adding an upsert (Update Or Insert) option will be beneficial from DevOps Automation using cli, it would reduce coding where in developer first has to check if resource exists then then implement either insert or update operation

Document Details

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

• ID: b233e045-b444-e6d9-7893-36a72ee4a70b
• Version Independent ID: f2c47d3a-4976-ebe4-e732-e7c18dd4bed8
• Content
• Content Source
• Service: multiple

'ssh' is not recognized as an internal or external command,
operable program or batch file.

Should show Bash rather than Azure CLI for the SSH command following az vm create example. Would also be good to reference other supported clients for Windows.

Document Details

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

• ID: 1c268a98-afcb-d2c2-87c7-880d52900533
• Version Independent ID: 4c835da4-38bc-22a8-67b4-dd522adcc0e3
• Content
• Content Source
• Service: multiple

Are there any special considerations with -o table that I should be aware of? Why does this not return any results?

az vm list --query "[].{id:id}" -o table

Yet this does:

az vm list --query "[].{id:id}" -o json

Document Details

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

• ID: 48273ba7-da5a-95f0-7ffc-8c6d5282313d
• Version Independent ID: 83d348f9-fd1f-1041-0304-d8634e5526d4
• Content
• Content Source
• Service: multiple

Am getting this error:

gpg: keyserver receive failed: No dirmngr

Document Details

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

• ID: 8b7bd326-07b2-caaa-7155-5852fc2dfa3f
• Version Independent ID: c44d0547-d5cd-8934-00f8-79e2f4df53ac
• Content
• Content Source
• Service: multiple

As a CSP partner I have access to several client tenancies - each having multiple subscriptions. When I list subscriptions I only get those in my own default tenancy. Is there a cli option to change tenants? Or is my only option to auth using tenant admin of respective client tenancy?

Document Details

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

• ID: 21632cd2-aec0-1521-a9b0-f96f69ab15ed
• Version Independent ID: d6ab81e8-1aba-b922-9984-4523386c83cf
• Content
• Content Source
• Service: multiple

I'm trying to add the azurecli to a dockerfile I already have (since I have other dependencies using the default is not an option)

Our firewall blocks port 11371 and we don't have an https proxy we can use to get past it and our IT team does not like opening ports to the internet.

I'm not sure why you require the use of apt-key here when other repos like https://packages.microsoft.com/repos/microsoft-ubuntu-xenial-prod xenial main allow you to curl down the key, see docs here:
https://docs.microsoft.com/en-us/azure/storage/common/storage-use-azcopy-linux

I thought that the key in that link would work, but it does not.

==> Summary
🍺  /usr/local/Cellar/sqlite/3.22.0: 11 files, 3MB
==> Installing azure-cli dependency: xz
==> Downloading https://homebrew.bintray.com/bottles/xz-5.2.3.high_sierra.bottle
######################################################################## 100.0%
==> Pouring xz-5.2.3.high_sierra.bottle.tar.gz
🍺  /usr/local/Cellar/xz/5.2.3: 92 files, 1.4MB
==> Installing azure-cli dependency: python
==> Downloading https://homebrew.bintray.com/bottles/python-3.6.4_4.high_sierra.
######################################################################## 100.0%
==> Pouring python-3.6.4_4.high_sierra.bottle.tar.gz
Error: An unexpected error occurred during the `brew link` step
The formula built, but is not symlinked into /usr/local
Permission denied @ dir_s_mkdir - /usr/local/Frameworks
Error: Permission denied @ dir_s_mkdir - /usr/local/Frameworks
ce-mbp-dev:ndlon-website celiyah$ az
-bash: az: command not found

Document Details

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

• ID: d09ed623-c83f-6bae-639e-a5f9a31fe3bb
• Version Independent ID: c5d0d722-aacd-47a3-3fcf-982c02c4d0e9
• Content: Install the Azure CLI for macOS
• Content Source: docs-ref-conceptual/install-azure-cli-macos.md
• Service: multiple
• GitHub Login: @sptramer
• Microsoft Alias: sttramer

As you may be aware, a Chocolatey Community Member has created a Chocolatey Package for the Azure CLI. This makes it easy to install it on a Windows machine using:

choco install azure-cli

In the same way that it is recommended to install on say a Mac using:

brew install azure-cli

Would someone in this team be interested in taking ownership of that package to ensure that it is kept up to date with new releases?

Would you accept a PR to add this information to the install section of the docs for Windows?

➜ ~ az login
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code XXXXXXXX to authenticate.
Authentication failed. The 'Authorization' header is provided in an invalid format.
➜ ~ az --version
azure-cli (2.0.30)

Wouldn’t the uservoice feedback channel for Azure CLI be a better destination for product feedback? Currently, the product feedback link is https://github.com/Azure/azure-cli

should be
https://docs.microsoft.com/en-us/cli/azure/reference-index

Document Details

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

• ID: b233e045-b444-e6d9-7893-36a72ee4a70b
• Version Independent ID: f2c47d3a-4976-ebe4-e732-e7c18dd4bed8
• Content
• Content Source
• Service: multiple

Hi, It would be great if we have installer w/o using Admin access laptops.

Document Details

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

• ID: 8246b90a-efb1-03ce-f642-d3eb2441fc30
• Version Independent ID: 2fdd20ef-7bd3-57bc-7957-93f4bb5377ce
• Content: Install the Azure CLI for Windows
• Content Source: docs-ref-conceptual/install-azure-cli-windows.md
• Service: multiple
• GitHub Login: @sptramer
• Microsoft Alias: sttramer

Why have the check-update? If the azure-cli requires something it will grab the update as part of the yum install or yum update command. yum check-update will just list other available updates on the system.

Document Details

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

• ID: f9f55d23-7802-e0da-6d12-b71f6da8a1d4
• Version Independent ID: 192846d7-baae-bcba-698b-22bdcdae468a
• Content
• Content Source
• Service: multiple

Work on Azure/azure-cli#3720 has led to additional .deb packages, which should be pulled based on the user's local system. There is now a new step in apt installation that needs to be updated:

export AZ_REPO=$(lsb_release -cs)
echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ $AZ_REPO main" | sudo tee /etc/apt/sources.list.d/azure-cli.list

I believe Version 2.0.25 should be January 2018, not 2017 :)

Document Details

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

• ID: c0e8d9ef-f25b-bb46-7f1a-bd3588be3343
• Version Independent ID: cd392600-a90d-0145-5ea6-6b01ab8f4ab9
• Content
• Content Source
• Service: multiple

The parameter for logging in with the service principal uses --user-name. The value passed into that parameter is actually the application Id.

This is super confusing. I understand re-using parameters that already exist for simplicity, but in this case it actively lead to me fumbling around searching for my service principal's non-existant username for a long while.

In hindsight, I can see that the docs are clear about using the appId. But my starting situation only half matched this article's starting state. In my case I already had a service principal that I was looking at in the portal. So logically I skipped the sections about creating the SP and getting details about it. And went straight into the login portion. And that part doesn't directly correlate the '-u' flag to the appId. I have to figure that out by process of elimination.

Long story short: why not '--service-principal-name'?

Also, along the same lines; the portal lists what constitutes the 'password' as a 'Key'. The terminology should be consistent across management tools.

Document Details

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

• ID: b11fa31b-582b-7d4f-9a64-60b29da29565
• Version Independent ID: 03a47d06-5fbf-4764-0882-99cd8bd41110
• Content
• Content Source

The example given here is missing quotes in the query

az vm list --query [*].[name, resourceGroup] --out table

and should be

az vm list --query "[*].[name, resourceGroup]" --out table

I prefer to maintain these files as package rather than arrange them manually by following instructions here.
Could you please consider to provide such RPM to install GPG public key and .repo files?
(I made an experimental RPM SPEC to accomplish this: https://github.com/ssato/misc/blob/master/rpmspecs/azure-cli-repos.spec)

If so, instructions will become much simple such like the following:

• install: yum install -y the_repo_rpm_url (or dnf install -y ...)
• uninstall: yum remove -y the_repo_rpm_name
• remove gpg public key: sudo rpm -e $(rpm -qa gpg-pubkey* --qf "%{v}-%{r} %{summary}\n" | awk '/Microsoft/ { print "gpg-pubkey-"$1; }')

Document Details

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

• ID: f9f55d23-7802-e0da-6d12-b71f6da8a1d4
• Version Independent ID: 192846d7-baae-bcba-698b-22bdcdae468a
• Content: Install the Azure CLI 2.0 on Linux with yum | Microsoft Docs
• Content Source: docs-ref-conceptual/install-azure-cli-yum.md
• Service: multiple
• GitHub Login: @sptramer
• Microsoft Alias: sttramer

Hi,

I wanted to check my understanding of how the --name flag is meant to be used for create-for-rbac.

Doc in question Create an Azure service principal with Azure CLI 2.0.

The example begins by looking up the appId for MyDemoWebApp:

az ad app list --display-name MyDemoWebApp
{
    "appId": "a487e0c1-82af-47d9-9a0b-af184eb87646d",
     ...
}

The creates a service principal, passing appId as the name:

az ad sp create-for-rbac --name {appId} --password "{strong password}" 
{
  "appId": "a487e0c1-82af-47d9-9a0b-af184eb87646d",
  "displayName": "MyDemoWebApp",
  "name": "http://MyDemoWebApp",
  ...
}

Expected output of create-for-rbac command would be closer to:

{
  "appId": "<NEW_APP_ID>",
  "displayName": "a487e0c1-82af-47d9-9a0b-af184eb87646d",
  "name": "http://a487e0c1-82af-47d9-9a0b-af184eb87646d",
  ...
}

CLI docs and Azure/azure-cli#1698 seem to imply --name is used for display name / app URI.

1. Should this example be updated?
2. What is the correct method to associated a service principal and existing AD application (similar to what the example currently appears to be demonstrating)?

Thanks

I visited the Azure CLI 2.0 overview page today at:
https://docs.microsoft.com/en-us/cli/azure/overview

I wanted to check out the Web Apps samples near the bottom of the page, but when clicking the link, I received a 404 page saying the page could not be found.

This is the link shown when hovering over the link in a browser:
https://docs.microsoft.com/en-us/azure/app-service/app-service-cli-samples?toc=%2fcli%2fazure%2ftoc.json&bc=%2fcli%2fazure%2fbreadcrumb%2ftoc.json

I think this link has been changed to:
https://docs.microsoft.com/en-us/azure/app-service-web/app-service-cli-samples?toc=%2fcli%2fazure%2ftoc.json&bc=%2fcli%2fazure%2fbreadcrumb%2ftoc.json

It might be easier to see the change by comparing across forks:
master...SpaceShot:patch-1

I came over to the GitHub repo to see if I can figure out how to fix and contribute, so I am figuring out how to build the docs and test locally, but have not tested this and would want to do so before submitting a pull request.

Would it make sense, since python is required and we mention package managers, for this page to recommend installation via pip? pip install --user azure-cli should work.

Document Details

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

• ID: e7895b9a-9a6a-cd98-6947-0e4a26eda9a3
• Version Independent ID: a3f27295-3e2e-a36d-02c2-8897295fc443
• Content
• Content Source
• Service: multiple

I know what version I have, via 'az -v' but I now only know if there's a newer version by downloading the .msi and running it. Stating the latest version number would be useful.

Document details

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

• ID: 8246b90a-efb1-03ce-f642-d3eb2441fc30
• Version Independent ID: 2fdd20ef-7bd3-57bc-7957-93f4bb5377ce
• Content
• Content Source
• Service: multiple

Link titled "Create a storage account using the Azure CLI" points to URL https://docs.microsoft.com/en-us/azure/storage/common/storage-quickstart-create-storage-account-cl which gives me 404. Same with the next link down.

Document Details

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

• ID: 1c268a98-afcb-d2c2-87c7-880d52900533
• Version Independent ID: 4c835da4-38bc-22a8-67b4-dd522adcc0e3
• Content
• Content Source
• Service: multiple

https://docs.microsoft.com/en-us/cli/azure/vm/encryption?view=azure-cli-latest

[AzureDiskEncryption] 9716: [Info] Executing: yum install -y cryptsetup lsscsi psmisc cryptsetup-reencrypt lvm2 uid at patch procps-ng util-linux gcc libffi-devel openssl-devel python-devel
AAzureDiskEncrytion] 9716: [Info] Executing: pip show adal
AzureDiskEncrAzureDiskEncryption] 9716: [Info] Command pip show adal failed with return code 1
stdout:
stderr:
You are using pip version 8.1.2, however version 9.0.1 is available.
You should consider upgrading via the 'pip install --upgrade pip' command.
[AzureDiskEncryption] 9716: [Info] Executing: pip install --upgrade six
[AzureDiskEncryption] 9716: [Ino] Executing: pip install adal
[AzureDiskEncryption] 9716: [Info] Data volume /my_data is mounted from /dev/sd1
[AzureDiskEncryption] 9716: [Info] Data volume /my_data2 is mounted from /dev/sdd1
2017/11/20 11:34:03.083512 INFO Event: name=Microsoft.Azure.Security.AzureDiskEncryptionForLinux, op=Install, message=Launch command succeeded: main/handle.py -install, duration=0
2017/11/20 11:34:03.090569 INFO [Microsoft.Azure.Security.AzureDiskEncryptionForLinux-0.1.0.999306] Enable extension [main/handle.py -enable]
[AzureDiskEncrytion] 10117: [Ifo] Enabling exension
[AzureDiskEncryption] 10117: [Ifo] Public settings:
{
    'AADClientCertThumbprint': null, 
    'AADClientID': , 
    'EncryptionOperation': 'EnableEncryptionFormatAll', 
    'KeyEncryptionAlgorithm': 'RSA-OAEP', 
    'KeyEncryptionKeyURL': 'disks.vault.azure.net/keys/testl01/a0f', 
    'KeyVaultURL': '*', 
    'SequenceVersion': '656a0648-d89f-48d7-872b-7403d768ef25', 
    'VolumeType': 'ALL'
}
[AzureDiskEncryption] 10117: [Info] Encryption operation EnableEncryptionFormatAll is not supported
[AzureDiskEncryption] 10117: [Info] Executing: lvs --noheadings --nameprefixes --unquoted -o lv_name,vg_name,lv_kernel_major,lv_kernel_minor
AzureDiskEncryption] 10117: [Info] Data volume /my_data is mounted from /dev/sdc1
[AzureDiskEncryption] 10117: [Info] Data volume /my_data2 is mounted from /dev/sdd1

Hi,

Please include more examples on querying where we can pull data out of results. Here is an example of something I needed (locations where I can deploy VMs):
az provider list --query "[?namespace=='Microsoft.Compute'].[resourceTypes[?resourceType=='virtualMachines'].locations[]]"

The "CLI configuration file" section is wrong. $AZURE_CONFIG_DIR is $HOME/.azure, and the configuration file is $AZURE_CONFIG_DIR/config.

Document Details

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

• ID: fb42002e-9aa3-233d-9832-353235b7cd0f
• Version Independent ID: e8b320b1-5805-67ba-46b2-48111861facc
• Content
• Content Source
• Service: multiple

A couple of times you've used "Azure CLI" when you actually meant "Azure CLI 2.0".
Shouldn't all references to "az" commands be "Azure CLI 2.0"? Inconsistency is confusing for the readers.

Document Details

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

• ID: 006f70d3-a6ca-9f86-0c29-af41a39df5ec
• Version Independent ID: 4c835da4-38bc-22a8-67b4-dd522adcc0e3
• Content
• Content Source

v

Document Details

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

• ID: 32cd802a-7df5-1254-563f-1e08b74e9faa
• Version Independent ID: f03e3841-d341-d61a-6fdb-e8170ea0c360
• Content
• Content Source
• Service: unspecified

Hello,

I would like to translate https://docs.microsoft.com/en-us/cli/azure/install-azure-cli document into Korean (language code: ko_kr).

Actually, I am not too much familiar with Korean translation, but as far as I know, Korean translated documents are stored in: https://github.com/Azure/azure-content-kokr .

Then could you help where I contribute Korean translation? Just making a fork from here and creating a pull request to this repository would be fine?

With many thanks,

/Ian

When will Azure CLI 3.0 come out?

Document Details

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

• ID: 006f70d3-a6ca-9f86-0c29-af41a39df5ec
• Version Independent ID: 4c835da4-38bc-22a8-67b4-dd522adcc0e3
• Content
• Content Source