Eliminar un grupo de su lista de ordenadores y contactos usando la API

No hay clasificaciones

 Introducción

TeamViewer incluye una API basada en web, que le permite acceder a sus datos y controlar diversos aspectos de su cuenta de TeamViewer. Puede utilizar la API para desarrollar aplicaciones que integren las funciones de TeamViewer en su entorno corporativo, o bien aplicaciones de desarrollo propio que pueda utilizar cualquiera.

Imagine que necesita eliminar un grupo que contiene dispositivos, que tendrá que eliminar uno a uno antes de eliminar el grupo. No tiene importancia cuando el grupo contiene pocos dispositivos, pero si son cientos, puede resultar bastante problemático. Saque partido a la tecnología de la API creando un script que elimine el grupo de manera automática, incluyendo los dispositivos que contiene. Para ello, solo necesita el token de la API y el nombre del grupo. Este artículo le mostrará cómo hacerlo.

Desde una perspectiva detallada, vamos a utilizar las funciones de administración de grupos y administración de dispositivos de la API. Para implementar la solución, se ha utilizado Windows PowerShell. Utilizando un token de usuario, el código recuperará los dispositivos y grupos de su consola de gestión, los mostrará y le permitirá seleccionar el grupo que desea eliminar. Como resultado, la consola quedará limpia.

Primeros pasos

Es necesaria una cuenta de TeamViewer. Si aún no tiene una, regístrese de forma gratuita en http://login.teamviewer.com

Para crear un script, inicie sesión en la consola de gestión de TeamViewer con su cuenta de TeamViewer y cree un token de script.

En la consola, abra la configuración de su perfil en la esquina superior derecha. A continuación, seleccione «Aplicaciones» y haga clic en «Crear token de script». Complete el formulario para configurar su token

• Introduzca el nombre del script

• Introduzca una descripción para el token de script

• Seleccione los permisos del token de script

• Gestión de grupos: Ver, crear, borrar, editar y compartir grupos

• Ordenadores y contactos: Ver, agregar, editar y eliminar entradas

• Guarde el token de script

Guarde el token en un lugar seguro. Cuando ejecute el script, este se lo solicitará.

Código

$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  

 

Ejecutar el script

Copie el código del script en su editor de texto preferido (por ejemplo, bloc de notas), y guárdelo como .ps1. (prueba.ps1)

Vídeo

Para obtener información detallada acerca del funcionamiento del script, vea el siguiente vídeo.

Conclusión

La API de TeamViewer es una herramienta muy valiosa para sacar el máximo partido a la consola de gestión. En combinación con un lenguaje de programación y su imaginación, puede lograr soluciones inmediatas como esta para facilitar sus tareas diarias. ¡Aprovéchela!

 

Historial de versiones
Revisión n.º
1 de 1
Última actualización:
‎29 mar 2019, 4:11 PM
Actualizado por:
 
Colaboradores