TeamViewer (Classic) bietet eine webbasierte API, über die Sie die Möglichkeit haben, auf Daten zuzugreifen und diverse Aspekte Ihres TeamViewer (Classic) Kontos zu steuern. Mit der API können Sie Anwendungen entwickeln, um die TeamViewer (Classic) Funktion in die Arbeitsumgebung Ihres Unternehmens zu integrieren, oder Sie können Apps entwickeln, die alle Benutzer nutzen können.

Dieser Artikel richtet sich an alle.

Einleitung

Stellen Sie sich vor, Sie müssten die Geräte einer Gruppe einzeln entfernen, um diese Gruppe zu löschen. Bei einer geringen Anzahl an Geräten ist das in Ordnung, doch wenn es Hunderte sind, ist dies sehr mühsam. Nutzen Sie daher die Vorteile der API-Technologie, indem Sie ein Skript erstellen, mit dem Sie Gruppen – einschließlich der darin enthaltenen Geräte – automatisch löschen. Hierzu müssen Sie lediglich das API-Token und den Namen der Gruppe bereitstellen. In diesem Artikel erfahren Sie, wie Sie hierzu vorgehen.

Im Einzelnen nutzen wir die API-Funktionen zur Gruppenverwaltung und Geräteverwaltung. Für die Implementierung der Lösung wurde Windows PowerShell verwendet. Durch Verwendung eines Benutzer-Tokens ruft der Code die Geräte und Gruppen in Ihrer Management Console ab und zeigt diese an. Dadurch können Sie die Gruppe wählen, die gelöscht werden soll. Nach der Auswahl haben Sie wieder eine übersichtliche Management Console.

Vorbereitung

Stellen Sie sicher, dass Sie über ein TeamViewer (Classic) Konto verfügen. Falls Sie noch kein Konto haben, erstellen Sie sich eines unter http://login.teamviewer.com.

Um ein Skript zu erstellen, melden Sie sich mit Ihrem TeamViewer (Classic) Konto an der TeamViewer (Classic) Management Console an und erstellen Sie ein Skript-Token.

Öffnen Sie in der Console Ihre Profileinstellungen rechts oben. Wählen Sie Apps und klicken Sie auf Skript-Token erstellen. Füllen Sie die Werte im Pop-up aus, um das Token zu definieren.

• Geben Sie den Name Ihres Skripts ein.

• Geben Sie eine Beschreibung für Ihr Skript-Token ein.

• Wählen Sie die Berechtigungen Ihres Skript-Tokens.

• Gruppenverwaltung – Gruppen anzeigen, erstellen, bearbeiten und teilen

• Computer & Kontakte – Einträge anzeigen, hinzufügen, bearbeiten und löschen.

• Speichern Sie das Skript-Token.

Speichern Sie das Skript-Token nun an einem sicheren Ort. Das Token wird vom Skript angefordert, wenn dieses ausgeführt wird.

Der Code

$token = Read-Host -Prompt "Paste your account token code here"
$bearer = "Bearer",$token

$header = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$header.Add("authorization", $bearer)

$webrequest = Invoke-RestMethod -Uri "https://webapi.teamviewer.com/api/v1/groups/" -Method Get -Headers $header
$machine = Invoke-RestMethod -Uri "Https://webapi.teamviewer.com/api/v1/devices/" -Method Get -Headers $header

$i=1
$grpArr = @()

ForEach($grp in $webrequest.groups)
{
    Write-Host $i ")" $grp.name " - " $grp.id
    $grpArr += $grp.id;
    ForEach($dev in $machine.devices)
    {
        If($dev.groupid -eq  $grp.id)
        {
            Write-Host "     " $dev.alias
        }
    } 
    $i += 1
}
$ig = Read-Host -Prompt "Select the group you will like to remove"

ForEach ($dgrp in $machine.devices)
{
    if($dgrp.groupid -eq $grpArr[$ig - 1])
    {
        Write-Host "Delete device: " $dgrp.alias
        $item = $dgrp.device_id
        $delete = Invoke-WebRequest -Uri "Https://webapi.teamviewer.com/api/v1/devices/$item" -Method Delete -Headers $header
    }

}
Write-Host "Delete group id: " $grpArr[$ig - 1] 
   $gid = $grpArr[$ig - 1]
   $remove = Invoke-WebRequest -Uri "Https://webapi.teamviewer.com/api/v1/groups/$gid" -Method Delete -Headers $header 

 

Das Skript ausführen

Kopieren Sie den Skript-Code in den Texteditor Ihrer Wahl (z.B. Notepad) und speichern Sie ihn als .ps1-Datei. (test.ps1)

Video

Im folgenden Video finden Sie detaillierte Informationen zur Funktionsweise des Skripts (auf Englisch):

Fazit

Die TeamViewer (Classic) API ist ein wertvolles Tool, mit dem Sie von den Vorteilen der Management Console bestmöglich profitieren. Indem Sie eine Programmiersprache und Ihren Ideenreichtum kombinieren, erzielen Sie bei alltäglichen Aufgaben umgehend Ergebnisse wie dieses. Viel Spaß!