Permission 命令
修改使用者存取控制清單 (ACL)，並針對版本控制下的項目顯示授權設定。
必要的使用權限
若要使用 permission 命令，您必須針對要修改的資料夾，將 [管理安全性設定] 權限設定為 [允許]、必須是 [Team Foundation Administrators] 安全性群組的成員，或者必須是本機電腦上的系統管理員 (Windows Administrator 安全性群組)。 如需詳細資訊，請參閱Team Foundation Server 使用權限。
tf permission [/allow:(* |perm1[,perm2,...]]
[/deny:(* |perm1[,perm2,...])] [/remove:(* |perm1[,perm2,...])]
[/inherit:yes|no] [/user:username1[,username2,...]]
[/group:groupname1[,groupname2,...]] [/collection:TeamProjectCollectionUrl]
[/recursive] itemspec [/global][/login:username,[password]]
參數
引數 |
描述 |
|---|---|
perm |
要修改的權限或角色的名稱。 如需使用權限名稱的詳細資訊，請參閱 Team Foundation Server 使用權限。 |
Username |
提供 /user 選項的值。 根據網路設定，使用者名稱值可以用兩種方式表示：DOMAIN\username 或 username。 |
Groupname |
/group 選項的使用者提供值。 |
TeamProjectCollectionUrl |
Team 專案集合的 URL (例如 http://myserver:8080/tfs/DefaultCollection)，該集合包含您要修改使用權限的項目。 |
Itemspec |
辨別要為其修改權限的檔案或資料夾。 如需 Team Foundation 如何剖析itemspecs以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (版本控制)。 .gif "注意事項") 注意事項
您可以指定一個以上的 Itemspec 引數。
|
Username |
提供 /login 選項的值。 您可以將使用者名稱值指定成網域\ 使用者名稱或使用者名稱的格式。 |
選項 |
描述 |
|---|---|
/allow |
指定要加入至允許 ACL 的 Team Foundation 版本控制權限清單。 |
/deny |
指定要加入至使用者存取控制清單的拒絕 Team Foundation 版本控制存取權限。 |
/remove |
指定要同時從允許和拒絕 ACL 移除的 Team Foundation 版本控制權限清單。 |
/inherit |
如果選取 yes，則項目會繼承與父 ACL 關聯的所有權限。 無法與 /remove 選項結合。 |
/user |
指定要為其修改權限的使用者名稱。 |
/group |
要為其修改權限的群組名稱。 |
/collection |
指定 Team 專案集合。 |
/recursive |
將指定的命令套用至目錄及任何子目錄中的所有項目。 只有在原始碼結構中檢視項目的權限時，/recursive 選項才有作用。 在搭配如 /allow、/deny 和 /remove 選項設定權限時，則這個選項不會有作用。 |
/global |
用於檢視或指派任何 Team Foundation 伺服器權限。 若要指派權限，請使用 /allow、/deny 或 /remove 選項。 不需要引數 itmespec。 如果仍列出該引數，則會被忽略。 當用於檢視 Team Foundation 伺服器權限時，所列出的五個權限如下：
如需使用權限的詳細資訊，請參閱 Team Foundation Server 使用權限。 |
/login |
指定使用者名稱和密碼，以便透過 Visual Studio Team Foundation Server 驗證使用者。 |
備註
您可以使用 permission 命令 (或者它的捷徑 perm) 管理 Team Foundation 版本控制 伺服器物件的授權設定。 不過，這個命令無法讓您管理例如建立或修改 Team Foundation 安全性群組的驗證設定。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
範例
下列範例顯示 314.cs 的 Team Foundation 存取控制清單 (ACL)。
c:\projects>tf permission 314.cs
下列範例會顯示與位於 http://myserver:8080/tfs/DefaultCollection/ 之集合的 "developers" 群組相關的 ACL 資訊。
c:\projects>tf permission /group:[teamproject]\developers /collection: http://myserver:8080/tfs/DefaultCollection/
下列範例讓 "leads" 群組的成員變更他們在 $/baseobjects Team Foundation 版本控制伺服器資料夾中所有項目的本機複本。
c:\projects>tf permission /allow:PendChange /group:[teamproject]\leads $/baseobjects
下列範例針對 "developers" 群組的成員從 $/baseobjects 資料夾移除所有與權限相關的設定。
c:\projects>tf permission /remove:* /group:developers $/baseobjects
下列範例讓 "testers" 群組能變更他們在 $/testproject 中所有項目的本機複本。
c:\projects>tf permission /allow:PendChange /group:testers$/testproject
下列範例讓使用者 somealias 可對其工作區內的 $/testtproject/314.cs 本機複本進行暫止的變更。
c:\projects>tf permission /allow:PendChange /user:somealias $/testproject/314.cs.
下列範例會拒絕讓使用者 somealias 對其 $/testproject/1256.cs 的本機複本進行暫止的變更。
c:\projects>tf permission /deny:PendChange /user:somealias $/testproject/1256.cs