群組和權限外掛程式

發行項
08/12/2011

更新：2011 年 4 月

您可以定義安全性群組來控制對 Team 專案中功能區域的存取。除了 Visual Studio Team Foundation Server 中的預設安全性群組之外，您還可以自訂 Groups and Permissions 外掛程式來設定 Team 專案初始的群組、群組成員和安全性權限。您可以使用此外掛程式定義群組、將群組和使用者當做成員新增到群組中，以及將權限授與群組。

本主題描述用於 Groups and Permissions 外掛程式檔案之 groups、members 和 permissions 項目的語法結構。如需如何使用這些項目的詳細資訊，請參閱設定初始群組、成員和使用權限。

本主題內容

Groups 外掛程式的名稱和位置
定義群組
定義成員
定義權限
群組項目參考

Groups 外掛程式的名稱和位置

Groups and Permission 外掛程式是由 GroupsandPermissions.xml 外掛程式檔案所定義，這個檔案必須符合 Gss.xsd 檔案中所定義的結構描述定義。您可以從 Microsoft 網站的下列頁面下載流程範本的結構描述檔案：Visual Studio Team Foundation 的流程範本和工作項目 (英文)。

下表摘要列出 Microsoft Solutions Framework (MSF) 流程範本之檔案、資料夾和外掛程式的名稱。

檔案名稱：	GroupsandPermissions.xml
資料夾名稱：	Groups and Permissions
外掛程式名稱：	Microsoft.ProjectCreationWizard.Groups

注意事項
您可以變更 XML 檔案和資料夾的名稱，但無法變更外掛程式的名稱。 Visual Studio Team Foundation Server 並未包含部署用戶端外掛程式、原則或其他修改的機制。如果您想要部署這種功能，就必須使用您自己的散發與安裝程式。

在 Groups and Permissions 外掛程式中，您可以在 taskXml 項目中指定一個或多個工作及其相依性。一般而言，您要替每個安全性群組指定一項工作，以便針對流程來建立。如需如何指定工作的詳細資訊，請參閱定義要處理外掛程式的工作。

回到頁首

定義群組

您可以使用 group 項目指定 Team Foundation Server 中新的安全性群組。

<group name="GroupName" description="GroupDescription"></group>

下面範例將示範如何建立名為 Reader 的群組：

<task id="GroupCreation1" 
      name="Create Groups and Permissions" 
      plugin="Microsoft.ProjectCreationWizard.Groups" 
      completionMessage="Groups and Permissions created.">
   <taskXml>
      <groups>
         <group name="Readers"
                description="A group for users who have read access across the project">
            <permissions>
               <!-- permissions -->
            </permissions>
         </group>
      </groups>
   </taskXml>
</task>

回到頁首

定義成員

您可以使用 member 項目將群組指派為 Team Foundation Server 中安全性群組的成員。

<member name="MemberName" ></member>

下面範例示範如何將 TestGroup1 加入為 TestGroup2 的成員。

<task id="GroupCreation1" 
    <taskXml>
      <groups>
        <group name="TestGroup1" description="Test group 1.  Contains no members out of the box.">
          <permissions>
            <permission name="GENERIC_READ" class="PROJECT" allow="true" />
          </permissions>
        </group>
        <group name="TestGroup2" description="Test group 2.  Contains TestGroup1 and Project Administrators.">
          <permissions>
            <permission name="GENERIC_READ" class="PROJECT" allow="true" />
          </permissions>
          <members>
            <member name="TestGroup1" />
            <member name="$$PROJECTADMINGROUP$$" />
          </members>
        </group>
      </groups>
    </taskXml>
</task>

回到頁首

定義權限

您必須為每個建立的群組指定權限。請使用 permission 項目來達成此目的。

<permission name="PermissionName" class="ClassName" allow="true | false"/>

下面範例將示範如何將權限授與 Reader 安全性群組，讓其成員只能檢視 Team 專案的相關資訊，而不能進行修改。

<group name="Readers" description="A group for users who have read access across the project">
   <permissions>
     <permission name="GENERIC_READ" class="PROJECT" allow="true" />
     <permission name="GENERIC_READ" class="CSS_NODE" allow="true" />
     <permission name="WORK_ITEM_READ" class="CSS_NODE" allow="true" />
   </permissions>
</group>

回到頁首

群組項目參考

下表描述您用於定義 Team 專案之初始群組和權限的項目。您可以在 Groups and Permissions 外掛程式檔案的 taskXml 容器項目中指定這些項目。如需此項目的詳細資訊，請參閱定義要處理外掛程式的工作。

警告

Gss.xsd 結構描述檔案不會定義 property 或 properties 項目。當您上傳流程範本時，流程範本管理員會先驗證這些項目，然後再將其儲存在 Team Foundation Server 中。

groups 和 group (群組和權限) 項目與 groups 和 group (流程範本) 項目不同。如需後面一組項目的詳細資訊，請參閱ProcessTemplate XML 項目參考。


group	`<group name="GroupName" description="GroupDescription"> <permissions> . . . </permissions> <members> . . . </members> </group>`	group 是 groups 和 Children 的選擇性子項目。定義群組及其權限。您必須同時指定 name 和 description 屬性。群組名稱的長度必須為 1 到 255 個字元。
groups	`<groups> <group> . . . </group> </groups>`	groups 對於 Groups and Permissions 外掛程式，是 taskXml 的必要子項目。包含群組和權限定義。
member	`<member name="MemberName" ></member>` 如需如何指定預設群組的詳細資訊，請參閱Team Foundation Server 中定義的群組巨集和預設群組。	member 是 members 的必要子項目。指定加入為另一個群組成員的群組名稱。您可以建立群組，並將這些群組自動填入 Team Foundation Server 中的預設群組、先前定義的專案群組，以及 Active Directory 中的群組和使用者。
members	`<members> <member> . . . </member> </members>`	members 是 group 的選擇性子項目。指定要新增到群組之成員的集合。
permission	`<permission name="PermissionName" class="ClassName" allow="true \| false" />` 其中下列定義適用於每個屬性： name：必要項。指定權限的名稱。如需詳細資訊，請參閱設定初始群組、成員和使用權限中，描述您可以指定為權限之每個類別和名稱組合的表格。 class：必要項。識別授與群組使用權限的類別或區域。以下為有效值：NAMESPACE (集合層級)、PROJECT (專案層級)、CSS_NODE (區域節點)、ITERATION_NODE (反覆項目節點) 以及 EVENT_SUBSCRIPTION (警示設定)。 allow：選擇項。指定 true 或 false 值，這個值會指出您是否有權限。	permission 是 permissions 的必要子項目。指定要套用到群組的使用權限。
permissions	`<permissions > <permission> . . . </permissions> </permissions >`	permissions 是 group 的必要子項目。指定要套用到群組的權限集合。