Skip to content

Update devops.md: ADXAdminCommand@5, YAML samples, and authentication docs#2865

Merged
v-regandowner merged 4 commits intoMicrosoftDocs:mainfrom
tanmaya-panda1:main
Mar 24, 2026
Merged

Update devops.md: ADXAdminCommand@5, YAML samples, and authentication docs#2865
v-regandowner merged 4 commits intoMicrosoftDocs:mainfrom
tanmaya-panda1:main

Conversation

@tanmaya-panda1
Copy link
Contributor

This pull request updates the Azure DevOps documentation for Azure Data Explorer, focusing on improved guidance for release pipeline configuration, expanded YAML pipeline samples, and clearer authentication method recommendations. The changes provide more comprehensive examples, clarify keyless authentication options, and introduce support for Workload Identity Federation (WIF) in the extension.

Pipeline configuration and task usage:

  • Expanded the YAML pipeline configuration section with detailed sample tasks for admin commands, including inline, file-based, and ARM service connection scenarios, and added a table describing key task input parameters for ADXAdminCommand@5.
  • Updated the admin command sample to use the new ADXAdminCommand@5 task and improved parameter clarity, replacing outdated samples and aligning with current best practices.

Authentication guidance:

  • Added notes and recommendations for using Workload Identity Federation (WIF) and Managed Identity for keyless authentication, including explicit mention that Kusto Fabric cluster URLs are not supported for WIF and Managed Identity. [1] [2]
  • Clarified and expanded the authentication methods supported by the extension, emphasizing secure approaches and providing setup references.

Task options and usability:

  • Documented the new option to wait for long-running asynchronous admin commands to complete by polling operation status, improving task reliability for complex deployments.
  • Clarified that the single-line search pattern option supports multiple files when executing admin commands from a local agent folder.

Other updates:

  • Updated the metadata date and made minor editorial improvements for consistency.# Thank you for contributing to Kusto documentation

Please add a brief comment outlining the purpose of this PR. Add links to any relevant references such as DevOps work items.

Make sure you've done the following:

  1. Acrolinx: Make sure your Acrolinx score is at least 80 (higher is better) and with 0 spelling issues.

  2. Successful build: Review the build status to make sure all files are green (Succeeded) and there are no errors, warnings, or suggestions.

  3. Preview the pages: Click each Preview URL link, scan the entire page looking for formatting issues, in particular the parts you edited.

  4. Check the Table of Contents: If you're adding a new markdown file, make sure it is linked from the table of contents.

  5. Sign off: Once the PR is finalized, add a comment with #sign-off . If you need to cancel the sign-off, add a comment with #hold-off.

    NOTE: Signing off means the document can be published at any time.

Next steps

  • All PRs to this repository are reviewed and merged by a human. Automatic merge is disabled on this repository for PRs, even with the qualifies-for-auto-merge label.
  • Once all feedback on the PR is addressed, the PR will be merged into the main branch.

Learn more about how to contribute

Copilot AI and others added 4 commits March 24, 2026 06:56
…and authentication docs

Co-authored-by: tanmaya-panda1 <108695755+tanmaya-panda1@users.noreply.github.com>
Agent-Logs-Url: https://github.com/tanmaya-panda1/dataexplorer-docs/sessions/58cf6e05-fc1d-4c2c-9ede-f8aa815826d7
…F version note, async wait option

Co-authored-by: tanmaya-panda1 <108695755+tanmaya-panda1@users.noreply.github.com>
Agent-Logs-Url: https://github.com/tanmaya-panda1/dataexplorer-docs/sessions/82016769-bd92-45b8-a4ca-c4232cf39f80
…task-versions

Update devops.md: ADXAdminCommand@5, YAML samples, and authentication docs
@prmerger-automator
Copy link
Contributor

@tanmaya-panda1 : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@prmerger-automator
Copy link
Contributor

@tanmaya-panda1 : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 4d19d1d:

✅ Validation status: passed

File Status Preview URL Details
data-explorer/devops.md ✅Succeeded

For more details, please refer to the build report.

@prmerger-automator
Copy link
Contributor

PRMerger Results

Issue Description
File Change Percent This PR contains file(s) with more than 30% file change.

@ttorble
Copy link
Contributor

ttorble commented Mar 24, 2026

@spelluru

Can you review the proposed changes?

IMPORTANT: When the changes are ready for publication, adding a #sign-off comment is the best way to signal that the PR is ready for the review team to merge.

#label:"aq-pr-triaged"
@MicrosoftDocs/public-repo-pr-review-team

@prmerger-automator prmerger-automator bot added the aq-pr-triaged tracking label for the PR review team label Mar 24, 2026
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Azure Data Explorer Azure DevOps documentation to reflect newer task versions and provide clearer guidance for YAML pipelines and keyless authentication options.

Changes:

  • Refreshes authentication guidance, including WIF/Managed Identity notes and recommendations.
  • Expands the YAML pipeline section with ADXAdminCommand@5 examples and a task input parameter table.
  • Updates task version references (notably admin command and query tasks) and adds guidance for long-running async admin commands.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Contributor

@spelluru spelluru left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tanmaya-panda1 - Please use the private repo next time (by adding -pr to dataexplorer-docs (dataexplorer-docs-pr in the URL before editing the file). I can send you instructions on getting access to the private repo. Thanks.

@spelluru
Copy link
Contributor

#sign-off

@v-regandowner v-regandowner merged commit a5b99dc into MicrosoftDocs:main Mar 24, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants