创建存储库对象。
用途
scm create
子命令用于创建存储库工作空间或基线。
大纲
- 在使用 scm login 来创建存储凭证后,要运行 scm create:
scm create workspace [ -r | --repository-uri] 存储库 URI 或昵称 { [ -d | --description ] 描述 [ -s | --stream] 要设置为缺省流向目标的流 } 名称
scm create baseline [ -r | --repository-uri] 存储库 URI 或昵称 { --description 描述 } [组件 [...] | --all] 名称
- 要运行 scm create 并通过命令行提供凭证:
scm create workspace [-r | --repository-uri] 存储库 URI [ -u | --username] 存储库中的用户标识 [ -P | --password] 存储库中用户标识的密码
{ [ -d | --description ] 描述 [ -s | --stream] 要设置为缺省流向目标的流 } 名称
scm create baseline [-r | --repository-uri] 存储库 URI [ -u | --username] 存储库中的用户标识 [ -P | --password] 存储库中用户标识的密码
{ [ -d | --description ] 描述} [组件 [...] | --all] 名称
选项和参数
- --all
- 选择所有组件。
- [ --changeset]
- 创建新的变更集。
- [ --component]
- 在指定的工作空间或流中创建新组件。
- [ -d | --description ] 描述
- 工作空间或基线的描述。当与 scm create baseline
配合使用时,只允许使用此选项的长格式(--description)。
- [ -P | --password] 存储库中用户标识的密码
- 在指定的存储库中,所指定的用户标识的密码。如果命令行中未包含此选项,那么将提示您输入密码。如果您指定了一个存储库 URI 或昵称,而您已使用 scm login 命令存储了它的凭证,那么将忽略此选项。
- [-r | --repository-uri] 存储库 URI
- 指定要在其中执行此操作的存储库。如果您已经使用 scm login 命令存储了存储库凭证,那么可以使用您为所存储的这些凭证提供的昵称。
- [ --snapshot]
- 创建与工作空间或流相关联的新快照。
- [ -s | --stream] 要设置为缺省流向目标的流
- 要设置为工作空间的缺省流向目标的流的名称。此流必须存在于由 -r 选项指定的存储库中。此选项对 create baseline 无效。
- [ -u | --username] 存储库中的用户标识
- 指定存在于所指定的存储库中的用户标识。如果您指定了一个存储库 URI 或昵称,而您已使用 scm login 命令存储了它的凭证,那么将忽略此选项。
- 组件 [...]
- 以空格分隔的组件列表,这些组件由名称、别名或 UUID 指定,将为其创建基线。您必须指定组件列表,或者包括
--all 选项以指定所有组件。此选项对 create workspace 无效。
- 名称
- 工作空间或基线的名称。
示例
通过使用昵称为 jazzhost 的存储库的凭证,为名为
HelloJazz 的存储库工作空间中的所有组件创建基线“beta2 updates”:
C:\>scm create baseline -r jazzhost --all HelloJazz "beta2 updates"
创建基线后,
scm status 会将其显示在工作空间中。
C:\local-workspaces\HelloJazz>scm status
工作空间:(1101)“HelloJazz”<->(1102)“HelloJazz Stream”
组件:(1103)“HelloJazz”
基线:(1108)3“beta2 updates”
传出:
基线:
(1108)3“beta2 updates”