Is there an existing issue for this?

• I have searched the existing issues

Problem statement

Currently, documentation for "Table migration commands" does not specify what to do when azure-cli has already been installed and authenticated, but auth_type is not being picked up by UCX. A proposed solution was accepted in a previous issue #1249

Proposed Solution

Update documentation under "Table migration commands" heading to indicate the following:

If Azure CLI has already been installed and authenticated but you see the following error when running table migration commands:

14:50:33 ERROR [d.labs.ucx] In order to obtain AAD token, Please run azure cli to authenticate.

Resolve this in MacOS by running the command with an explicit auth type set: DATABRICKS_AUTH_TYPE=azure-cli databricks labs ucx .... To resolve this issue in Windows, proceed with the following steps:

1. Open %userprofile% (the path like C:\Users)
2. Open .databrickscfg
3. Change the profile definition by setting auth_type=azure-cli
4. Save, close the file, re-run databricks labs ucx ...

Additional Context

No response