list 和 ls

用途

scm list 子命令用于列示所指定存储库中的对象，其中包括项目区域、团队区域、流、工作空间、文件和添加者（用户）。scm list 的别名是 scm ls。

大纲

• 在使用 scm login 来创建存储凭证后，要运行 scm list：

  scm list [ -r  |  --repository-uri ] repository URI or nickname { [ -c  |  --contrib ] name [ -v  |  --verbose ] --depth levels} object type {object-type specific options}

• 要运行 scm list 并通过命令行提供凭证：

  scm list [ -r  |  --repository-uri ] repository URI [ -u  |  --username ] user ID in repository [ -P  |  --password ] password for user ID in repository { [ -c  |  --contrib ] name [ -v  |  --verbose ] --depth levels }  object type {object-type specific options}

选项和参数

[ -c  |  --contrib ] name

所指定存储库中的有效用户标识。如果提供了此选项，那么 item type 列表将仅包含所指定添加者拥有的项。如果省略此选项，那么 name 将缺省为运行 scm list 的用户的用户标识。在列示项目区域、添加者、组件和远程文件时，此选项不适用。

--depth levels

在列示远程文件时，levels 指定最大递归深度。如果未指定 levels，那么它将缺省为 3，即列示所指定组件中的前三层文件夹内容。将 levels 指定为 - 将列示所指定组件中的所有远程文件。不适用于其他对象类型。

[ -P  |  --password ] password for user ID in repository

在指定的存储库中，所指定的用户标识的密码。如果命令行中未包含此选项，那么将提示您输入密码。如果您指定了一个存储库 URI 或昵称，而您已使用 scm login 命令存储了它的凭证，那么将忽略此选项。

[ -r  |  --repository-uri ] repository URI

指定要在其中执行此操作的存储库。如果您已经使用 scm login 命令存储了存储库凭证，那么可以使用您为所存储的这些凭证提供的昵称。

[ -u  |  --username ] user ID in repository

指定存在于所指定的存储库中的用户标识。如果您指定了一个存储库 URI 或昵称，而您已使用 scm login 命令存储了它的凭证，那么将忽略此选项。

[ -v  |  --verbose ]

运行时将提供更多参考消息。列示组件时，同时显示基线。

object type

要列示的项的类型。下列其中一项：

components

列示所指定添加者有权访问的所有组件。

contributors

列示所有那些在所指定存储库中拥有帐户的添加者的用户标识。

project-areas

列示存储库中的所有项目区域。

streams

列示所指定添加者所隶属于的所有团队区域中的流。

remotefiles

列示工作空间、组件或项目中的远程文件。此对象类型的特定于对象类型的选项是：

workspace component

工作空间以及该工作空间中某个组件的名称。请使用空格来分隔各个名称。指定的 component 必须存在于指定的 workspace 中。

remotePath

所指定 component 中的路径名。此选项是可选的。此选项用于约束对 component 列示的远程路径的列表。

team-areas

列示所指定添加者所隶属于的所有团队区域。

workspaces

列示所指定添加者拥有的所有工作空间。

示例