Install-Group

Creates a new local group, or updates the settings for an existing group.

Syntax

Install-Group [-Name] <String> [[-Description] <String>] [[-Member] <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

Description

Creates a new group with a description and default set of members. If a group with the same name already exists, it updates the group's description and adds the given members to it.

Parameters

Name Type Description Required? Pipeline Input Default Value
Name String The name of the group. true false
Description String A description of the group. false false
Member String[] Members of the group. false false @()
WhatIf SwitchParameter false false
Confirm SwitchParameter false false
CommonParameters This cmdlet supports common parameters. For more information type
Get-Help about_CommonParameters.

EXAMPLE 1

Install-Group -Name TIEFighters -Description 'Users allowed to be TIE fighter pilots.' -Members EMPIRE\Pilots,EMPIRE\DarthVader

If the TIE fighters group doesn't exist, it is created with the given description and default members. If it already exists, its description is updated and the given members are added to it.