/gcg Command

Use the /gcg command to create a server-level or collection-level group. To create a server-level or collection-level group from the user interface, see Manage users in TFS.

Required Permissions

To use the /gcg command, you must have the Edit project-level information permission for that team project set to Allow. For more information, see Team Foundation Server permissions.

TFSSecurity /gcg GroupName [GroupDescription] [/collection:CollectionURL] [/server:ServerURL]

Argument

Description

GroupName

The group name.

GroupDescription

A description of the group. Optional.

/collection :CollectionURL

Required if /server is not used. Specifies the URL of a team project collection in the following format: http://ServerName:Port/VirtualDirectoryName/CollectionName

/server :ServerURL

Required if /collection is not used. Specifies the URL of an application-tier server in the following format: http://ServerName:Port/VirtualDirectoryName

Run this command on an application-tier server for Team Foundation.

Server-level groups are created directly on the application tier and apply to all team project collections. Collection-level are created at the team project collection level. They apply to that collection and have implications for all team projects within the collection. In contrast, team project groups apply to a specific project within a collection but not any other projects in that collection. You can assign permissions to server-level groups so that members of those groups can perform tasks in Team Foundation Server (TFS) itself, such as creating team project collections. You can assign permissions to collection-level groups so that members of those groups can perform tasks across a team project collection, such as administering users.

Note Note

You can use the /gcg command to create groups, but you cannot use it to add any users to the groups or assign any permissions. For information about how to change the membership of a group, see /g+ Command and /g- Command. For information about how to change the permissions for the group, see /a+ Command and /a- Command.

The following example creates a collection-level group that is named "Datum Testers" with the description "A. Datum Corporation Testers."

Note Note

The examples are for illustration only and are fictitious. No real association is intended or inferred.

>TFSSecurity /gcg "Datum Testers" "A. Datum Corporation Testers" /collection:CollectionURL

The following example creates a server-level group that is named "Datum Auditors" with the description "A. Datum Corporation Auditors."

>TFSSecurity /gcg "Datum Auditors" "A. Datum Corporation Auditors" /server:ServerURL
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft