| external help file | TeamViewerPS-help.xml |
|---|---|
| Module Name | TeamViewerPS |
| online version | https://github.com/teamviewer/TeamViewerPS/blob/main/Docs/Help/Remove-TeamViewerUserFromRole.md |
| schema | 2.0.0 |
Un-assigns one or many users from a role.
Remove-TeamViewerUserFromRole [-ApiToken] <SecureString> [-RoleId] <Object[]> [-Account] <Object>
[-WhatIf] [-Confirm] [<CommonParameters>]Remove-TeamViewerUserFromRole [-ApiToken] <SecureString> [-RoleId] <Object> [-Account] <Object[]>
[-WhatIf] [-Confirm] [<CommonParameters>]Un-assigns one or many users from a role. A role belongs to the TeamViewer company associated with the API access token.
PS /> Remove-TeamViewerUserFromRole -RoleId '9b465ea2-2f75-4101-a057-58a81ed0e57b' -Account @('123', '456', '789')Un-assigns users with id 123, 456, 789 from the role with id 9b465ea2-2f75-4101-a057-58a81ed0e57b.
PS /> @('123', '456', '789') | Remove-TeamViewerUserFromRole -RoleId '9b465ea2-2f75-4101-a057-58a81ed0e57b'Un-assigns users with id 123, 456, 789 from role with id 9b465ea2-2f75-4101-a057-58a81ed0e57b.
Ids are passed as pipeline input.
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: FalsePrompts 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: FalseThe role where users will be unassigned from.
Type: Object
Parameter Sets: (All)
Aliases: Role
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseUsers to be unassigned from a user role.
Type: Object[]
Parameter Sets: (All)
Aliases: Id, UserId
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseShows 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: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
An array of account Ids.