From 6ecbe9b0cf364a56b9ae14745a596f464c2e4934 Mon Sep 17 00:00:00 2001 From: ThioJoe <12518330+ThioJoe@users.noreply.github.com> Date: Mon, 4 Aug 2025 18:46:02 -0700 Subject: [PATCH] Update README.md - Add instructions for SandboxStartup.ps1 --- README.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/README.md b/README.md index 179c75b..2891a1a 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,18 @@ # Windows-Sandbox-Tools Various useful scripts for use within Windows Sandbox + +--------- + +## Using `SandboxStartup.ps1` +The script is written assuming it will be run from _within_ the sandbox, so to automatically run it you'll need to put it into a mapped shared folder. + +1. Create some new folder location (not in the sandbox) which you'll map into the sandbox. It doesn't matter what it's called or where it goes, but maybe something like `C:\Users\WhateverUsername\MySharedSandboxFolder` +2. In this repo I have the [`MyDefaultSandbox.wsb`](Sandbox%20Configurations/MyDefaultSandbox.wsb) configuration file which is already set up to map the folder to the location the script expects. So in there you just need to update the `` setting to use the path you selected in the previous step. + + For Example: + ``` + C:\Users\WhateverUsername\MySharedSandboxFolder + ``` + +3. Update any other options to your liking in the `.wsb` file, such as amount of RAM. +4. Launch Sandbox using the configuration by double clicking `MyDefaultSandbox.wsb`. It will map the folder to the Desktop as a folder called `HostShared`, and run the script automatically. You can also add other scripts and things to the shared folder you may want to run manually.