n4kama / yggdrasil

TUI wrapper for OSDCloud. Also provides an opinionated startup script for WinPE

Yggdrasil - TUI wrapper for OSDCloud

Yggdrasil serves as a TUI wrapper for OSDCloud.

It also provides an opinionated startup script for WinPE.

The opinionated part resides in the fact that it is designed for Autopilot registration of devices.

It also requires a Microsoft application (Application ID, Application secret) to add the device hash to Microsoft Autopilot.

Pre-requisites

Following OSDCloud's documentation :

1. OSDCloud Powershell Module
2. ADK for Windows
3. Windows PE add-on for the ADK

Usage

TUI Wrapper only (recommended)

irm osd.baguet.org | iex

Customized installation

• Clone/Fork the repository.
• Edit $OSDCloudParameters from Install-Windows.ps1 to match your environment.
• Commit and push the changes to your own repository (must be publicly accessible from your environment).
• Copy the URL of the Install-Windows.ps1 raw file from your repository.
• Run .\Prepare-OSDCloudEnv.ps1 in PowerShell.

How OSDCloud works inside of Yggdrasil

sequenceDiagram
  Note over User: Launch PowerShell in administrator mode
  User->>OSDCloud Template: irm osd.baguet.org | iex
  Note over OSDCloud Template: Select the OS language/locale
  Note over OSDCloud Template: Choose weither or not to use WinRE<br/>(Enables wireless support, NOT compatible with virtual machines and older systems)
  OSDCloud Template->>OSDCloud Workspace: Simple copy of the template to a different location
  Note over OSDCloud Workspace: Insert the URL of the customized OSDCloud installation script
  Note over OSDCloud Workspace: (Optional) Select the wallpaper to use
  Note over OSDCloud Workspace: Configure the Autopilot registration application's ID and secret.
  OSDCloud Workspace-)User: 
  Note over User: OSDCloud ISO ready for deployment

Loading

Troubleshooting & Tips

Hyper-V Manager

Access the serial numbers of all virtual machines from the host using :

Get-WmiObject -ComputerName <HOSTNAME> -Namespace root\virtualization\v2 -class Msvm_VirtualSystemSettingData | Where-Object { $_.BIOSSerialNumber -ne $null } | select elementname, BIOSSerialNumber

Pre-provisioning is not possible using Hyper-V because of a TPM attestation issue. See this.