列出儲存庫物件
用途
scm list 次指令會列出指定儲存庫中的物件,其中包括專案區域、團隊區域、串流、工作區、檔案和貢獻者(使用者)。
scm list 的別名是 scm ls。
用法概要
- 如果要在利用 scm login 來建立儲存認證之後執行 scm list,請執行下列動作:
scm list [ -r | --repository-uri ] 儲存庫 URI 或暱稱 { [ -c | --contrib ] name [ -v | --verbose ] --depth levels} object type {object-type specific options}
- 如果要在指令行提供認證來執行 scm list,請執行下列動作:
scm list [ -r | --repository-uri ] 儲存庫 URI [ -u | --username ] 儲存庫中的使用者 ID [ -P | --password ] password for user ID in repository { [ -c | --contrib ] name [ -v | --verbose ] --depth levels } object type {object-type specific options}
選項和引數
- [ -c | --contrib ] name
- 指定儲存庫中的有效使用者 ID。
如果提供了這個選項,item type 清單只限於指定貢獻者所擁有的項目。
如果省略這個選項,name 便預設為執行 scm 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) "Community Site Workspace"
(1101) "HelloJazz"
(1068) "UA-CLI"
(1113) "HelloJazz2"
(1109) "REST-svc-dev"
(1141) "Rob's test workspace"
列出使用者 brc 在暱稱為 jazzhost 的儲存庫中所擁有的工作區:
C:\>scm list workspaces -c brc -r jazzhost
(1141) "Rob's test workspace"
(1109) "REST-svc-dev"