Share via


/gcg Command

Use /gcg at a command prompt to create a server-level or collection-level group. To create a server-level or collection-level group from the user interface, see Configuring Users, Groups, and Permissions.

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]

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 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 and /g- Command. For information about how to change the permissions for the group, see /a+ Command and /a- Command.

Example

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

Note

The example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted herein are fictitious.  No association with any real company, organization, product, domain name, email address, logo, person, places, or events is intended or should be 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

Tasks

Create a Collection-Level Group

Other Resources

Changing Groups and Permissions with TFSSecurity

Project-Level Groups

Default Groups