Skip to content

A PowerShell utility to facilitate quick automatic configuration of Windows Sandbox.

License

Notifications You must be signed in to change notification settings

oOblik/CustomSandbox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

76 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Latest Version Activity Pull Requests

Do you frequently use Windows Sandbox but are tired of having to install common utilities on every launch?

CustomSandbox is a PowerShell utility to facilitate quick automatic configuration of Windows Sandbox.

Write custom tasks to install software or configure Windows in the sandbox immediately after launch, and selectively choose which tasks to run.

✨ Features

  • Configure the following Windows Sandbox features before launch:
    • Protected Mode
    • Networking
    • vGPU
    • Clipboard
    • Printer Redirection
    • Audio Input
    • Video Input
    • Maximum memory allocated to Windows Sandbox (based on available free memory)
  • Custom configuration / software installation tasks
  • Built-in tasks for installation of the following:
    • 7-Zip
    • AdoptOpen Java JDK
    • AdoptOpen Java JRE
    • Apache OpenOffice
    • [Experimental] Chocolatey - Installs are cached/internalized and can be done with networking disabled.
      • Google Chrome
      • Hex Rays IDA Disassembler (free)
      • Microsoft .NET Framework
      • ShareX
    • Google Chrome
    • HxD Hex Editor
    • ManageEngine MIB Browser
    • Microsoft VS Code
    • Mozilla Firefox
    • Notepad++
    • Sysinternals BGInfo
    • Windows Terminal

Installation tasks pre-download and cache required installation files outside of the sandbox so they can be quickly re-used in successive runs, or installed if networking in the sandbox is disabled.

✅ Requirements

Enable Windows Sandbox on Windows

⚠️ DISCLAIMER: CustomSandbox has been tested with Windows 11 22H2 and PowerShell 5.1. While it should work from Windows 10 1903 or later, your results may vary.

💻 Installation / Usage

You can clone the repository with git:

git clone https://github.com/oOblik/CustomSandbox.git

Or, download and extract with PowerShell.

Invoke-WebRequest 'https://github.com/oOblik/CustomSandbox/releases/latest/download/CustomSandbox.zip' -OutFile .\CustomSandbox.zip
Expand-Archive .\CustomSandbox.zip .\
Remove-Item .\CustomSandbox.zip
cd CustomSandbox

# Optional (only if needed)
Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
Get-ChildItem -Recurse *.ps1 | Unblock-File

# Launch
.\CustomSandbox.ps1

📸 Screenshots





➕ Contributing

Found a bug or want a new feature? You can open a new Issue here.

📝 License

Licensed under the MIT license.

About

A PowerShell utility to facilitate quick automatic configuration of Windows Sandbox.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published