/TeamViewerPS

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

Primary LanguagePowerShellMIT LicenseMIT

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 Powershell session
# 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

# 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
  • User groups
  • Managed groups
  • Policy management
  • Single Sign-On management
  • Local TeamViewer utilities

Please see the about_TeamViewerPS article for a more detailed list.

Prerequisites

TeamViewerPS requires one of the following environments to run:

  • PowerShell 5.1 (Windows)
  • PowerShell Core 6 (Windows, Linux)
  • PowerShell 7 (Windows, Linux)

License

Please see the file LICENSE.

Links