OSDCloud

Twitter LinkedIn GitHub PowerShell Gallery
Search…
OSDCloud
March 10, 2021
What is OSDCloud?
Its a way to image a computer or Virtual Machine by booting to WinPE and pulling everything from the Cloud ... that's it.  Windows 10 will require 4GB and Drivers will consume between 1-2GB
Requirements
WinPE
PowerShell support (from ADK)
cURL (from Windows 10 1803+)
PowerShell Gallery
Tested on WinPE from Windows 10 20H2
Supported Hardware (for now)
Dell
Microsoft Hyper-V
Boot Device
USB for Physical
ISO for Virtual
Ethernet
Internet
Open
Untested with Proxy or Firewall
PowerShell Modules
OSD
OSDSUS
PackageManagement
PowerShellGet
GitHub Repository
WinPE
Hopefully you know how to create WinPE, you can use your existing one if you must, or you can easily create one with OSDBuilder 21.3.9+
PowerShell
You can add this from the ADK.  If you are not sure how to do this, then OSDCloud may be a bit out of reach for now
cURL Support
Starting with Windows 10 1803, cURL.exe and Tar.exe were included.  These need to be injected into your WinPE wim at Windows\System32.  If you are using OSDBuilder 21.3.9+, then these files are copied automatically into an AutoExtraFiles directory
You can add these to WinPE by creating a New-PEBuildTask and adding the -WinPEAutoExtraFiles parameter
1
New-PEBuildTask -SourceWim WinRE -TaskName OSDCloud -CustomName OSDCloud -WinPEAutoExtraFiles
Copied!
PowerShell Gallery support
If you have the OSD PowerShell Module 21.3.9+ installed, then you can enable it by reading this link
Enable-PEWimPSGallery
OSD
And that's it.  While you can add the OSD PowerShell Module to WinPE, you can also do this in WinPE since you will have the PowerShell Gallery working, and you get the latest version
Boot to WinPE
So hopefully you have WinPE working, so make sure it is connected to the Internet and give it a boot
Install-Module OSD
Now you will need to install the OSD PowerShell Module as much of the dependencies are in here.  This is no problem since you have a working PowerShell Gallery!
Start-OSDCloud
By default, Start-OSCloud will launch in my OSDCloud Repository.  Feel free to Clone or make your own, but you can just use mine for testing
My OSDCloud Repository should only be used as an example on how to configure one.  I am still working on adding some things, so things may change at any time and I am not responsible for you messing your stuff up, so there's that!
GitHub - OSDeploy/OSDCloud: OSDCloud is a process to fully deploy a Windows OS from a WinPE Environment
GitHub
You have some parameters you can use with Start-OSDCloud to get you going.  Let's say your GitHub UserName is SlackDaddy2021.  If so, this would be your command
1
Start-OSDCloud -GitHubUser 'SlackDaddy2021'
Copied!
Here is the details ... its really just a simple script
Now press Enter and you should see a crude menu
If you don't get the menu, and get some PowerShell errors, its more than likely you don't have an open Internet connection
I have things broken down to test individual parts of my script, but I recommend you type ENT (or EDU or PRO) and press Enter
Disk Preparation
After enabling the High Performance Power Plan, you will be prompted to Clear-LocalDisk and create a New-OSDisk.  All 3 of these steps are completed with functions from the OSD Module
Update-MyDellBIOS
Well this isn't working for now, but it does download to X:\Windows\Temp ... 
Download Windows 10 ESD
To find the download URL's for Windows 10, the script will install the OSDSUS PowerShell Module and do a query for the links.  You can obviously configure this to do whatever Edition and Language that you need in your own GitHub Repository.  cURL will be used to download the ESD to C:\OSDCloud\ESD
Expand Windows 10 ESD
Once the ESD has downloaded, the proper Index will be expanded to C:\ and the System Partition will be prepared
Save-MyDellDriverCab
This is another function in the OSD PowerShell Module.  It will match the proper Dell Driver Pack for your computer and download it using cURL to C:\Drivers and it will be expanded
Apply Drivers using Unattend offlineServicing
OSDCloud will drop an Unattend.xml and then apply it to add the Drivers to the offline Windows 10.  This step will take some time.  When complete, you can validate the oem Drivers in C:\Windows\Inf
1
<?xml version="1.0" encoding="utf-8"?>
2
<unattend xmlns="urn:schemas-microsoft-com:unattend">
3
    <settings pass="offlineServicing">
4
        <component name="Microsoft-Windows-PnpCustomizationsNonWinPE" processorArchitecture="amd64" publicKeyToken="31bf3856ad364e35" language="neutral" versionScope="nonSxS" xmlns:wcm="http://schemas.microsoft.com/WMIConfig/2002/State" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
5
            <DriverPaths>
6
                <PathAndCredentials wcm:keyValue="1" wcm:action="add">
7
                    <Path>C:\Drivers</Path>
8
                </PathAndCredentials>
9
            </DriverPaths>
10
        </component>
11
    </settings>
12
</unattend>
Copied!
Complete
After the Drivers have been applied, the WinPE phase is complete.  You can reboot and proceed to OOBE
Time = 6 Minutes
I made an effort to not mention anything about how long it takes to complete OSDCloud, but if you look at the screenshots above, you will see that the Start Time is shown for each section.  I am running this from home with a 600MB connection, so YMMV on this one.  The entire process took about 6 Minutes, with 1 Minute to download the ESD, less than 1 Minute to download and expand the Dell Driver Pack, and 2.5 Minutes to apply the Drivers offline
1
23:43:18	Start
2
23:43:55	Download Windows 10 ESD (4GB)
3
23:44:54	Expand Windows 10 ESD
4
23:46:07	Download and Expand Dell Drivers (1.5GB)
5
23:46:56	Apply Drivers
6
23:49:29	Complete
Copied!
Next Steps
I'll keep working on the script.  My next steps are to use Save-Module to add all the AutoPilot stuff into the OS.  Its also possible to inject an AutoPilotConfiguration.json, but that will come in the next day or two.
Your next step is to make a WinPE with PowerShell and PowerShell Gallery support!