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