NAME
Add-DcsHostGroup
SYNOPSIS
Creates a host group.
SYNTAX
Add-DcsHostGroup -Name <String> [ -Description <String> ] [ -Connection <String> ] [ -PipelineVariable <String> ]
DESCRIPTION
Creates a host group. After creating the group, add hosts to the group, see Add-DcsHosttoGroup.
PARAMETERS
- -Name<String>
- Name of the Host Group to create.
-
- Required: true
- Position: 1
- Default value:
- Accept pipeline input: true (ByValue)
- Accept wildcard characters: false
-
- -Description<String>
- Description of the host group.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- 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
string : Name of host group.
OUTPUTS
HostGroupData : The object that identifies and describes the host group.
NOTES
Also see Add-DcsHostToGroup, Get-DcsHostGroup, Remove-DcsHostGroup, Remove-DcsHostFromGroup, Set-DcsHostGroupProperties.
EXAMPLES
-------------- Example 1 Create a host group. --------------
Add-DcsHostGroup -Name FinanceGroup1 -Description "A collection of hosts that serve the Finance Department for Region 1."
A host group named "FinanceGroup1" is created in the server group of the default connection. A description of the host group is also provided.
| Alias | : | FinanceGroup1 |
| Description | : | A collection of hosts that serve the Finance Department for Region 1. |
| Sequencenumber | : | 3200 |
| Id | : | {9c1ea090-8af9-4207-93af-0864e2d99a94} |
| Caption | : | FinanceGroup1 |
| ExtendedCaption | : | FinanceGroup1 |
| Internal | : | False |