Workspace 命令
讓您建立、刪除、檢視或修改與工作區關聯的屬性及對應。
必要的使用權限
若要修改或刪除現有工作區，您必須是擁有人或將全域 [管理工作區] 權限設定為 [允許]。 若要建立工作區，您必須將全域 [建立工作區] 權限設定為 [允許]。 若要為其他使用者建立工作區，您必須將 [管理工作區] 權限設定為 [允許]。 如需詳細資訊，請參閱Team Foundation Server 使用權限。
tf workspace /new [/noprompt] [/template:workspacename[;workspaceowner]]
[/computer:computername] [/comment:("comment"|@comment file)]
[/collection:TeamProjectCollectionUrl] [/permission:(Private|PublicLimited|Public)][workspacename[;workspaceowner]][/login:username,[password]]
tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner][/login:username,[password]]
tf workspace [/collection:TeamProjectCollectionUrl] [/comment: ("comment"|@comment file)] [/newname:workspacename]
[workspacename[;workspaceowner]] [/newowner:ownername] [/computer:computername] [/permission:(Private|PublicLimited|Public)] [/login:username,[password]]
參數
引數 |
描述 |
|---|---|
workspacename |
指定要建立、編輯、刪除或顯示其相關資訊的工作區名稱。 |
workspaceowner |
指定工作區的使用者名稱。 當工作區擁有人不是執行命令人時，才需要此參數。 |
computername |
提供 /computer 選項的值。 |
comment |
提供 /comment 選項的值。 |
@commentfile |
指定應該在其位置讀取註解的檔案路徑。 |
username |
提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。 |
TeamProjectCollectionUrl |
Team 專案集合的 URL (例如 http://myserver:8080/tfs/DefaultCollection)，該集合包含您要建立編輯、刪除或顯示相關資訊的工作區。 |
ownername |
提供 /newowner 選項的值。 |
選項 |
描述 |
|---|---|
/new |
建立新的工作區。 |
/template |
指定要用來當做範本以建立新工作區的現有工作區。 新的工作區會使用現有工作區的對應。 |
/delete |
刪除指定的工作區。 |
/computer |
指定要在其上建立工作區的電腦的名稱。 這是進階的選項。 |
/comment |
提供描述工作區的註解。 |
/newname |
重新命名現有的工作區。 |
/noprompt |
執行指定的工作區命令，而不顯示對話方塊。 |
/collection |
指定 Team 專案集合。 |
/permission |
指定工作區使用權限的選項：
|
/login |
指定使用者名稱和密碼，以便透過 Visual Studio Team Foundation Server 驗證使用者。 |
/newowner |
指定工作區的新擁有者的使用者名稱。 |
備註
工作區是伺服器上檔案和資料夾的本機複本，以及在本機所做的任何變更。 在加入、編輯、刪除、移除、重新命名或變更任何版本控制項目後，所做的變更會隔離在工作區中，您可在其中進行或測試變更。 暫止變更會認可到伺服器，並在執行簽入後提供工作區外的其他使用者使用。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
建立工作區
必須先建立工作區，或使現有的工作區與目前的目錄產生關聯，才能將檔案加入至版本控制伺服器或在伺服器上簽出項目進行編輯。 如需詳細資訊，請參閱建立工作區和取得檔案。
若要在電腦上使目前的目錄成為現有工作區的工作資料夾，請輸入 tf workspace workspacename，其中 workspacename 是現有工作區的名稱。 [編輯工作區] 對話方塊隨即出現。 按一下 [請按這裡，輸入新的工作資料夾]、在 [原始檔控制資料夾] 方塊中輸入要對應目前目錄的伺服器路徑、在 [本機資料夾] 方塊中輸入目前的目錄，然後按一下 [確定]。
在建立新的工作區時，可以將「範本工作區」(Template Workspace) 指定為 /new 選項的一部分。 在您指定範本工作區時，Team Foundation 會在目前的電腦上建立新的工作區、將擁有人設定為目前的擁有人，然後將下列的工作區屬性從範本工作區複製到新的工作區：對應和註解。 如果沒有指定名稱，系統便會使用根據目前電腦名稱而定的名稱。 在您使用範本建立工作區時，Team Foundation 不會擷取它從伺服器所對應到的檔案。 請使用 Get 命令以同步處理新工作區與伺服器上的最新版本。
單一資料夾對應
您可以選擇只將版本控制資料夾的直接子系對應至本機工作區。 若要執行這項操作，請在 [加入工作區] 對話方塊的 [原始檔控制資料夾] 方塊內加入星號萬用字元 (Wildcard Character)。 例如，$/folder/*。 否則根據預設，所有版本控制資料夾的子系都會以遞迴方式對應至本機工作區。
在版本控制階層架構內的單一資料夾對應非常實用，因為它會限制下載到用戶端電腦的項目數。 另一個限制下載檔案的方法，是隱匿工作區內不需要使用的檔案。 如需詳細資訊，請參閱隱匿和取消隱匿工作區中的資料夾。 這種方法可提供較快的下載時間，同時也可節省用戶端電腦上的磁碟空間。
刪除工作區
如果刪除包含暫止變更的工作區，Team Foundation 就會在刪除程序時取消暫止變更。 刪除工作區並不會在用戶端電腦上刪除本來位於該工作區中的檔案和資料夾。
編輯工作區
您可以變更下列的工作區屬性 (Attribute)：
工作區名稱
註解
工作資料夾對應
如果沒有提供任何工作區規格，就會使用目前資料夾的工作區。
範例
下列範例會開啟 [加入工作區] 對話方塊，並建立新的工作區。 您可以使用 [加入工作區] 對話方塊，編輯原始檔控制資料夾、擁有人、電腦、註解和本機資料夾。
c:\projects>tf workspace /new /collection:http://myserver:8080/tfs/DefaultCollection
下列範例會建立稱為 Beta1 的新工作區，並將 jenh 指派為該工作區的擁有人。 您必須具有 AdminWorkspaces 權限，才能將新工作區的擁有權指派給另一個使用者。 如需安全性權限的詳細資訊，請參閱 Team Foundation Server 使用權限。
c:\projects>tf workspace /new Beta1;jenh
下列範例會使用由 jenh 擁有的 Beta1 工作區當做範本，建立新的工作區。
c:\projects>tf workspace /new /template:Beta1;jenh /collection:http://myserver:8080/tfs/DefaultCollection
下列範例會從伺服器移除 Beta1 工作區。
c:\projects>tf workspace /delete Beta1
下列範例會編輯目前工作區的屬性。
c:\projects>tf workspace
下列範例會開啟使用者 jenh 為擁有人的 Beta1 工作區，使您可以查看其屬性和對應。 如果具有 AdminWorkspaces 權限，就可以變更工作區屬性和對應。
c:\projects> tf workspace Beta1;jenh