Skip to content

TeamViewerPS allows to interact with the TeamViewer Web API as well as a locally installed TeamViewer client.

License

Notifications You must be signed in to change notification settings

teamviewer/TeamViewerPS

Repository files navigation

TeamViewerPS

CI

TeamViewerPS allows to interact with the TeamViewer Web API as well as a locally installed TeamViewer client.

Installation & Update

Install TeamViewerPS from the Powershell Gallery using the following command:

Install-Module TeamViewerPS

Execute the following command to update an existing installation of TeamViewerPS:

Update-Module TeamViewerPS

Usage

The following example code shows how to interact with the TeamViewer Web API functions by retrieving the list of users of a TeamViewer company:

# Downloads and installs the module from Powershell Gallery
Install-Module TeamViewerPS

# Stores API token for future usage
# 1. Create a TeamViewer API access token in the Management Console: https://login.teamviewer.com
# 2. Enter the API token in the shown dialog
Connect-TeamViewerApi -ApiToken (Read-Host -Prompt 'Enter or paste your TeamViewer API token' -AsSecureString)

# Retrieves users of a TeamViewer company
Get-TeamViewerUser

Another example below shows how to display the TeamViewer ID as well as the version of the locally installed TeamViewer client:

Install-Module TeamViewerPS

# Returns the TeamViewer Id of the locally installed TeamViewer client
Get-TeamViewerId

# Returns the version of the locally installed TeamViewer client
Get-TeamViewerVersion

The documentation and help can be accessed using the following commands:

# Starting point of the documentation
Get-Help about_TeamViewerPS

# List of available commands of this module
Get-Command -Module TeamViewerPS

# Help for specific module functions
Get-Help -Full Get-TeamViewerUser # ... or any other command

Commands

The module provides functions for the following categories:

  • Computers & Contacts list
  • User management
  • Managed groups
  • Policy management
  • Local TeamViewer utilities

Please see the about_TeamViewerPS article for a more detailed list.

License

Please see the file LICENSE.

Links