NAME

Add-DcsHostToGroup

SYNOPSIS

Adds a client (host) to an existing host group.

SYNTAX

Add-DcsHostToGroup   -Group <String>   -Client <Object>   [ -Connection <String> ]   [ -PipelineVariable <String> ]

DESCRIPTION

Adds a client (host) to an existing host group.

PARAMETERS

-Group<String>
Name of the host group to add the clients to.

Required: true
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-Client<Object>
ClientHostData object, name, or ID that identifies the client to add to the host group.

Required: true
Position: named
Default value:
Accept pipeline input: true (ByValue)
Accept wildcard characters: false

-Connection<String>
Alias of the connection to the server group. If not specified, the default connection will be used.

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-PipelineVariable<String>

Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

INPUTS

ClientHostData : Object that identifies and describes the client host.

OUTPUTS

ClientHostData : Object that identifies and describes the client host.

NOTES

Also see: Add-DcsHostGroup, Get-DcsHostGroup, Remove-DcsHostGroup, Remove-DcsHostFromGroup, Set-DcsHostGroupProperties.

EXAMPLES


-------------- Example 1 Adds a single client to the group using the name of the client. --------------
Add-DcsHostToGroup -Group "FinanceGroup1" -Client "HostVM1"
			

The client named "HostVM1" is added to the host group named "FinanceGroup1".

HostGroupId:{9c1ea090-8af9-4207-93af-0864e2d99a94}
Type:WindowsServer2008
State:PortsConnected
MpioCapable:True
AluaSupport:False
PathPolicy:PreferredServer
PreferredServerId:
Description:
HostName:HostVM1
Sequencenumber:3236
Id:79ad9e209d68427c97edb01b6aa56e35
Caption:HostVM1
ExtendedCaption:HostVM1
Internal:False
   

-------------- Example 2 Adds all clients to a host group by passing objects. --------------
Get-DcsClient | Add-DcsHostToGroup -Group "HostGroup1"
			

The cmdlet Get-DcsClient is invoked to obtain the ClientHostData objects for all clients in the default connection of the server group. The objects are piped to the cmdlet Add-DcsHostToGroup to add all clients to the host group named "HostGroup1". The ClientHostData objects for the two clients are returned.

HostGroupId:{c45a88ba-fb29-4e7f-b607-02e29dceb166}
Type:WindowsServer2008
State:PortsConnected
MpioCapable:True
AluaSupport:False
PathPolicy:PreferredServer
PreferredServerId:
Description:
HostName:HostVM1
Sequencenumber:4571
Id:79ad9e209d68427c97edb01b6aa56e35
Caption:HostVM1
ExtendedCaption:HostVM1
Internal:False
   
HostGroupId:{c45a88ba-fb29-4e7f-b607-02e29dceb166}
Type:WindowsServer2008
State:PortsConnected
MpioCapable:True
AluaSupport:False
PathPolicy:PreferredServer
PreferredServerId:
Description:
HostName:HostVM2
Sequencenumber:4573
Id:4e18b7c089c94eda802f689cd253f80a
Caption:HostVM2
ExtendedCaption:HostVM2
Internal:False