列示存储库对象。
用途
scm list
子命令用于列示所指定存储库中的对象,其中包括项目区域、团队区域、流、工作空间、文件和添加者(用户)。scm list
的别名是 scm ls。
大纲
- 在使用 scm login 来创建存储凭证后,要运行 scm list:
scm list [ -r | --repository-uri] 存储库 URI 或昵称 { [ -c | --contrib ] 名称 [ -v | --verbose] --depth 级别} 对象类型 {特定于对象类型的选项}
- 要运行 scm list 并通过命令行提供凭证:
scm list [-r | --repository-uri] 存储库 URI [ -u | --username] 存储库中的用户标识 [ -P | --password] 存储库中用户标识的密码 { [ -c | --contrib ] 名称 [ -v | --verbose] --depth 级别 } 对象类型 {特定于对象类型的选项}
选项和参数
- [ -c | --contrib] 名称
- 所指定存储库中的有效用户标识。如果提供了此选项,那么
item type 列表将仅包含所指定添加者拥有的项。如果省略此选项,那么
名称 将缺省为运行 scm list
的用户的用户标识。在列示项目区域、添加者、组件和远程文件时,此选项不适用。
- --depth 级别
- 在列示远程文件时,级别 指定最大递归深度。如果未指定
级别,那么它将缺省为 3,即列示所指定组件中的前三层文件夹内容。将
级别 指定为 - 将列示所指定组件中的所有远程文件。不适用于其他对象类型。
- [ -P | --password] 存储库中用户标识的密码
- 在指定的存储库中,所指定的用户标识的密码。如果命令行中未包含此选项,那么将提示您输入密码。如果您指定了一个存储库 URI 或昵称,而您已使用 scm login 命令存储了它的凭证,那么将忽略此选项。
- [-r | --repository-uri] 存储库 URI
- 指定要在其中执行此操作的存储库。如果您已经使用 scm login 命令存储了存储库凭证,那么可以使用您为所存储的这些凭证提供的昵称。
- [ -u | --username] 存储库中的用户标识
- 指定存在于所指定的存储库中的用户标识。如果您指定了一个存储库 URI 或昵称,而您已使用 scm login 命令存储了它的凭证,那么将忽略此选项。
- [ -v | --verbose]
- 运行时将提供更多参考消息。列示组件时,同时显示基线。
- 对象类型
- 要列示的项的类型。下列其中一项:
- components
- 列示所指定添加者有权访问的所有组件。
- contributors
- 列示所有那些在所指定存储库中拥有帐户的添加者的用户标识。
- project-areas
- 列示存储库中的所有项目区域。
- streams
- 列示所指定添加者所隶属于的所有团队区域中的流。
- remotefiles
- 列示工作空间、组件或项目中的远程文件。此对象类型的特定于对象类型的选项是:
- 工作空间组件
- 工作空间以及该工作空间中某个组件的名称。请使用空格来分隔各个名称。指定的
组件 必须存在于指定的
工作空间 中。
- 远程路径
- 所指定 组件 中的路径名。此选项是可选的。此选项用于约束对
组件 列示的远程路径的列表。
- team-areas
- 列示所指定添加者所隶属于的所有团队区域。
- workspaces
- 列示所指定添加者拥有的所有工作空间。
示例
对于别名为 jazzhost 的存储库的存储凭证的相关联用户,列示他们所拥有的工作空间:
C:\>scm list workspaces -r jazzhost
(1000)“Community Site Workspace”
(1101)“HelloJazz”
(1068)“UA-CLI”
(1113)“HelloJazz2”
(1109)“REST-svc-dev”
(1141)“Rob's test workspace”
列示别名为 jazzhost 的存储库中用户 brc 所拥有的工作空间:
C:\>scm list workspaces -c brc -r jazzhost
(1141)“Rob's test workspace”
(1109)“REST-svc-dev”