Fix broken Azure CLI service principal authentication link in reference documentation

[Copilot]

This PR fixes a broken link in the Azure CLI reference documentation that was pointing to a non-existent Databricks documentation page.

Issue: The link /azure/databricks/dev-tools/azure-cli-login-service-principal was returning a 404 error, breaking the user experience when navigating from the Azure CLI reference documentation.

Solution: Replaced the broken external link with the correct internal Azure CLI documentation link /cli/azure/authenticate-azure-cli-service-principal, which points to the existing "Sign into Azure with a service principal using the Azure CLI" documentation within this repository.

Files Changed:

• docs-ref-conceptual/Latest-version/includes/reference-docs-subgroup.md
• docs-ref-conceptual/LTS-version/includes/reference-docs-subgroup.md

Details:

• The broken link was found in the az databricks workspace reference section, line 1465 in both Latest and LTS versions
• The link text "Azure CLI login with a Microsoft Entra ID service principal" remains unchanged as it accurately describes the target content
• The replacement link points to comprehensive Azure CLI service principal authentication documentation that covers the same topic

This change ensures users can successfully navigate to working documentation about Azure CLI service principal authentication instead of encountering a 404 error.

Fixes #5497.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[learn-build-service-prod]

Learn Build status updates of commit 7f4afd6:

⚠️ Validation status: warnings

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[learn-build-service-prod]

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 issues. Other issues are also a high priority. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

[learn-build-service-prod]

Learn Build status updates of commit d77ff2c:

💡 Validation status: suggestions

File	Status	Preview URL	Details
docs-ref-conceptual/Latest-version/includes/reference-docs-subgroup.md	💡Suggestion	View (azure-cli-latest)	Details
docs-ref-conceptual/LTS-version/includes/reference-docs-subgroup.md	💡Suggestion	View (azure-cli-lts || azure-cli-lts-2017-03-09-profile || azure-cli-lts-2018-03-01-hybrid || azure-cli-lts-2019-03-01-hybrid || azure-cli-lts-2020-09-01-hybrid)	Details

docs-ref-conceptual/Latest-version/includes/reference-docs-subgroup.md

• Line 647, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/cli/azure/azurestackhci/image' points to a learn site page that doesn't exist. Check the path or URL and update the link.
• Line 1469, Column 6: [Suggestion: learn-site-link-broken - See documentation] Link '/azure/databricks/dev-tools/azure-cli-login-user' points to a learn site page that doesn't exist. Check the path or URL and update the link.
• Line 1470, Column 6: [Suggestion: learn-site-link-broken - See documentation] Link '/azure/databricks/dev-tools/sp-aad-token' points to a learn site page that doesn't exist. Check the path or URL and update the link.

docs-ref-conceptual/LTS-version/includes/reference-docs-subgroup.md

• Line 647, Column 3: [Suggestion: learn-site-link-broken - See documentation] Link '/cli/azure/azurestackhci/image' points to a learn site page that doesn't exist. Check the path or URL and update the link.
• Line 1469, Column 6: [Suggestion: learn-site-link-broken - See documentation] Link '/azure/databricks/dev-tools/azure-cli-login-user' points to a learn site page that doesn't exist. Check the path or URL and update the link.
• Line 1470, Column 6: [Suggestion: learn-site-link-broken - See documentation] Link '/azure/databricks/dev-tools/sp-aad-token' points to a learn site page that doesn't exist. Check the path or URL and update the link.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[Copilot]

Pull Request Overview

This PR fixes a broken documentation link in the Azure CLI reference documentation. The link was pointing to a non-existent Databricks documentation page and has been replaced with the correct internal Azure CLI documentation link.

• Replaces broken external Databricks link with working internal Azure CLI documentation link
• Updates the same link in both Latest and LTS versions of the documentation
• Maintains the same link text while fixing the underlying URL path

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
docs-ref-conceptual/Latest-version/includes/reference-docs-subgroup.md	Updates broken link to point to correct Azure CLI service principal authentication documentation
docs-ref-conceptual/LTS-version/includes/reference-docs-subgroup.md	Updates broken link to point to correct Azure CLI service principal authentication documentation

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}