Skip to main content

1E 23.11 (SaaS)

NomadBranch.exe command-line switches

This executable does not normally need to be run on a command-line, but details are provided here for reference purposes.

It is normally installed as part of Nomad and configured using Configuration Manager Admin console extensions. Please refer to Nomad tab for different types of content. 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 Nomad service command-line is as follows:

NomadBranch.exe [switches]

Note

In contrast to the SMSNomad executable command-line switches, the service uses single dashes before the arguments.

Nomad service switches

Switch

Description

-cancel

Stops the current Nomad content download job immediately, which then exits with an error condition. This is intended for use by an administrator when a problem has occurred and a running job is taking an excessively long time.

-debug

Sets the debug level for the NomadBranch service where typical values are: 1=general logging, 31=maximum logging. The value is set in the registry and retained. The default is 1.

-start

Starts the NomadBranch.exe service.

-stop

Stops the NomadBranch.exe service.

-activate

Forces verification of specific content in Nomad cache.

-activate=<content_ID>

-activateall

Forces verification of all content in Nomad cache.

-cdssync

Forces re-registration of all content with Content Distribution platform.

Peer Backup Assistant (NMDS) switches

NMDS commands can only be used within a Configuration Manager task sequence and must be wrapped by calling NomadPackageLocator.exe, for details refer to NomadPackageLocator.exe command-line switches. NMDS functionality requires setting and making use of task sequence variables, which is not directly supported via the NomadBranch.exe command. We recommend you first try the predefined Nomad custom task sequence actions available from the Configuration Manager console and failing that, use the equivalent NomadPackageLocator commands. Only use NomadBranch.exe NMDS commands as a last resort – they are minimally documented below for completeness.

Switch

Description

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.

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_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_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_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.