Remove-TeamViewerUserGroupMember.md

---

external help file: TeamViewerPS-help.xml Module Name: TeamViewerPS online version: https://github.com/teamviewer/TeamViewerPS/blob/main/Docs/Help/Remove-TeamViewerUserGroupMember.md schema: 2.0.0

Remove-TeamViewerUserGroupMember

SYNOPSIS

Deletes members from a given user group.

SYNTAX

ByUserGroupMemberId (All)

Remove-TeamViewerUserGroupMember [-APIToken] <SecureString> [-UserGroup] <Object> [-UserGroupMember] <Object[]> [-WhatIf] [-Confirm] [<CommonParameters>]

ByUserId

Remove-TeamViewerUserGroupMember [-APIToken] <SecureString> [-UserGroup] <Object> [-UserGroupMember] <Object[]> [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Deletes one or many members from a user group. User group should belong to the TeamViewer company associated with the API access token.

EXAMPLES

Example 1

Remove-TeamViewerUserGroupMember -UserGroup 1001 -UserGroupMember @(123, 456, 789)

Removes the accounts 123, 456, 789 from the group with id 1001.

Example 2

@(123, 456, 789) | Remove-TeamViewerUserGroupMember -UserGroup 1001

Removes the accounts 123, 456, 789 from the group with id 1001. Ids are passed as pipeline input.

Example 3

Remove-TeamViewerUserGroupMember -UserGroup 1001 -UserGroupMember @('u123', 'u456', 'u789')

Removes the users u123, u456, u789 from the group with id 1001.

Example 4

Get-TeamViewerUserGroupMember -UserGroup 1001 | Remove-TeamViewerUserGroupMember -UserGroup 1001

Removes all the users from the group with id 1001. Ids are passed as pipeline input.

PARAMETERS

-APIToken

The TeamViewer API access token.

Type: SecureString
Parameter Sets: (All)
Aliases:

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-UserGroup

The group where members will be removed from.

Type: Object
Parameter Sets: (All)
Aliases: Id, UserGroupId

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

-UserGroupMember

User group members to be removed from a user group.

Type: Object[]
Parameter Sets: (ByUserGroupMemberId)
Aliases: UserGroupMemberId, MemberId, UserId, User, UserGroupMemberIds, MemberIds, UserIds

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

System.Object

System.Int32[]

An array of account Ids.

OUTPUTS

NOTES

RELATED LINKS