< Back

Update-TeamviewerDevice

Sat Jan 18, 2020 8:01 pm

NAME Update-TeamviewerDevice



SYNOPSIS

Updates Properties of a Teamviewer Device.





SYNTAX

Update-TeamviewerDevice [-ComputerName] <String> [[-Description] <String>] [[-Alias] <String>] [[-Password]

<String>] [[-AccessToken] <SecureString>] [-UpdateDeviceList] [<CommonParameters>]





DESCRIPTION

Updates Properties of a Teamviewer Device. Those properties are Alias(Device's Name), Description, and Password.





PARAMETERS

-AccessToken <SecureString>

The Teamviewer AccessToken



Required? false

Position? 4

Default value

Accept pipeline input? False

Accept wildcard characters? false



-Alias <String>

The new Name of the Device.



Required? false

Position? 2

Default value

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-ComputerName <String>

The Name of the Device.



Required? true

Position? 0

Default value

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Description <String>

The Description of the Device.



Required? false

Position? 1

Default value

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Password <String>

The new Password for the Device. This is not the Password set by the Client, but the one saved in Teamviewer

for connecting without a Password.



Required? false

Position? 3

Default value

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-UpdateDeviceList [<SwitchParameter>]

Update the Devices List Global Variable that the Device information is stored. Teamviewer accounts with a

large device list can take a very long time to send a response back with Device Ids. To get around this Device

information is gathered and stored when Initialize-Teamviewer is ran to decrypt the Teamviewer Access Token.

This allows quick Device information look up.



Required? false

Position? named

Default value False

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.String

System.Management.Automation.SwitchParameter





OUTPUTS

System.Object







NOTES









-------------------------- EXAMPLE 1 --------------------------



PS C:\\> Update-TeamviewerDevice -ComputerName 'Test1' -Description 'Test Lab Device 1' -Alias 'Test1 (Test Lab)'



This command updates the Teamviewer Description and Alias of the Device named 'Test1'.

-------------------------- EXAMPLE 2 --------------------------



PS C:\\> Update-TeamviewerDevice -ComputerName 'Test1' -Password $NewPassword



This command updates the Teamviewer Password of the Device named 'Test1'.



RELATED LINKS

Online Version http://posh-teamviewer.readthedocs.io/e ... eviceList/

Markdown Version https://github.com/gerane/Posh-Teamview ... iceList.md

Documentation https://readthedocs.org/projects/posh-teamviewer/

PSGallery https://www.powershellgallery.com/packa ... eamviewer/

Create Teamviewer Access Token https://integrate.teamviewer.com/en/dev ... eateScript

Teamviewer Api Documentation: https://integrate.teamviewer.com/en/develop/api/