list

列示存储库对象。

用途

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

大纲

选项和参数

-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”


反馈

本资料对您是否有帮助?您可以在 Jazz.net 上提供反馈(需要注册):在论坛中发表意见或者提交错误