TFSLabConfig DeleteTeamProjectHostGroup Command

Visual Studio Team Foundation Server 2012

Use the DeleteTeamProjectHostGroup command to remove the assignment of a host group from an individual team project. Host groups specify one or more physical machines that are the deployment targets for virtual environments in Visual Studio Lab Management.

Host groups are created in System Center Virtual Machine Manager (SCVMM). In Lab Management, host groups are assigned to one or more team project collections and then to one or more team projects in the collections. The DeleteTeamProjectHostGroup command does not remove the assignment of the host group to the team project collection.

Required Permissions

To use the DeleteTeamProjectHostGroup command, you must have Delete Lab Locations permission for the Team Project host group. By default, Team Foundation Server Administrators, Team Project Collection Administrators and Team Project Administrators have this permission. For more information, see Team Foundation Server Permissions.

TFSLabConfig DeleteTeamProjectHostGroup
      /Collection:collectionUrl
      /TeamProject:{* |teamProjectName>}
      /Name:{* |teamProjectHostGroupName}
      [/NoPrompt]

Parameters

Option

Description

Collection:collectionUrl

Required. The URL of the team project collection on the application tier of Team Foundation Server that contains the team project. For example, /collection:http://abc:8080/TFS/DefaultCollection.

TeamProject:{* |teamProjectName}

Required. The name of the team project from which you want to remove the host group. Use quotation marks if there are spaces in the name. Use an asterisk (*) to specify all team projects in the team project collection.

Name:{* |teamProjectHostGroupName}

Required. The name of the host group to delete from a team project. Use quotation marks if there are spaces in the name. Use an asterisk (*) to specify all host groups in the team project.

NoPrompt

Optional. Do not prompt the user for confirmation.

Example

For increased readability in the example, command options are listed on separate lines. In a command prompt window, type all options for a command on the same line.

In the first example, all the host groups assigned to each of the team project in the team project collection are removed. In the second example, one host group is removed from a specific team project.

 Copy imageCopy Code
REM First example
TFSLabConfig DeleteTeamProjectLibraryShare
    /collection:http://abc:8080/TFS/DefaultCollection
    /teamProject:*
    /name:*

REM Second example
TFSLabConfig DeleteTeamProjectLibraryShare
    /collection:http://abc:8080/TFS/DefaultCollection
    /teamProject:Project1
    /name:hg1

See Also