AZDOI 2025.3.18.29

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.

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:

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"