Azure DevOps Admin

Azure DevOps Admin

Shared Workflow Routing

• Use the shared workflow spec for deterministic multi-plugin routing: workflows/multi-plugin-workflows.md.

Overview

Azure DevOps administration covers security, governance, integration, and observability. Security namespaces define granular ACL-based permissions for every resource type (repos, pipelines, areas, iterations). Dashboards aggregate project health via configurable widgets. Wikis provide documentation as code. Service hooks enable event-driven integrations with external systems.

Analytics OData provides rich querying across work items, pipelines, and test results for Power BI dashboards and trend analysis. The Azure DevOps CLI (az devops) offers a complete command-line interface. Extensions from the Visual Studio Marketplace add custom functionality.

REST API — Security

Key Security Namespace GUIDs

REST API — Dashboards

REST API — Wikis

REST API — Service Hooks

REST API — Extensions

REST API — Artifacts

Analytics OData

Endpoint: https://analytics.dev.azure.com/{org}/{project}/_odata/v4.0-preview/

Key entity sets: WorkItems, WorkItemRevisions, PipelineRuns, TestRuns, TestResults, TestResultsDaily.

Query operators: $filter, $select, $expand, $orderby, $top, $apply (for aggregations).

Azure DevOps CLI

# Install
az extension add --name azure-devops

# Configure defaults
az devops configure --defaults organization=https://dev.azure.com/{org} project={project}

# Key command groups
az repos list / create / show
az repos pr create / list / update / complete
az pipelines list / show / run / create
az boards work-item create / show / update
az artifacts universal publish / download

# Escape hatch for any REST API
az devops invoke --area git --resource repositories --api-version 7.1

Best Practices

• Use security namespaces for granular permission control — avoid broad group assignments.
• Configure service hooks for real-time notifications to Teams/Slack channels.
• Create project wikis for living documentation; use code wikis for API docs.
• Use ETag-based concurrency for wiki page updates to prevent lost edits.
• Build custom dashboards per team with sprint burndown, build health, and test trend widgets.
• Use Analytics OData for Power BI dashboards — narrow filters and use $select for performance.
• Prefer az devops CLI for scripting over raw REST API calls.
• Review extension permissions before installing — extensions can access project data.

Progressive Disclosure — Reference Files