external help file: PSTeamViewer-help.xml Module Name: PSTeamViewer online version: schema: 2.0.0


Set-TVUser

SYNOPSIS

Modify an existing Teamviewer user

SYNTAX

ByIdentity

Set-TVUser [-Token <String>] -Identity <TVUser> [-Name <String>] [-Email <String>] [-Permissions <String[]>]
 [-Password <SecureString>] [-Active <Boolean>] [-QuickJoinID <String>] [-QuickSupportID <String>]
 [<CommonParameters>]

ById

Set-TVUser [-Token <String>] -UserID <String> [-Name <String>] [-Email <String>] [-Permissions <String[]>]
 [-Password <SecureString>] [-Active <Boolean>] [-QuickJoinID <String>] [-QuickSupportID <String>]
 [<CommonParameters>]

DESCRIPTION

Modify an existing Teamviewer User

EXAMPLES

EXAMPLE 1

Set-TVUser -Token $Env:TeamViewerToken -UserID 'u123456789' -Name 'Doe, John'

Sets the name of user with ID: u123456789 to 'Doe, John'

EXAMPLE 2

Get-TVUser -Token $Env:TeamViewerToken -UserID 'u123456789' | Set-TVUser -Token $Env:TeamViewerToken -Name 'Solo, Han'

Changes the name of user with ID: u123456789 to 'Solo, Han'

PARAMETERS

-Token

The Teamviewer API token generated on the Teamviewer Management console (https://login.teamviewer.com)

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: $script:TVConfig.AccessToken
Accept pipeline input: False
Accept wildcard characters: False

-Identity

a TVUser Object fetched by Get-TVUser

Type: TVUser
Parameter Sets: ByIdentity
Aliases:

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

-UserID

The userID of a Teamviewer user

Type: String
Parameter Sets: ById
Aliases:

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

-Name

The new name of the Teamviewer user

Type: String
Parameter Sets: (All)
Aliases:

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

-Email

The new email address of the Teamviewer user

Type: String
Parameter Sets: (All)
Aliases:

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

-Permissions

a list of Permissions to add to the user account

Type: String[]
Parameter Sets: (All)
Aliases:

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

-Password

The password for the Teamviewer user

Type: SecureString
Parameter Sets: (All)
Aliases:

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

-Active

Indicates that the user should be active or not

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-QuickJoinID

The QuickJoinID for the Teamviewer user

Type: String
Parameter Sets: (All)
Aliases:

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

-QuickSupportID

The QuickSupportID for the Teamviewer user

Type: String
Parameter Sets: (All)
Aliases:

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 (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

TVUser. The output of the Get-TVUser CmdLet.

OUTPUTS

TVUser. The TVUser object that was modified.

NOTES

Get-TVUser

New-TVUser