Base de Conhecimento

Back to support overview

Neste guia, você aprenderá a adicionar usuários à lista de exclusão do TeamViewer Single Sign-On (SSO) usando um arquivo CSV. O script fornecido, Add-SsoExclusionsFromCSV.ps1, simplifica esse processo e permite gerenciar com eficiência as exclusões de usuários.

Este artigo se aplica aos titulares da licença TeamViewer Tensor.

Pré-requisitos

Antes de começar, certifique-se de que o módulo TeamViewerPS PowerShell esteja instalado.

Esse script se baseia no módulo PowerShell do TeamViewerPS. Se você ainda não o instalou, pode fazê-lo usando o seguinte comando:

Install-Module TeamViewerPS

Adição de usuários a partir de um arquivo CSV

Agora que o módulo PowerShell do TeamViewerPS está instalado, você pode continuar a adicionar usuários de um arquivo CSV à lista de exclusão de SSO do TeamViewer:

  1. Prepare o arquivo CSV: crie um arquivo CSV que contenha a lista de usuários que deseja excluir. Certifique-se de que o arquivo CSV tenha uma coluna com o nome de cabeçalho Email (ou conforme sua necessidade) que contenha os endereços de e-mail dos usuários que deseja excluir.
  2. Execute o script: Abra o console do PowerShell e navegue até o diretório em que o script Add-SsoExclusionsFromCSV.ps1 está localizado. Use o seguinte comando para importar usuários do arquivo CSV:
.\Add-SsoExclusionsFromCSV -Path 'c:\Example.csv' -HeaderName 'Email'

Substitua "c:\Example.csv" pelo caminho real do seu arquivo CSV, se ele estiver localizado em um diretório diferente.

Esse comando lerá o arquivo CSV e adicionará os usuários especificados à lista de exclusão de SSO do TeamViewer.

Uso de um token de API (opcional)

Se quiser usar um token de API para autenticação, você pode fornecê-lo da seguinte forma:

Gere um token de API: Crie um token de API seguro e converta-o em uma cadeia de caracteres segura. Por exemplo:

$apiToken = 'SecretToken123' | ConvertTo-SecureString -AsPlainText -Force

Execute o script com o token da API: Execute o script com o parâmetro -ApiToken:

.\Add-SsoExclusionsFromCSV -Path 'c:\Example.csv' -HeaderName 'Email' -ApiToken $apiToken

Isso garantirá que o script use o token de API fornecido para autenticação.

Modo de teste

Você pode executar o script de importação no Modo de teste para visualizar as alterações que seriam feitas sem aplicá-las de fato. Isso é útil para garantir que o arquivo CSV e os parâmetros do script estejam definidos corretamente:

.\Add-SsoExclusionsFromCSV -Path 'c:\Example.csv' -HeaderName 'Email' -WhatIf

Esse comando exibirá uma simulação das alterações sem fazer nenhuma modificação real.

Ajuda adicional

Se precisar de informações adicionais sobre o script e seus parâmetros, você poderá usar o cmdlet Get-Help do PowerShell:

Get-Help -Detailed .\Add-SsoExclusionsFromCSV.ps1

Esse comando fornecerá informações detalhadas sobre como usar o script e seus parâmetros disponíveis.

Seguindo essas instruções, você pode adicionar facilmente usuários à lista de exclusão do TeamViewer SSO por meio de importação de CSV, o que ajuda a gerenciar o acesso do usuário com mais eficiência.