# recastsoftware/recastosdcloud architecture

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

- Interactive diagram: https://gitdiagram.com/recastsoftware/recastosdcloud
- Repository: https://github.com/recastsoftware/recastosdcloud

## Overview

OSDCloud is a PowerShell module for deploying Windows from cloud-hosted OS and driver content, primarily from WinPE. An administrator starts Deploy-OSDCloud, which offers GUI or CLI deployment; the deployment workflow then prepares the target, installs Windows, applies drivers, and finalizes the deployment. The README also documents WinpeStartup utilities, device information, and module updates. Most internal links below are dashed because the sampled source did not show their runtime calls; documented capabilities are retained without asserting unverified wiring.

Main entry points: [`OSDCloud/private/workflow/Invoke-OSDCloudWorkflowTask.ps1`](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/private/workflow/Invoke-OSDCloudWorkflowTask.ps1) (Workflow tasks), [`OSDCloud/public/WinOS/Deploy-OSDCloud.ps1`](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinOS/Deploy-OSDCloud.ps1) (Deploy command), [`OSDCloud/private/steps/4-install`](https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/4-install) (Windows installation), [`OSDCloud/private/steps/5-drivers`](https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/5-drivers) (Driver application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployment["Deployment"]
  node_deploy["Deploy command"]
  node_cli["CLI deployment"]
  node_gui["GUI deployment"]
  node_workflow["Workflow tasks"]
  node_disk["Disk preparation"]
  node_osinstall["Windows installation"]
  node_drivers["Driver application"]
  node_finalize["Finalize deployment"]
end

subgraph group_content["Deployment content"]
  node_oscatalog["OS catalog"]
  node_drivercatalog["Driver catalogs"]
  node_cache[("Core cache")]
end

subgraph group_winpe["WinPE startup"]
  node_startup["WinpeStartup workflow"]
  node_startupmanager["Startup actions"]
  node_wifi["Wi-Fi setup"]
end

subgraph group_utilities["Utilities"]
  node_deviceinfo["Device information"]
  node_moduleupdate["PE module update"]
end

node_admin(("IT administrator"))
node_gallery["PowerShell Gallery"]

node_admin -->|"starts deployment"| node_deploy
node_deploy -->|"offers CLI"| node_cli
node_deploy -->|"offers GUI"| node_gui
node_workflow -.->|"prepares disk"| node_disk
node_workflow -.->|"installs Windows"| node_osinstall
node_workflow -.->|"applies drivers"| node_drivers
node_workflow -.->|"finalizes"| node_finalize
node_osinstall -.->|"uses OS content"| node_oscatalog
node_drivers -.->|"uses driver content"| node_drivercatalog
node_startup -.->|"dispatches actions"| node_startupmanager
node_startupmanager -.->|"can configure Wi-Fi"| node_wifi
node_moduleupdate -->|"updates from"| node_gallery

click node_deploy "https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinOS/Deploy-OSDCloud.ps1"
click node_cli "https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/private/Deploy-OSDCloudCLI.ps1"
click node_gui "https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/private/Deploy-OSDCloudGUI.ps1"
click node_workflow "https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/private/workflow/Invoke-OSDCloudWorkflowTask.ps1"
click node_disk "https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/3-preinstall"
click node_osinstall "https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/4-install"
click node_drivers "https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/5-drivers"
click node_finalize "https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/8-finalize"
click node_oscatalog "https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/core-operatingsystem"
click node_drivercatalog "https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/core-driverpack"
click node_cache "https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/core-cache"
click node_startup "https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinPE/Invoke-WinpeStartup.ps1"
click node_startupmanager "https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinPE/Invoke-WinpeStartupManager.ps1"
click node_wifi "https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/private/WinpeStartup/Invoke-OSDCloudWifi.ps1"
click node_deviceinfo "https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinOS/Show-OSDCloudDeviceInfo.ps1"
click node_moduleupdate "https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinPE/Update-WinpeStartupModule.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_deploy,node_cli,node_gui,node_workflow,node_disk,node_osinstall,node_drivers,node_finalize toneBlue
class node_oscatalog,node_drivercatalog,node_cache toneAmber
class node_startup,node_startupmanager,node_wifi toneMint
class node_deviceinfo,node_moduleupdate toneRose
class node_admin,node_gallery toneIndigo
```

## Components

### Deployment

- [Deploy command](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinOS/Deploy-OSDCloud.ps1): `OSDCloud/public/WinOS/Deploy-OSDCloud.ps1`
- [CLI deployment](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/private/Deploy-OSDCloudCLI.ps1): `OSDCloud/private/Deploy-OSDCloudCLI.ps1`
- [GUI deployment](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/private/Deploy-OSDCloudGUI.ps1): `OSDCloud/private/Deploy-OSDCloudGUI.ps1`
- [Workflow tasks](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/private/workflow/Invoke-OSDCloudWorkflowTask.ps1): `OSDCloud/private/workflow/Invoke-OSDCloudWorkflowTask.ps1`
- [Disk preparation](https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/3-preinstall): `OSDCloud/private/steps/3-preinstall`
- [Windows installation](https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/4-install): `OSDCloud/private/steps/4-install`
- [Driver application](https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/5-drivers): `OSDCloud/private/steps/5-drivers`
- [Finalize deployment](https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/steps/8-finalize): `OSDCloud/private/steps/8-finalize`

### Deployment content

- [OS catalog](https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/core-operatingsystem): `OSDCloud/private/core-operatingsystem`
- [Driver catalogs](https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/core-driverpack): `OSDCloud/private/core-driverpack`
- [Core cache](https://github.com/recastsoftware/recastosdcloud/tree/main/OSDCloud/private/core-cache): `OSDCloud/private/core-cache`

### WinPE startup

- [WinpeStartup workflow](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinPE/Invoke-WinpeStartup.ps1): `OSDCloud/public/WinPE/Invoke-WinpeStartup.ps1`
- [Startup actions](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinPE/Invoke-WinpeStartupManager.ps1): `OSDCloud/public/WinPE/Invoke-WinpeStartupManager.ps1`
- [Wi-Fi setup](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/private/WinpeStartup/Invoke-OSDCloudWifi.ps1): `OSDCloud/private/WinpeStartup/Invoke-OSDCloudWifi.ps1`

### Utilities

- [Device information](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinOS/Show-OSDCloudDeviceInfo.ps1): `OSDCloud/public/WinOS/Show-OSDCloudDeviceInfo.ps1`
- [PE module update](https://github.com/recastsoftware/recastosdcloud/blob/main/OSDCloud/public/WinPE/Update-WinpeStartupModule.ps1): `OSDCloud/public/WinPE/Update-WinpeStartupModule.ps1`

### Other components

- **IT administrator**
- **PowerShell Gallery**

## Connections

- IT administrator → Deploy command: starts deployment (evidence: `README.md`)
- Deploy command → CLI deployment: offers CLI (evidence: `README.md`)
- Deploy command → GUI deployment: offers GUI (evidence: `README.md`)
- Workflow tasks → Disk preparation: prepares disk
- Workflow tasks → Windows installation: installs Windows
- Workflow tasks → Driver application: applies drivers
- Workflow tasks → Finalize deployment: finalizes
- Windows installation → OS catalog: uses OS content
- Driver application → Driver catalogs: uses driver content
- WinpeStartup workflow → Startup actions: dispatches actions
- Startup actions → Wi-Fi setup: can configure Wi-Fi
- PE module update → PowerShell Gallery: updates from (evidence: `README.md`)
