AZDOI 2025.4.3.141

AZDOI

Azure DevOps Inventory .NET Tool – Inventories and documents an Azure DevOps organization by generating a set of Markdown files for the specified organization and saving them to a specified folder.

Example Result

An example of the generated documentation can be viewed here: AZDOI Example Documentation

Installation

Global

dotnet tool install --global AZDOI

Local

dotnet new tool-manifest
dotnet tool install --local AZDOI

Authentication

Authentication via Azure DevOps can be done either with the use of a Person Access Token (PAT) or Azure Entra Id credentials.

Azure Entra Id

By default it'll try authenticate using the DefaultAzureCredential which tries to authorize in the following order based on your environment.

1. EnvironmentCredential
2. WorkloadIdentityCredential
3. ManagedIdentityCredential
4. SharedTokenCacheCredential
5. VisualStudioCredential
6. VisualStudioCodeCredential
7. AzureCliCredential
8. AzurePowerShellCredential
9. AzureDeveloperCliCredential
10. InteractiveBrowserCredential

Commands

Inventory repositories

Usage

azdoi inventory repositories <devopsorg> <outputpath> [OPTIONS]

Example

azdoi inventory repositories MyOrg /path/to/output

Parameters

AZDOI uses the following environment variables for configuration:

Inventory pipelines

Usage

azdoi inventory pipelines <devopsorg> <outputpath> [OPTIONS]

Example

azdoi inventory pipelines MyOrg /path/to/output

Parameters

AZDOI uses the following environment variables for configuration:

Inventory all

Usage

azdoi inventory all <devopsorg> <outputpath> [OPTIONS]

Example

azdoi inventory all MyOrg /path/to/output

Parameters

AZDOI uses the following environment variables for configuration:

Setting environment variables

To set environment variables, use:

Windows (PowerShell)

$env:AZDOI_PAT = "your_token_here"
$env:AZURE_TENANT_ID = "your_tenant_id_here"

Linux/macOS (Bash)

export AZDOI_PAT="your_token_here"
export AZURE_TENANT_ID="your_tenant_id_here"