For details of how to obtain this utility, please see Installing Nomad tools for operating system deployment.

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. So this documentation is for completeness only.

The format of the NomadPackageLocator command-line is as follows:

NomadPackageLocator.exe [options]

Nomad Package Locator general command-line switches

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

SwitchDefault valueDescription
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.
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 machine 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.
Port1779Sets 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.
Timeout3Maximum wait time (in seconds) between messages. Applies to each package listed in the TS environment.

Nomad package locator NMDS command-line switches

The NMDS commands listed in the table above invoke NomadBranch.exe to do most of the work, but NomadPackageLocator.exe also uses and sets crucial task sequence variables so NomadPackageLocator.exe is a safer command-line interface to use.

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