NomadPackageLocator.exe command-line switches

NomadPackageLocator.exe is used by the Nomad custom task sequence actions, we recommend that these are used to perform the appropriate functions in preference to the command-line, but details are provided here for reference purposes.

It is installed as part of Nomad. It is also available in Nomad OSD tools in order to include in WinPE images so that Nomad can be used in OS Deployments. Please refer to Installing Nomad Branch Tools.

The format of the NomadPackageLocator command-line is:

NomadPackageLocator.exe [options]

Nomad Package Locator general command-line switches

The following table describes the general NomadPackageLocator.exe command-line switches:

Switch	Default value	Description
`Debug`		Enables extra logging.
`FailOverToDP`		Points to the distribution point if the required package cannot be found pre-cached in any local Nomad clients.
`ForceNomadMachine`		Name of a specific Nomad client whose cache you want to use. This prevents `NomadPackageLocator` from polling for a Nomad client whose cache contains the content.
`HideErrorDialog`		Suppresses error messages during the image deployment task sequence for packages that cannot be located in a Nomad cache.
`HTTP`		Uses HTTP to download content if it is not available on the local subnet.
`Port`	1779	Sets the communications port.
`RemoveHttpLocations`		If used on the `NomadPackageLocator.exe` command-line, the HTTP locations will be cleared from the task sequence, ensuring that the content is downloaded from Nomad peers on the local subnet.
`RequireNomad`		If used on the `NomadPackageLocator.exe` command-line, Nomad is used for the referenced packages. If the Nomad Package Locator fails to locate all the referenced packages, it generated an error, which is used to terminate the task sequence.
`Timeout`	3	Maximum wait time (in seconds) between messages. Applies to each package listed in the TS environment.

Nomad Package Locator NMDS command-line switches

The NMDS command are used by the Nomad Peer Backup Assistant (PBA) feature. These commands invoke NomadBranch.exe to do most of the work, however NomadPackageLocator.exe is the recommended command-line interface to use because it uses and sets crucial task sequence variables.

All of the NMDS commands have corresponding custom task sequence action dialogs, and these should be used in preference to creating command line actions.

Switch	Default value	Description
NMDS_COMPLETE		The NMDS_COMPLETE argument is available on the `NomadPackageLocator.exe` (recommended) or `NomadBranch.exe` service argument-line. It indicates that all user data has been copied to the PBA share and the connection can be closed. When run, it disconnects from its associated share and fixes its contents for the duration defined in the Nomad PostCompleteTimeoutHours registry value on the device where the share is hosted. It is only for use within a task sequence.
NMDS_DELETE		The NMDS_DELETE argument is available on the `NomadPackageLocator.exe` (recommended) or `NomadBranch.exe` service argument-line. When run, it deletes the share, contents and user associated with the shared cache. It is only for use in a task sequence.
NMDS_FIND		The NMDS_FIND argument is available on the `NomadPackageLocator.exe` (recommended) or `NomadBranch.exe` service argument-line. When run, it locates and connects to the share associated with it. It is only for use in a task sequence.
NMDS_HA		The NMDS_HA argument is available on the `NomadPackageLocator.exe` (recommended) or `NomadBranch.exe` service argument-line. It creates additional backup copies of the user data that has been copied to the PBA share, so it must be run after the share has been closed using NMDS_COMPLETE. It is only for use within a task sequence.
NMDS_POLL		The NMDS_POLL argument is available on either the `NomadPackageLocator.exe` (recommended) or `NomadBranch.exe` service command-line. When run, it places a request for a network share and size associated with it. It must only be used within a task sequence.