How to Configure Windows Sandbox, Custom WSB Scripts, and Network Isolation in Windows 11

Security researchers, systems engineers, and power users frequently need to execute untrusted binaries, inspect suspect email attachments, or test unstable build scripts without endangering their host operating system. Provisioning full virtual machines via traditional hypervisors (such as VMware Workstation or VirtualBox) requires considerable storage overhead, manual Windows licensing, and sluggish boot times.

Windows 11 addresses this through Windows Sandbox, a lightweight disposable desktop environment built on Microsoft Hyper-V container technology. Utilizing dynamic base imaging and direct memory management, Windows Sandbox boots in seconds and guarantees complete state disposal upon closure. By leveraging custom .wsb (Windows Sandbox Configuration) XML scripts, administrators can enforce strict network isolation, map read-only host folders, control virtual GPU allocation, and automate startup software installations.


Architectural Overview: Hyper-V Containerization and Dynamic Base Imaging

Unlike standard virtual machines that require dedicated virtual hard disks (VHDX) consuming 20 to 50 GB of storage, Windows Sandbox operates atop a Dynamic Base Image. The Hyper-V container manager mounts the immutable, clean system binaries already residing on your host Windows installation (C:\Windows\System32), redirecting any modified or newly written files into an isolated copy-on-write memory buffer.

Architecture Metric Traditional Hyper-V VM Windows Sandbox (.wsb) WSL 2 Container
Disk Footprint 20 GB – 60 GB dedicated VHDX ~100 MB delta allocation Variable virtual ext4 disk
Lifecycle & Persistence Persistent across reboots Disposable; discarded upon window close Persistent distribution state
Host Binaries Sharing Independent guest OS install Direct read-only mapping of host binaries Independent Linux kernel & userland
Cold Boot Latency 25 – 45 seconds 3 – 8 seconds 1 – 3 seconds
Isolation Boundary Hardware-level hypervisor boundary Containerized hypervisor utility VM Hypervisor VM with shared Plan 9 mounts

Every time you close Windows Sandbox, the entire containerized instance—including downloaded malware, temporary files, modified registry hives, and registry run keys—is eradicated from volatile memory.


Enabling Windows Sandbox Prerequisites in Windows 11

Windows Sandbox requires Windows 11 Pro, Enterprise, or Education editions with hardware virtualisation active in the motherboard UEFI/BIOS.

Open an elevated PowerShell prompt (Run as Administrator) to verify hardware virtualisation and install the optional feature package:

# Verify hypervisor and virtualization capabilities
Get-ComputerInfo -Property "HyperVisorPresent", "DeviceGuardSecurityServicesConfigured"

# Enable Windows Sandbox optional feature
Enable-WindowsOptionalFeature -Online -FeatureName "Containers-DisposableClientVM" -All -NoRestart

If PowerShell reports that a reboot is required, restart your computer before launching the sandbox.


Engineering Custom WSB Configuration Files

Double-clicking the standard Windows Sandbox icon launches a default instance with internet connectivity and shared clipboard access. To enforce defensive isolation or automated testing, construct custom .wsb XML scripts.

Configuration Tags and Schema Reference

XML Directive Tag Permitted Values Operational Security Impact
<VGpu> Disable, Default Disabling vGPU blocks sandbox access to physical GPU drivers, mitigating graphics driver escape vulnerabilities.
<Networking> Disable, Default Setting to Disable enforces total air-gap isolation; prevents malware command-and-control (C2) beaconing.
<MappedFolder> Host folder path Passes directory into Sandbox. <ReadOnly>true</ReadOnly> prevents guest processes from tampering with host files.
<LogonCommand> Command string Executes batch commands or PowerShell scripts automatically upon sandbox desktop initialization.
<AudioInput> Disable, Enable Prevents microphone eavesdropping by untrusted applications.
<VideoInput> Disable, Enable Blocks virtual webcam access inside the guest.
<ProtectedClient> Enable, Disable Hardens the RDP connection session by stripping clipboard and peripheral redirect channels.
<MemoryInMB> Integer (e.g. 4096) Caps volatile RAM allocation to prevent denial-of-service fork bombs from freezing the host workstation.

Implementation Profiles: Air-Gapped vs Automated Staging

Profile 1: Fully Air-Gapped Malware Analysis Sandbox

This profile severs all network communication, disables microphone and webcam input, blocks GPU driver access, and exposes a host diagnostic folder strictly in read-only mode.

Create a file named MalwareAnalysis.wsb using a text editor:

<Configuration>
  <VGpu>Disable</VGpu>
  <Networking>Disable</Networking>
  <AudioInput>Disable</AudioInput>
  <VideoInput>Disable</VideoInput>
  <ProtectedClient>Enable</ProtectedClient>
  <MemoryInMB>4096</MemoryInMB>
  <MappedFolders>
    <MappedFolder>
      <HostFolder>C:\SecOps\AnalysisTools</HostFolder>
      <SandboxFolder>C:\Users\WDAGUtilityAccount\Desktop\Tools</SandboxFolder>
      <ReadOnly>true</ReadOnly>
    </MappedFolder>
  </MappedFolders>
</Configuration>

Note on Guest Username: In all Windows Sandbox instances, the default active guest account identifier is universally named WDAGUtilityAccount (Windows Defender Application Guard Utility Account).

Profile 2: Automated Developer Testing Staging Sandbox

This profile retains network access, enables GPU hardware acceleration, mounts a working source repository, and runs an automated PowerShell bootstrap script upon boot:

Create a file named DevStaging.wsb:

<Configuration>
  <VGpu>Default</VGpu>
  <Networking>Default</Networking>
  <MemoryInMB>8192</MemoryInMB>
  <MappedFolders>
    <MappedFolder>
      <HostFolder>C:\Development\ProjectStaging</HostFolder>
      <SandboxFolder>C:\Users\WDAGUtilityAccount\Desktop\Project</SandboxFolder>
      <ReadOnly>false</ReadOnly>
    </MappedFolder>
  </MappedFolders>
  <LogonCommand>
    <Command>powershell.exe -ExecutionPolicy Bypass -NoExit -Command "Set-Location 'C:\Users\WDAGUtilityAccount\Desktop\Project'; Write-Host 'Windows Sandbox Developer Environment Initialised.' -ForegroundColor Green"</Command>
  </LogonCommand>
</Configuration>

Double-clicking either .wsb file automatically boots an isolated Windows Sandbox instance configured according to the defined XML parameters.


Troubleshooting Common Windows Sandbox Faults

Observed Error Underlying Cause Remediation Procedure
Launch failure: Error 0x80070002 (The system cannot find the file specified) Corrupted base dynamic image or conflicting Windows update service Open an elevated command prompt. Execute dism /online /cleanup-image /restorehealth followed by sfc /scannow. Reboot host.
Launch failure: Error 0x80370102 (Virtual machine could not be started) Hardware virtualization or SLAT disabled in UEFI BIOS Enter motherboard firmware settings and enable Intel VT-x or AMD SVM. In Windows, ensure the Windows Hypervisor Platform optional feature is active.
LogonCommand fails to run PowerShell scripts silently ExecutionPolicy restrictions blocking unsigned scripts in fresh VM Always prefix PowerShell commands within <Command> with powershell.exe -ExecutionPolicy Bypass -File [path].
Sandbox displays black screen when launched with vGPU enabled Host graphics driver incompatibility with Hyper-V vGPU partitioner Update physical graphics card drivers (Nvidia/AMD/Intel). In the .wsb file, set <VGpu>Disable</VGpu> as a fallback diagnostic.

Security Best Practices for Sandboxed Environments

  • Never Map Sensitive Host Volumes with Write Privileges: When analyzing suspected ransomware or file infectors, never set <ReadOnly>false</ReadOnly> on mapped folders. Write access enables malicious processes to encrypt or poison host staging directories.
  • Enforce Air-Gap Isolation by Default: Disabling network access guarantees that zero telemetry, authentication tokens, or local network shares (SMB) can be scanned or probed by untrusted binaries.
  • Treat Sandbox as a Containment Boundary, Not Invulnerability: While sandbox escapes are exceptionally rare, sophisticated zero-day kernel exploits could theoretically bridge hypervisor boundaries. Maintain defense-in-depth on the host operating system with current security patches.

Get the best tech tips delivered straight to your inbox.

Join thousands of readers mastering Apple, Google, Microsoft, and Linux.