list

列出儲存庫物件

用途

scm list 次指令會列出指定儲存庫中的物件,其中包括專案區域、團隊區域、串流、工作區、檔案和貢獻者(使用者)。 scm list 的別名是 scm ls

用法概要

選項和引數

-c  |  --contrib ] name
指定儲存庫中的有效使用者 ID。 如果提供了這個選項,item type 清單只限於指定貢獻者所擁有的項目。 如果省略這個選項,name 便預設為執行 ccc list 之使用者的使用者 ID。 列出專案區域、貢獻者、元件和遠端檔案時不適用。
--depth levels
當列出遠端檔案時,levels 指定遞迴深度上限。 如果沒有指定,levels 預設為 3,列出指定元件中前三層的資料夾內容。 將 levels 指定為 – 會列出指定元件中的所有遠端檔案。 不適合其他物件類型。
-P  |  --password ] password for user ID in repository
指名儲存庫中指定使用者 ID 的密碼。 如果指令行不含這個選項,系統會提示您輸入密碼。 如果您指定了已利用 scm login 指令來儲存認證的儲存庫 URI 或暱稱,便會忽略這個選項。
-r  |  --repository-uri ] 儲存庫 URI
指定要採取這個動作的儲存庫。 如果您已利用 scm login 指令來儲存儲存庫認證,您可以將提供的暱稱用於這些儲存認證。
-u  |  --username ] 儲存庫中的使用者 ID
指定在指名儲存庫中的使用者 ID。 如果您指定了已利用 scm login 指令來儲存認證的儲存庫 URI 或暱稱,便會忽略這個選項。
-v  |  --verbose ]
在運作之時,提供其他參考訊息。當列出元件時,也會顯示基準線。
object type
要列出的項目類型。下列項目之一:
components
列出指定的貢獻者有權存取的所有元件。
contributors
列出在指定儲存庫中擁有帳戶的所有貢獻者的使用者 ID。
project-areas
列出儲存庫中的所有專案區域。
streams
列出指定的貢獻者是成員的所有團隊區域中的串流。
remotefiles
列出工作區、元件或專案中的遠端檔案。 這個物件類型的物件類型特定選項如下:
workspace component
工作區或其中之元件的名稱。 以空格來區隔名稱。 指名的 component 必須在指名的 workspace 中。
remotePath
在指定的 component 內的路徑名稱。 這個選項是選用的。 它用來限制針對 component 所列出的遠端路徑清單。
team-areas
列出指定的貢獻者是成員的所有團隊區域。
workspaces
列出指定的貢獻者所擁有的所有工作區。

範例

列出暱稱為 jazzhost 的儲存庫之儲存認證的相關使用者所擁有的工作區:

C:\>scm list workspaces -r jazzhost
(1000) "社群網站工作區"
(1101) "HelloJazz"
(1068) "UA-CLI"
(1113) "HelloJazz2"
(1109) "REST-svc-dev"
(1141) "Rob 的測試工作區"

列出使用者 brc 在暱稱為 jazzhost 的儲存庫中所擁有的工作區:

C:\>scm list workspaces -c brc -r jazzhost
(1141) "Rob 的測試工作區"
(1109) "REST-svc-dev"


意見

以上說明對您有幫助嗎?您可以在 Jazz.net 網站中提供意見(需要登錄):在討論區中提供意見提交錯誤