Available Packaging Job Parameters
The following list of parameters are available for use on the CLI and in the PackagesFile or DefaultsJSON. CLI usage requires a preceding / (ie, /Name "Some Application v1.0") and usage in a JSON file requires the parameter to be in double quotes (ie, "Name":"Some Application v1.0").
Notes:
-
Be sure to wrap all complex passwords like "&()[]{}^=;!'+,`~ my c0mpl3x PW" and paths that include a space in double quotes.
-
Double quotes cannot be used in passwords or AES secrets.
-
/InstallerArgs
(if any) must be quoted, be the last parameter, and inner quotes must be escaped with \ -
If
/Installer
points to a .msi, then/InstallerArgs
will automatically be set to/i "<installer.msi>" /qn
and/Installer
will implicitly become msiexe.exe, but you can still use/InstallerArgs
to provide additional args in this scenario. -
If multiple paths are provided to network shares, multiple credentials are provided, and they are to the same server then either only use one set of credentials, or make the second reference to the server be via ip.
-
If a PackagesFile contains a parameter already set in DefaultsJSON, PackagesFile wins. If parameter also included on CLI, CLI wins.
-
All parameters are optional except Name, Path, and Installer
Job Parameter | Description |
---|---|
Name |
Package Name *(Required). |
Path |
Target folder where the package(s) will be created *(Required). |
CustomStorageUrl |
Custom S3 service URL or Azure endpoint suffix. |
Installer |
Path of the installer exe to be executed and captured *(Required). |
InstallerArgs |
Installer-specific silent install flags required for proper operation. |
SizeGb |
Package VHDX size. |
Fixed |
Use Fixed VHDX (allocate all space now). |
Test |
Plays back the package after save and takes screenshots. |
PathUsername |
Username used to access the package’s path. |
PathPassword |
Password used to access the package’s path. |
InstallerUsername |
Username used to access the installer’s path. |
InstallerPassword |
Password used to access the installer’s path. |
InstallerExitCode |
Expected installer SUCCESS exit code. |
InstallerTimeoutMs |
How long to wait for an installer to finish before failing the capture. |
PuAddress |
The ProfileUnity Console where new packages will be imported. |
PuUsername |
Username used to access the ProfileUnity Console. |
PuPassword |
Password used to access the ProfileUnity Console. |
NoSystemRestore |
Do not perform a System Restore rollback after capture/extend. |
AltRestoreCmd |
Instead of System Restore, use a rollback script after capture/extend. |
AltRestoreCmdArgs |
Args (if any) needed for the |
WaitAfterInstallerExitsMs |
How long to wait after installation ends before saving the capture. |
DontCopyInstallerLocal |
Run the installer directly from the |
CopyInstallerFolderLocal |
Copies the the folder containing installer files locally before executing |
InstallerFolder |
Path of the folder containing the installer files. |
NoHCCapture |
Do not use high availability capture mode. |
Installer2 |
Path of an additional installer to be executed during the capture. |
Installer10 |
Path of an additional installer to be executed during the capture. Up to 10 installers are supported. |
InstallerArgs2 InstallerArgs10 |
Installer-specific silent install flags required for proper operation. |
InstallerExitCode2 InstallerExitCode10 |
Expected installer exit code used to determine successful installation. |
PreActivationScript |
CMD file to include in package and execute before playback. |
PostActivationScript |
CMD file to include in package and execute after playback. |
PreDeactivationScript |
CMD file to include in package and execute before stopping playback. |
PostDeactivationScript |
CMD file to include in package and execute after stopping playback. |
NoCallToHome |
Do not send job |
PackageVersion |
User specified version to help track package changes. |
DontCreateFlexAppOne |
Do not automatically create a FlexApp One package. |
FlexAppOneCliOverride |
Custom FlexApp One bundler.exe command line arguments. |
DontCaptureUserProfileData |
Do not capture user profile data. |
DontCaptureUserRegistry |
Don’t capture user registry data from HKCU or HKU. |
DontCapture |
Do not capture at all, just install. |
PackagesXml |
Write a copy of package info into the specified packages.xml. |
PuConfiguration |
Replaces an existing package in the specified configuration with the created package. |
PuFilter |
Add created package to flexapp rule with specified filter. |
PuDescription |
Description to use when adding flexapp rule. |
LogPath |
Folder in which to store logs. |
LogLevel |
Logging level – Debug, Info, Warn, Error, Fatal |
MailServer |
SMTP server to use as a relay for job-related emails. |
MailPort |
SMTP port used for |
MailSsl |
Use SSL/TLS when connecting to |
MailUsername |
Username to use for relaying emails through |
MailPassword |
Password to use for relaying emails through |
MailTo |
Email address that should receive job-related emails |
MailFrom |
Email address to show as sender of job-related emails. |
CaptureRetryCount |
Number of times a capture job is attempted when a failure is encountered. |
PrimaryAddress |
Primary Packaging Manager address. |
PrimaryUsername |
Primary Packaging Manager username. |
PrimaryPassword |
Primary Packaging Manager password. |
WaitForDone |
Wait for job to finish and allow job logs to be copied locally. |
Crypto |
Encrypt the user/pass fields contained in the command line w/Aes |
CryptoKey |
AES Encryption Passphrase / Key. |
Notes About Encryption and Log Paths
When adding information into a PackagesFile or DefaultsJSON, you have two encryption options for username and password fields. In any case, users can never see the credentials stored in these files–they can only use them to process primary-client commands. If you do not specify /Crypt
, the default of DpApi
is used.
/Crypto DpApi
is a self-contained, machine-based encryption using Windows Data Protection API. Anyone with access to the machine can utilize (but not see) the credentials without needing an encryption key. Files encrypted with this method cannot be moved to another machine. THIS IS THE DEFAULT!/Crypto Aes
is an AES-based encryption method utilizing a secret key and requires the key to be passed on the command line with/CryptoKey
to utilize (but not see) the credentials. Files encrypted with this method can be shared between different machines as long as the secret key is known./CryptoKey
implies/Crypto Aes
./LogPath
and/LogLevel
used on the CLI apply only to theprimary-client.exe
log for the current command."LogPath"
and"LogLevel"
used within a JSON file apply only to the capture job log on the capture agent. There is no automatic authentication for a UNC-basedLogPath
so the capture agent’s machine account or service account will need “unprompted access” to theLogPath
.