# microsoft/ari architecture

> Architecture diagram of the GitHub repository microsoft/ari, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/microsoft/ari
- Repository: https://github.com/microsoft/ari

## Overview

ARI is a PowerShell module for read-only Azure environment inventory, producing Excel reports and interactive diagrams. The documented user flow starts at Invoke-ARI, which accepts tenant and scope options, collects Azure data, and generates the selected outputs. Optional branches include Security Center, Advisor, Policy, and cost data; automation is also documented. The README establishes these product capabilities, but the provided source excerpts do not expose implementation calls between stages, so those links are marked unverified rather than presented as observed control flow.

Main entry points: [`Modules/Public/PublicFunctions/Invoke-ARI.ps1`](https://github.com/microsoft/ari/blob/main/Modules/Public/PublicFunctions/Invoke-ARI.ps1) (Invoke ARI), [`Modules/Private/1.ExtractionFunctions/Get-ARISubscriptions.ps1`](https://github.com/microsoft/ari/blob/main/Modules/Private/1.ExtractionFunctions/Get-ARISubscriptions.ps1) (Tenant and scope), [`Modules/Public/InventoryModules`](https://github.com/microsoft/ari/tree/main/Modules/Public/InventoryModules) (Resource inventory), [`Modules/Public/PublicFunctions/Diagram/Start-ARIDiagramNetwork.ps1`](https://github.com/microsoft/ari/blob/main/Modules/Public/PublicFunctions/Diagram/Start-ARIDiagramNetwork.ps1) (Network diagrams)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User entry"]
  node_invoke["Invoke ARI<br/>[Invoke-ARI.ps1]"]
end

subgraph group_inventory["Azure inventory"]
  node_scope["Tenant and scope"]
  node_resourceinventory["Resource inventory"]
  node_managementgroups["Management groups"]
  node_costs["Cost inventory"]
  node_vmextras["VM details<br/>[ResourceDetails]"]
end

subgraph group_analysis["Analysis features"]
  node_advisory["Advisor data"]
  node_policy["Policy data"]
  node_security["Security Center"]
end

subgraph group_outputs["Reports and diagrams"]
  node_excel["Excel report"]
  node_reportextras["Extra reports"]
  node_networkdiagram["Network diagrams"]
  node_orgdiagram["Organization diagrams"]
  node_drawio["Draw.io output"]
end

node_user(("ARI user"))
node_azure[("Azure environment")]
node_automation["Automation Account"]

node_user -->|"runs"| node_invoke
node_invoke -.->|"accepts scope"| node_scope
node_scope -.->|"selects subscriptions"| node_azure
node_invoke -.->|"collects resources"| node_resourceinventory
node_resourceinventory -.->|"reads resources"| node_azure
node_invoke -.->|"supports scope"| node_managementgroups
node_invoke -.->|"optionally collects"| node_costs
node_invoke -.->|"optionally collects"| node_vmextras
node_invoke -.->|"optionally collects"| node_advisory
node_invoke -.->|"optionally collects"| node_policy
node_invoke -.->|"optionally collects"| node_security
node_invoke -.->|"generates report"| node_excel
node_invoke -.->|"generates reports"| node_reportextras
node_invoke -.->|"generates diagrams"| node_networkdiagram
node_invoke -.->|"offers view"| node_orgdiagram
node_networkdiagram -.->|"exports interactive maps"| node_drawio
node_automation -.->|"runs automatically"| node_invoke

click node_invoke "https://github.com/microsoft/ari/blob/main/Modules/Public/PublicFunctions/Invoke-ARI.ps1"
click node_scope "https://github.com/microsoft/ari/blob/main/Modules/Private/1.ExtractionFunctions/Get-ARISubscriptions.ps1"
click node_resourceinventory "https://github.com/microsoft/ari/tree/main/Modules/Public/InventoryModules"
click node_managementgroups "https://github.com/microsoft/ari/blob/main/Modules/Private/1.ExtractionFunctions/Get-ARIManagementGroups.ps1"
click node_costs "https://github.com/microsoft/ari/blob/main/Modules/Private/1.ExtractionFunctions/Get-ARICostInventory.ps1"
click node_vmextras "https://github.com/microsoft/ari/tree/main/Modules/Private/1.ExtractionFunctions/ResourceDetails"
click node_advisory "https://github.com/microsoft/ari/blob/main/Modules/Private/2.ProcessingFunctions/Invoke-ARIAdvisoryJob.ps1"
click node_policy "https://github.com/microsoft/ari/blob/main/Modules/Private/2.ProcessingFunctions/Invoke-ARIPolicyJob.ps1"
click node_security "https://github.com/microsoft/ari/blob/main/Modules/Private/2.ProcessingFunctions/Invoke-ARISecurityCenterJob.ps1"
click node_excel "https://github.com/microsoft/ari/blob/main/Modules/Private/3.ReportingFunctions/Start-ARIExcelJob.ps1"
click node_reportextras "https://github.com/microsoft/ari/blob/main/Modules/Private/3.ReportingFunctions/Start-ARIExtraReports.ps1"
click node_networkdiagram "https://github.com/microsoft/ari/blob/main/Modules/Public/PublicFunctions/Diagram/Start-ARIDiagramNetwork.ps1"
click node_orgdiagram "https://github.com/microsoft/ari/blob/main/Modules/Public/PublicFunctions/Diagram/Start-ARIDiagramOrganization.ps1"
click node_drawio "https://github.com/microsoft/ari/blob/main/Modules/Private/2.ProcessingFunctions/Invoke-ARIDrawIOJob.ps1"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_invoke,node_user toneBlue
class node_scope,node_resourceinventory,node_managementgroups,node_costs,node_vmextras,node_azure toneAmber
class node_advisory,node_policy,node_security toneMint
class node_excel,node_reportextras,node_networkdiagram,node_orgdiagram,node_drawio toneRose
class node_automation toneIndigo
```

## Components

### User entry

- [Invoke ARI](https://github.com/microsoft/ari/blob/main/Modules/Public/PublicFunctions/Invoke-ARI.ps1): `Modules/Public/PublicFunctions/Invoke-ARI.ps1`

### Azure inventory

- [Tenant and scope](https://github.com/microsoft/ari/blob/main/Modules/Private/1.ExtractionFunctions/Get-ARISubscriptions.ps1): `Modules/Private/1.ExtractionFunctions/Get-ARISubscriptions.ps1`
- [Resource inventory](https://github.com/microsoft/ari/tree/main/Modules/Public/InventoryModules): `Modules/Public/InventoryModules`
- [Management groups](https://github.com/microsoft/ari/blob/main/Modules/Private/1.ExtractionFunctions/Get-ARIManagementGroups.ps1): `Modules/Private/1.ExtractionFunctions/Get-ARIManagementGroups.ps1`
- [Cost inventory](https://github.com/microsoft/ari/blob/main/Modules/Private/1.ExtractionFunctions/Get-ARICostInventory.ps1): `Modules/Private/1.ExtractionFunctions/Get-ARICostInventory.ps1`
- [VM details](https://github.com/microsoft/ari/tree/main/Modules/Private/1.ExtractionFunctions/ResourceDetails): `Modules/Private/1.ExtractionFunctions/ResourceDetails`

### Analysis features

- [Advisor data](https://github.com/microsoft/ari/blob/main/Modules/Private/2.ProcessingFunctions/Invoke-ARIAdvisoryJob.ps1): `Modules/Private/2.ProcessingFunctions/Invoke-ARIAdvisoryJob.ps1`
- [Policy data](https://github.com/microsoft/ari/blob/main/Modules/Private/2.ProcessingFunctions/Invoke-ARIPolicyJob.ps1): `Modules/Private/2.ProcessingFunctions/Invoke-ARIPolicyJob.ps1`
- [Security Center](https://github.com/microsoft/ari/blob/main/Modules/Private/2.ProcessingFunctions/Invoke-ARISecurityCenterJob.ps1): `Modules/Private/2.ProcessingFunctions/Invoke-ARISecurityCenterJob.ps1`

### Reports and diagrams

- [Excel report](https://github.com/microsoft/ari/blob/main/Modules/Private/3.ReportingFunctions/Start-ARIExcelJob.ps1): `Modules/Private/3.ReportingFunctions/Start-ARIExcelJob.ps1`
- [Extra reports](https://github.com/microsoft/ari/blob/main/Modules/Private/3.ReportingFunctions/Start-ARIExtraReports.ps1): `Modules/Private/3.ReportingFunctions/Start-ARIExtraReports.ps1`
- [Network diagrams](https://github.com/microsoft/ari/blob/main/Modules/Public/PublicFunctions/Diagram/Start-ARIDiagramNetwork.ps1): `Modules/Public/PublicFunctions/Diagram/Start-ARIDiagramNetwork.ps1`
- [Organization diagrams](https://github.com/microsoft/ari/blob/main/Modules/Public/PublicFunctions/Diagram/Start-ARIDiagramOrganization.ps1): `Modules/Public/PublicFunctions/Diagram/Start-ARIDiagramOrganization.ps1`
- [Draw.io output](https://github.com/microsoft/ari/blob/main/Modules/Private/2.ProcessingFunctions/Invoke-ARIDrawIOJob.ps1): `Modules/Private/2.ProcessingFunctions/Invoke-ARIDrawIOJob.ps1`

### Other components

- **ARI user**
- **Azure environment**
- **Automation Account**

## Connections

- ARI user → Invoke ARI: runs (evidence: `README.md`)
- Invoke ARI → Tenant and scope: accepts scope
- Tenant and scope → Azure environment: selects subscriptions
- Invoke ARI → Resource inventory: collects resources
- Resource inventory → Azure environment: reads resources
- Invoke ARI → Management groups: supports scope
- Invoke ARI → Cost inventory: optionally collects
- Invoke ARI → VM details: optionally collects
- Invoke ARI → Advisor data: optionally collects
- Invoke ARI → Policy data: optionally collects
- Invoke ARI → Security Center: optionally collects (evidence: `README.md`)
- Invoke ARI → Excel report: generates report (evidence: `README.md`)
- Invoke ARI → Extra reports: generates reports
- Invoke ARI → Network diagrams: generates diagrams (evidence: `README.md`)
- Invoke ARI → Organization diagrams: offers view (evidence: `README.md`)
- Network diagrams → Draw.io output: exports interactive maps (evidence: `README.md`)
- Automation Account → Invoke ARI: runs automatically (evidence: `README.md`)
