Permission 命令
更新：2007 年 11 月
修改使用者存取控制清單 (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,…]] [/server:servername]
[/recursive] itemspec [/global]
參數
引數 |
描述 |
|---|---|
perm |
要修改的權限或角色的名稱。如需使用權限名稱的詳細資訊，請參閱 Team Foundation Server 使用權限。 |
Username |
提供 /user 選項的值。根據網路設定，使用者名稱值可以用兩種方式表示：DOMAIN\username 或 username。 |
Groupname |
/group 選項的使用者提供值。 |
Servername |
/server 選項的使用者提供值。範例：teamfoundation2。 |
Itemspec |
辨別要為其修改權限的檔案或資料夾。如需 Team Foundation 如何剖析itemspecs以便判斷哪些項目位於範圍內的詳細資訊，請參閱命令列語法 (Team System)。 |
選項 |
描述 |
|---|---|
/allow |
指定要加入至允許 ACL 的 Team Foundation 版本控制權限清單。 |
/deny |
指定要加入至使用者存取控制清單的拒絕 Team Foundation 版本控制存取權限。 |
/remove |
指定要同時從允許和拒絕 ACL 移除的 Team Foundation 版本控制權限清單。 |
/inherit |
如果選取 yes，則項目會繼承與父 ACL 關聯的所有權限。無法與 /remove 選項結合。 |
/user |
指定要為其修改權限的使用者名稱。 |
/group |
要為其修改權限的群組名稱。 |
/server |
辨別 Team Foundation Server。如果此命令是從尚未對應至工作區的目錄叫用，就會需要這個選項。 |
/recursive |
將指定的命令套用至目錄及任何子目錄中的所有項目。 只有在原始碼結構中檢視項目的權限時，/recursive 選項才有作用。在搭配如 /allow、/deny 和 /remove 選項設定權限時，則這個選項不會有作用。 |
/global |
用於檢視或指派任何 Team Foundation 伺服器權限。 若要指派權限，請使用 /allow、/deny 或 /remove 選項。 不需要引數 itmespec。如果仍列出該引數，則會被忽略。 當用於檢視 Team Foundation 伺服器權限時，所列出的五個權限如下：
如需使用權限的詳細資訊，請參閱 Team Foundation Server 使用權限。 |
備註
您可以使用 permission 命令 (或使用簡寫 perm) 指定可以針對哪位使用者或使用者群組授與權限。
您可以使用 permission 命令來管理 Team Foundation 版本控制伺服器物件的授權設定。不過，這個命令無法讓您管理例如建立或修改 Team Foundation 安全性群組的驗證設定。
如需如何尋找 tf 命令列公用程式的詳細資訊，請參閱 Tf 命令列公用程式命令。
範例
下列範例顯示 314.cs 的 Team Foundation 存取控制清單 (ACL)。
c:\projects>tf permission 314.cs
下列範例會顯示與 teamserver2 Team Foundation Server 之 "developers" 群組相關的 ACL 資訊。
c:\projects>tf permission /group:[teamproject]\developers /server:teamserver2
下列範例讓 "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
請參閱
工作
逐步解說：從命令列使用 Team Foundation 版本控制