Frame SysprepHelper Tool¶
Sysprep Helper is a tool designed to simplify the Sysprep process by parsing errors reported by Sysprep and immediately repairing them when possible.
Frame Sysprep Helper can be used in two ways:
As a desktop application for Sysprep testing.
As a console app, used in scenarios where administrators would want to automate Sysprep error-fixing during account publishing.
In case you started Sysprep Helper as a desktop application on your sandbox and Sysprep succeeds, you must reboot your instance.
Automate the Publish Task with Sysprep Helper Tool¶
In use cases where Sysprep needs to be performed during a publish (persistent desktops and stateless, domain-joined instances), the following PowerShell script will be executed:
Sysprep script will perform various cleanup tasks and then execute a final generalization task: Sysprep.exe with appropriate arguments.
The Sysprep.<cloudprovider>.ps1 workflow:
- Start-Process -FilePath "$env:windir\System32\Sysprep\Sysprep.exe" -ArgumentList "/oobe /quit /generalize /unattend:$env:ProgramData\Nutanix\Frame\Sysprep\Unattend.xml" -Wait -NoNewWindow
SysprepHelper.exe tool can be used instead of Sysprep.exe when attempting to automatically resolve issues during Sysprep execution.
Replace applicable script(s).
C:\ProgramData\Nutanix\Frame\Tools\(if application is missing from this folder, generalization during publish will run a standard Sysprep process) Will also be shipped soon.
Add default Sysprep type key in the Windows system registry.
Default Sysprep Type in Registry
If the registry entry is missing or the value is ‘0’, generalization during publish will run the standard Sysprep process.
Frame SysprepHelper logs can be found in: