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

指定儲存庫中的有效使用者 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 ] repository URI

指定要採取這個動作的儲存庫。 如果您已利用 scm login 指令來保存儲存庫認證，您可以將提供的暱稱用於這些儲存認證

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

指定在指名儲存庫中的使用者 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

列出指定的貢獻者所擁有的所有工作區。

範例