/gd command: Delete a server or collection-level group

Use /gd to delete a server-level or collection-level group.

Required Permissions

To use the /gd command, you must have the View collection-level information and Edit collection-level information or the View instance-level information and Edit instance-level information permissions set to Allow, depending on whether you are using the /collection or /server parameter, respectively. For more information, see Permission reference for Team Foundation Server.

TFSSecurity /gd groupIdentity [/collection:CollectionURL] [/server:ServerURL]

Parameters

Argument

Description

groupIdentity

Specifies the group identity. For more information about valid identity specifiers, see Change groups and permissions with TFSSecurity.

/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.

You can also remove groups on Team Explorer. For more information, see How to: Remove a Global Group and How To: Remove a Team Project Group.

Example

The following example deletes a group from the team project collection. The group is identified by "S-1-5-21-2127521184-1604012920-1887927527-588340", the security identifier (SID). For more information about finding the SID of a group, see /im command: Display information about identities that compose direct membership. You can also use the friendly name to delete a group.

Note

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

>TFSSecurity /gd S-1-5-21-2127521184-1604012920-1887927527-588340 /collection:CollectionURL

See Also

Other Resources

Change groups and permissions with TFSSecurity

How to: Create a Global Group

Team Project Groups

Default Groups