SWITCH
Switch branches, changesets, labels, or shelvesets with the Unity Version Control CLI.
Read time 1 minuteLast updated 10 months ago
Description
Switches the workspace to a branch, changeset, label, or shelveset.
Usage
cm switch (<brspec> | <csetspec> | <lbspec> | <shspec>) [--workspace=<path>] [--repository=<name>] [--forcedetailedprogress] [--silent] [--verbose] [--xml[=<output_file>]] [--encoding=<name>] [--forcedetailedprogress] [--noinput]
Options
Option / Argument | Description |
|---|---|
| --workspace | Path where the workspace is located. |
| --repository | Switches to the specified repository. |
| --forcedetailedprogress | Forces detailed progress even when standard output is redirected. |
| --noinput | Skips the interactive questions to continue the operation with pending changes or to shelve them. |
| --silent | No output is shown unless an error happens. |
| --verbose | Shows additional information. |
| --xml | Prints the output in XML format to the standard output. It is possible to specify an output file. |
| --encoding | Used with the --xml option, specifies the encoding to use in the XML output, i.e.: utf-8. See the MSDN documentation at http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx to get the table of supported encodings and its format, (at the end of the page, in the "Name" column). |
| brspec | Target branch. (Use 'cm help objectspec' to learn more about branch specs.) |
| csetspec | Target changeset. (Use 'cm help objectspec' to learn more about changeset specs.) |
| lbspec | Target label. (Use 'cm help objectspec' to learn more about label specs.) |
| shspec | Target shelveset. (Use 'cm help objectspec' to learn more about shelveset specs.) |
Help
Remarks
This command allows users to update the workspace tree to the contents of the specified object (branch, label, shelveset, or changeset).
Examples
cm switch br:/main
cm switch lb:Rel1.1
cm switch br:/main/scm002 --repository=rep2
cm switch cs:4375
cm switch sh:2