compare

Displays the outgoing changes from one item to another. You must specify the items and their types on the command line. Direction in which the changes flow, either incoming or outgoing, is shown relative to the first item.

Aliases:

comp

Usage: scm compare [-r/--repository-uri <arg>] [-u/--username <arg> -P/--password <arg> | -u/--username <arg> --password-file <arg> | --certificate <arg> -P/--password <arg> | --smartCard -u/--username <arg> | --kerberos | --integratedWindows] [-j/--json] [-I/--include-types <arg>] [-C/--format-contributor <arg>] [-D/--format-date <arg>] [-S/--show <arg>] [-f/--flow-directions <arg>] [-w/--reroot <arg>] [-p/--prune <arg>] [-c/--components <arg ...>] <new-type> <new> <old-type> <old>

new-type The type of the new item. Its value can be one of the following: "workspace", "stream", "baseline", "snapshot" or "historyRef"
new The new item to compare against. This item must be of the type that is specified in the new-type value. To specify this item, use its alias, UUID[@repo], or name[@repo].
old-type The type of the old item. Its value can be one of the following: "workspace", "stream", "baseline", "snapshot" or "historyRef"
old The old item to compare against. This item must be of the type that is specified in the new-type value. To specify this item, use its alias, UUID[@repo], or name[@repo].

Options:

-r, --repository-uri <arg> The URI that specifies the location of the repository.
-u, --username <arg> The user name for the repository.
-P, --password <arg> The password for the repository.
    --password-file <arg> File that contains the user's password.
    --certificate <arg> The file that contains the user's login certificate.
    --smartCard Use the connected smart card for authentication.
    --kerberos Authenticate with Windows user credentials using Kerberos/SPNeGO.
    --integratedWindows Authenticate with Windows user credentials using Integrated Windows Authentication.
-j, --json Enable JSON output.
-I, --include-types <arg> A combination of letters that indicate which items to show. Use "d" for flow direction, "c" for component, "b" for baseline, "w" for work item, "s" for change set, "f" for file system, and "o" for oslc links. The default is "dcbswo".
-C, --format-contributor <arg> The format for contributors. The {userid} format expands to the user's repository ID. The {name} format expands to the user name. The {email} format expands to the user's email address. The {itemid} format expands to the user's repository item ID.
-D, --format-date <arg> The format for dates. For allowed values, see the Java SimpleDateFormat specification.
-S, --show <arg> Indicates which optional values must be displayed. Use "c" to show contributor fields, use "d" to show date fields, use "i" to show work items, use "o" to show change requests under change sets, use "v" to show short version id of a file, and use "V" to show long version id of a file.
-f, --flow-directions <arg> Shows only those changes that flow in the given direction. The flow direction must be "i" for incoming, "o" for outgoing, or "b" for both. The default is "b".
-w, --reroot <arg> Roots work items under a specific node type. The value must be one of the following: "r" for root, "d" for direction, "c" for component, or "b" for baseline.
-p, --prune <arg> Prunes unchanged/empty items. This option might include these values: "d" for empty directions or "c" for unchanged components.
-c, --components <arg ...> The components to compare for workspace, stream, snapshot, historyRef or the component when comparing a baseline specified using a baseline name or baseline id.


Example