Components (PSImage)

PSImage is not supported by FileWave Support so please do not submit tickets with them about it. The information provided here is for educational purposes only. If you would like to purchase professional services hours for consulting assistance setting up PSImage or customizing it please contact professional.services@filewave.com with your request. If you have existing unused professional services hours you may be able to use them for this purpose. Any feedback on PSImage can also be sent to the same email address. Any work on this would be done on Discord or in working with Professional Services. For the official Windows Imaging solution please see Network Imaging / IVS.

3 Phases of Disk Imaging

image.png


When imaging over the network from the psimage network share there are 3 phases. The above diagram describes what happens during each phase and the info below describes which script is responsible for the actions during each phase.

  1. Pre-imaging (x:\imaging\go.ps1) - Gets connection info from config.ini automatically or prompt user about server hosting SMB share and then connect to it
  2. Imaging (z:\scripts\PSImage.ps1) - Capture or restore disk image
  3. Post-imaging (z:\scripts\runonce.ps1) - Post-imaging actions like setting the computername, installing the FW client, adding client firewall exception, importing a Wi-Fi profile. There are 2 reboots.

Pre-imaging Components in WinPE

boot.wim holds WinPE and is the imaging environment you're booting into to gain full access to the local hard drive. You'll learn how to build boot.wim later in Building Your Imaging Environment. You can also find boot.wim in the sources folder in the WinPE partition of the USB thumb stick, as well as in your reimaging fileset and the WDS server (if you decide to use PXE). To edit it you must mount the boot.wim WIM image, make your edits, and commit your changes to unmount it. While mounted the contents are mapped to a folder you designate on the local drive. The following files reside in the boot.wim file in the \imaging folder.

Imaging/Post-imaging Components

The following folders are present on the psimage share for network imaging or the secondary Imaging volume on the USB thumb drive for local imaging. These are used during the imaging and post-imaging process. When booted into the WinPE imaging environment the psimage share or 2ndary volume of your dual-partitioned USB thumb drive is mapped to as the z: drive. WinPE itself is mounted as the x: drive.

Other Misc Items

There are 2 spots with hidden options for troubleshooting. Enter "z" to drop to command line in imaging phase in WinPE at

  1. Main PSImage menu and
  2. When asked to press Return to reboot after successful image capture.

C:\Windows\Temp\restore.done created immediately before last reboot. Use this file in requirement scripts to postpone filesets until post-imaging is complete.

Beginning and ending imaging times are written to registry of reimaged client at HKLM\Software\PSImage.  Name of image used to reimage PC is also written here. Custom field data specified in image_mappings.txt will also be written here if if the client device is reimaged using any other method besides via fileset.

Post-imaging log is written to c:\windows\temp\psimage.log on client device. If you don't end up at login prompt then check here to see where it failed as post-imaging process did not complete.


Revision #9
Created 21 July 2023 15:51:22 by Josh Levitsky
Updated 21 July 2023 16:33:48 by Josh Levitsky