Labels 命令

顯示 Team Foundation 版本控制伺服器中的標籤清單。

必要的使用權限

若要使用 labels 命令,您必須將指定的標籤所附加之所有檔案或資料夾的 [讀取] 權限設定為 [允許]。 如果您只擁有標籤中所參考之某些檔案 (而非所有檔案) 的權限,則只會顯示部分結果。 如需詳細資訊,請參閱Team Foundation Server 使用權限

tf labels [/owner:ownername] [/format:(brief|detailed)] 
[/collection:TeamProjectCollectionUrl] [labelname] [/login:username,[password]]

參數

引數

描述

ownername

以 DOMAIN\JuanGo 或 juango 的形式為 /owner 選項提供使用者名稱。

labelname

指定用來篩選標籤清單的字串。 如果省略這個參數,就無法篩選標籤名稱欄位。

TeamProjectCollectionUrl

您要為其顯示標籤清單之 Team 專案集合的 URL (例如 http://myserver:8080/tfs/DefaultCollection)。

username

提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。

選項

描述

/owner

指定擁有標籤的使用者名稱。 根據預設,擁有者是套用標籤的人員。

/format

以下列其中一種格式顯示有關指定標籤的資訊:

  • Brief

    包含標籤、擁有人,以及建立日期。 這是預設值。

  • 詳細

    包含註解、範圍,以及與每個標籤關聯的檔案和資料夾清單。

/collection

指定 Team 專案集合。

/login

指定使用者名稱和密碼,以便透過 Visual Studio Team Foundation Server 驗證使用者。

備註

labels 命令顯示 Team Foundation 版本控制伺服器中的標籤的相關資訊。 如果沒有指定 Team Foundation 版本控制伺服器,Team 總管會藉由使用目前的目錄,嘗試判斷基礎的 Team Foundation 版本控制伺服器。 如果目前的目錄未對應至 Team Foundation 版本控制伺服器,則您必須藉由使用 /s 選項指定一個伺服器。

根據預設,結果會顯示出每個標籤的標籤名稱、擁有人和建立日期。 如果格式變更為「詳細」,則與每個標籤關聯的註解和檔案及資料夾的清單也會顯示。

如需其他 Team Foundation 命令的連結,內容提供 Team Foundation 版本控制伺服器中項目與對應至此伺服器之所有工作區的詳細資訊,請參閱可取得資訊的命令

如需如何尋找 tf 命令列公用程式的詳細資訊,請參閱 Tf 命令列公用程式命令

範例

下列範例顯示由使用者 "jasonj" 所建立的標籤清單。

c:\projects> tf labels /owner:jasonj

下列範例顯示 "build1033" 標籤的相關資訊,並列出該標籤在 Team Foundation 版本控制伺服器中已套用至的檔案和資料夾。

c:\projects> tf labels /format:detailed build1033

下列範例會顯示在 Team Foundation 版本控制伺服器中 labelname 以 "build" 開頭且由執行 labels 命令之帳戶所擁有的所有標籤。

c:\projects> tf labels build*

請參閱

參考

命令列語法 (版本控制)

Label 命令 (Team Foundation 版本控制)

Unlabel 命令

概念

可取得資訊的命令

其他資源

Tf 命令列公用程式命令