# eng-ahmedbagarad/windows-server-admin-toolkit architecture

> Architecture diagram of the GitHub repository eng-ahmedbagarad/windows-server-admin-toolkit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/eng-ahmedbagarad/windows-server-admin-toolkit
- Repository: https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit

## Overview

This is a PowerShell toolkit for read-only Windows administration: administrators run health, capacity, resource, or network diagnostics and receive results or structured reports. A separate automation path manages a scheduled task that runs health checks and validates generated report formats. Relationships below are based on README documentation; source excerpts were unavailable, so internal calls not documented there are omitted.

Main entry points: [`reports`](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/tree/main/reports) (Report files), [`scripts/Invoke-ScheduledHealthCheck.ps1`](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Invoke-ScheduledHealthCheck.ps1) (Scheduled health check), [`scripts/Get-ServerHealth.ps1`](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Get-ServerHealth.ps1) (Server health), [`scripts/Get-TopResourceConsumers.ps1`](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Get-TopResourceConsumers.ps1) (Resource consumers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_diagnostics["Diagnostics"]
  node_server_health["Server health"]
  node_disk_usage["Disk capacity<br/>[Get-DiskUsage.ps1]"]
  node_resource_consumers["Resource consumers"]
  node_network_diagnostics["Network diagnostics"]
end

subgraph group_automation["Health automation"]
  node_scheduled_check["Scheduled health check"]
  node_task_management["Task management"]
end

subgraph group_outputs["Reports"]
  node_reports["Report files"]
end

node_admin(("IT administrator"))
node_task_scheduler["Windows Task Scheduler"]

node_admin -->|"runs"| node_server_health
node_admin -->|"runs"| node_disk_usage
node_admin -->|"runs"| node_resource_consumers
node_admin -->|"runs"| node_network_diagnostics
node_admin -->|"runs"| node_scheduled_check
node_admin -->|"manages"| node_task_management
node_server_health -->|"exports"| node_reports
node_resource_consumers -->|"exports"| node_reports
node_network_diagnostics -->|"exports"| node_reports
node_scheduled_check -->|"generates and validates"| node_reports
node_task_management -->|"manages task"| node_task_scheduler
node_task_scheduler -->|"runs periodically"| node_scheduled_check

click node_server_health "https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Get-ServerHealth.ps1"
click node_disk_usage "https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Get-DiskUsage.ps1"
click node_resource_consumers "https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Get-TopResourceConsumers.ps1"
click node_network_diagnostics "https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Test-NetworkConnectivity.ps1"
click node_scheduled_check "https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Invoke-ScheduledHealthCheck.ps1"
click node_task_management "https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Manage-HealthCheckTask.ps1"
click node_reports "https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/tree/main/reports"

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_server_health,node_disk_usage,node_resource_consumers,node_network_diagnostics toneBlue
class node_scheduled_check,node_task_management toneAmber
class node_reports toneMint
class node_admin toneIndigo
class node_task_scheduler toneRose
```

## Components

### Diagnostics

- [Server health](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Get-ServerHealth.ps1): `scripts/Get-ServerHealth.ps1`
- [Disk capacity](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Get-DiskUsage.ps1): `scripts/Get-DiskUsage.ps1`
- [Resource consumers](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Get-TopResourceConsumers.ps1): `scripts/Get-TopResourceConsumers.ps1`
- [Network diagnostics](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Test-NetworkConnectivity.ps1): `scripts/Test-NetworkConnectivity.ps1`

### Health automation

- [Scheduled health check](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Invoke-ScheduledHealthCheck.ps1): `scripts/Invoke-ScheduledHealthCheck.ps1`
- [Task management](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/blob/main/scripts/Manage-HealthCheckTask.ps1): `scripts/Manage-HealthCheckTask.ps1`

### Reports

- [Report files](https://github.com/eng-ahmedbagarad/windows-server-admin-toolkit/tree/main/reports): `reports`

### Other components

- **IT administrator**
- **Windows Task Scheduler**

## Connections

- IT administrator → Server health: runs (evidence: `README.md`)
- IT administrator → Disk capacity: runs (evidence: `README.md`)
- IT administrator → Resource consumers: runs (evidence: `README.md`)
- IT administrator → Network diagnostics: runs (evidence: `README.md`)
- IT administrator → Scheduled health check: runs (evidence: `README.md`)
- IT administrator → Task management: manages (evidence: `README.md`)
- Server health → Report files: exports (evidence: `README.md`)
- Resource consumers → Report files: exports (evidence: `README.md`)
- Network diagnostics → Report files: exports (evidence: `README.md`)
- Scheduled health check → Report files: generates and validates (evidence: `README.md`)
- Task management → Windows Task Scheduler: manages task (evidence: `README.md`)
- Windows Task Scheduler → Scheduled health check: runs periodically (evidence: `README.md`)
