文档

​
​

Development

User Acquisition

Monetization

工业

Unity Version Control

DevOps

On-prem

Gluon

Editor plug-in

Open Unity Dashboard

Unity Version Control

此页面不支持所选语言。
​
​
Unity Version Control
  • Overview
  • Cloud Repositories organization update
  • Installation
  • Use UVCS with the Unity Editor
  • Unity Version Control plugins
  • Concepts
  • Tutorials
  • On-Prem
  • Gluon
  • CLI and shortcut references
    • Unity Version Control CLI
      • acl
      • activateuser
      • add
      • admin
      • annotate
      • api
      • applylocal
      • archive
      • attribute
      • autocomplete
      • branch
      • changelist
      • changerevisiontype
      • changeset
      • changeuserpassword
      • checkconnection
      • checkin
      • checkout
      • checkselectorsyntax
      • clone
      • codereview
      • configure
      • crypt
      • deactivateuser
      • diff
      • diffmetrics
      • fastexport
      • fastimport
      • fileinfo
      • find
      • getconfig
      • getfile
      • getrevision
      • getstatus
      • gettaskbranches
      • getworkspacefrompath
      • getworkspaceinfo
      • help
      • history
      • iostats
      • issuetracker
      • label
      • licenseinfo
      • linktask
      • list
      • listusers
      • location
      • lock
      • log
      • merge
      • move
      • objectspec
      • partial
      • patch
      • profile
      • pull
      • purge
      • push
      • query
      • remove
      • repository
      • revert
      • setowner
      • shelveset
      • show-find-objects
      • showacl
      • showcommands
      • showowner
      • showpermissions
      • support
      • switch
      • sync
      • trigger
      • tube
      • undelete
      • undo
      • undochange
      • undocheckout
      • undocheckoutunchanged
      • update
      • version
      • whoami
      • workspace
      • workspacestatus
      • xlink
    • CLI help
    • Pipe commands
    • cm find
    • Windows keyboard shortcuts
  • Release Notes
  1. Unity Version Control (previously Plastic SCM)

SWITCH

Switch branches, changesets, labels, or shelvesets with the Unity Version Control CLI.
阅读时间1 分钟
最后更新于 10 个月前

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

--workspacePath where the workspace is located.
--repositorySwitches to the specified repository.
--forcedetailedprogressForces detailed progress even when standard output is redirected.
--noinputSkips the interactive questions to continue the operation with pending changes or to shelve them.
--silentNo output is shown unless an error happens.
--verboseShows additional information.
--xmlPrints the output in XML format to the standard output. It is possible to specify an output file.
--encodingUsed 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).
brspecTarget branch. (Use 'cm help objectspec' to learn more about branch specs.)
csetspecTarget changeset. (Use 'cm help objectspec' to learn more about changeset specs.)
lbspecTarget label. (Use 'cm help objectspec' to learn more about label specs.)
shspecTarget 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

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • Description

      • Usage

      • Options

    • Help

      • Remarks

      • Examples


报告此页面的问题