/gun command: Rename a group

Use /gun to rename a server-level or collection-level group.

Required Permissions

To use the /gun 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 /gun GroupIdentity GroupName [/collection:CollectionURL] [/server:ServerURL]





Specifies the group identity. For more information about valid identity specifiers, see TFSSecurity Identity and Output Specifiers.


Specifies the new name of the group.


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


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.


The following example renames the collection-level group "A. Datum Corporation Testers" to "A. Datum Corporation Test Engineers."


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

>tfssecurity /gun "A. Datum Corporation Testers" "A. Datum Corporation Test Engineers" /collection:CollectionURL

See Also


TFSSecurity Identity and Output Specifiers

Other Resources

Change groups and permissions with TFSSecurity

How To: Rename a Team Project Group

How to: Rename a Global Group