TFSConfig Lab /HostGroup Commands
You can use the TfsConfig Lab /HostGroup commands to add, edit, or delete the assignment of a System Center Virtual Machine Manager (SCVMM) host group to a team project collection. Host groups that are assigned in this manner are managed by Visual Studio Lab Management.
TfsConfig Lab /hostgroup /CollectionName:collectionName
{ /Add
/SCVMMHostGroup:vmmHostPath
/Name:name
[LabEnvironmentPlacementPolicy:{Conservative|Aggressive}]
[/AutoProvision:{True|False}]
[/DNSSuffix:dnsSuffix]
| /Delete
/Name:name
[/NoPrompt]
| /Edit
/Name:name
{[/AutoProvision:{True|False}]
[/LabEnvironmentPlacementPolicy:{Conservative|Aggressive}]
[/DNSSuffix:dnsSuffix]}
[/NoPrompt]]
| /List
| /ListSCVmmHostGroups }
Parameters
Option |
Description |
|---|---|
CollectionName:collectionName |
Required. The name of the team project collection on the application-tier Team Foundation Server. |
Add |
Adds the specified SCVMM host group to the team project collection host groups. You must specify the /SCVmmHostGroup and /Name options with Add. |
Delete |
Removes the specified host group from the team project collection. You must specify the /Name option with Delete. |
Edit |
Sets one or both of the Lab Management AutoProvision and LabEnvironmentPlacementPolicy properties for the host group. You must specify the /Name option and at least one of the /AutoProvision or /LabEnvironmentPlacementPolicy options with Edit. |
SCVMMHostGroup:vmmHostGroupPath |
Required with the /Add option. Specifies the host path of the SCVMM host group. |
Name:name |
Required with the /Add, /Delete, or /Edit options. Specify the name of the team project collection host group to add, delete, or edit. |
AutoProvision:{True|False} |
Optional with the /Add or /Edit options. Sets (True) or clears (False) the AutoProvision property of the host group. AutoProvision specifies whether the host group is automatically assigned to each team project in the collection. By default, host groups are assigned to the team projects in a collection when you use the TfsConfig Lab/HostGroup command. |
LabEnvironmentPlacementPolicy:{Conservative|Aggressive} |
Optional with the /Add or /Edit options. Specifies how Lab Management treats the physical machines in a host group on which it deploys new virtual lab environments.
|
DNSSuffix:[dnsSuffix] |
Optional. Sets or the DNS suffix of the virtual computers in the host group.
|
NoPrompt |
Optional with the /Delete or /Edit options. Do not prompt user for confirmation. |
List |
Displays the host groups assigned to the team project collection. |
ListSCVmmHostGroups |
Displays the host groups available from SCVMM. |
Remarks
Host groups are containers that an administrator creates within SCVMM to group a set of virtual machine hosts for easy management. Host groups are hierarchical; a host group can contain other host groups.
Each host group is identified by its host path, a sequence of host group names that specifies the location of a host or host group within the hierarchy of host groups in SCVMM. All host paths begin with the root host group. For example, the host path All Hosts\New York\Site21\VMHost05 indicates that the host VMHost05 belongs to the host group Site21, which is a child host group of the host group New York.
Use only one of the /Add, /Delete, or /Edit options on a command line. Use separate TfsConfig Lab /HostGroup command lines to assign multiple host groups to a team project collection.
You can also use TfsConfig Lab /HostGroup commands to set properties that are specific to Lab Management:
AutoProvision specifies whether the host group is assigned to each team project in the team project collection. By default, AutoProvision is on. To assign a host group in a project collection to an individual team project, use the TFSLabConfig CreateTeamProjectHostGroup Command.
True (Default). The host group is assigned to each team project in the team project collection.
False. The host group is not assigned to each team project in the team project collection.
LabEnvironmentPlacementPolicy specifies whether Lab Management considers the existing virtual machines when it deploys new environments on a physical machine in a host group.
Conservative (Default). Consider non-running virtual environments in deployment decisions. This includes all virtual machines that are part of environments and that are in "Stopped" state also.
Aggressive Do not consider non-running virtual environments in deployment decisions.
DNSSuffix specifies a DNS suffix to use for the virtual computers created in the host group. The following table describes how the DNS suffixes of virtual computers are affected by the /DNSSuffix setting.
DNSSuffix
/Add
/Edit
DNSSuffix:dnsValue
The DNS suffix is set to dnsValue.
The DNS suffix is set to dnsValue.
DNSSuffix:
The DNS suffix is inherited from host computer.
The existing suffix value is removed and the DNS suffix is inherited from host computer.
<Not Specified>
The DNS suffix is inherited from host computer.
DNS suffix not changed.
Example
In the following example a SCVMM host group is assigned to a team project collection. Because the /AutoProvision options is not specified, the host group is automatically assigned to all team projects in the collection.
tfsconfig lab /hostgroup /add /scvmmhostgroup:"All Hosts\Lab1\HostGroup1" /collection:Collection0 /name:Lab1Collection0_Lab1_HostGroup1
See Also
Reference
TFSConfig Lab /Settings Commands
TFSConfig Lab /LibraryShare Commands
TFSConfig Lab /HostGroup Commands
Concepts
TFSConfig Lab Command Reference
TFSLabConfig Command Reference
Configure and administer Lab Management