Skip to main content

Add-MemberToGroup

SYNOPSIS​

Adds a user to a group.

SYNTAX​

Add-MemberToGroup [-Group] <Object> [-Username] <Object> [-ProgressAction <ActionPreference>]
 [<CommonParameters>]

DESCRIPTION​

This function will add a user to a group.

EXAMPLES​

EXAMPLE 1​

This will add the user localadmin to the Administrators group.

Add-MemberToGroup -Group (Get-Group -Name 'Administrators') -Username 'localadmin';

PARAMETERS​

-Group​

The group to add the user to.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Username​

The username to add to the group.

Type: Object
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction​

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters​

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS​

OUTPUTS​

[Boolean] - $True if the user was added to the group, otherwise $False.​

NOTES​

This function is designed to work with the ADSI provider for the local machine. It will not work with remote machines or other providers.