/gcg command: Create a server or collection-level group

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 or groups 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 Permission reference for Team Foundation Server.

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

Parameters

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

Remarks

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

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: Add a user or another group to an existing group and /g- command: Remove a user or group. For information about how to change the permissions for the group, see /a+ command: Add permissions and /a- command: Remove a user or a group from membership in a group.

Example

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

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

See Also

Other Resources

Change groups and permissions with TFSSecurity