NomadPackageLocator.exe command-line switches
The product formerly referred to as Nomad has been rebranded as Content Distribution. Although the new name is implemented in the majority of documentation and user interfaces, references to Nomad may still appear in specific tools, scripts, or contexts.
NomadPackageLocator.exe is used by the Content Distribution 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 Content Distribution. It is also available in Nomad OSD tools in order to include in WinPE images so that Content Distribution can be used in OS Deployments. Please refer to Installing Content Distribution 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 Content Distribution clients. |
|
ForceNomadMachine |
|
Name of a specific Content Distribution client whose cache you want to use. This prevents NomadPackageLocator from polling for a Content Distribution client whose cache contains the content. |
|
HideErrorDialog |
|
Suppresses error messages during the image deployment task sequence for packages that cannot be located in a Content Distribution 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 Content Distribution peers on the local subnet. |
|
RequireNomad |
|
If used on the NomadPackageLocator.exe command-line, Content Distribution 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 |
|---|---|---|
|
|
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 Content Distribution PostCompleteTimeoutHours registry value on the device where the share is hosted. It is only for use within a task sequence. |
|
|
|
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. |
|
|
|
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. |
|
|
|
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. |
|
|
|
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. |