/gun Command

Visual Studio Team Foundation Server 2012

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 Team Foundation Server Permissions.

TFSSecurity /gun GroupIdentity GroupName [/collection:CollectionURL] [/server:ServerURL]

Parameters

Argument

Description

GroupIdentity

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

GroupName

Specifies the new name of the group.

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

Example

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

NoteNote

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

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

See Also

Concepts

Other Resources

How To: Rename a Team Project Group
How to: Rename a Global Group