Base de Conhecimento

Pré-requisitos

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

Este script depende do módulo PowerShell TeamViewerPS. Se você ainda não instalou, pode fazer isso usando o seguinte comando:

Install-Module TeamViewerPS

Adicione usuários a partir de um arquivo CSV

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

1. Prepare seu arquivo CSV: Crie um arquivo CSV que contenha a lista de usuários que você deseja excluir. Certifique-se de que o arquivo CSV tenha uma coluna com o título de cabeçalho 'Email' (ou conforme sua necessidade) que contenha os endereços de e-mail dos usuários que você deseja excluir.

2. Execute o script: Abra seu console PowerShell e navegue até o diretório onde o Add-SsoExclusionsFromCSV.ps1 script 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 para seu arquivo CSV se ele estiver localizado em um diretório diferente.

Esse comando lê o arquivo CSV e adiciona os usuários especificados à lista de exclusão do Logon único do TeamViewer.

Usando um Token API (Opcional)

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

1. Gere um Token de API: Crie um token de API seguro e converta-o em uma string segura. Por exemplo:

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

2. Execute o script com o API Token: Execute o script com o -ApiToken parâmetro:

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

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

Testes com o Modo Teste

Você pode rodar o script de importação no Modo Teste para pré-visualizar as mudanças que seriam feitas sem realmente aplicá-las. Isso é útil para garantir que os parâmetros do arquivo CSV e do script estejam definidos corretamente:

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

Esse comando exibe uma simulação das mudanças sem fazer nenhuma modificação real.

Mais ajuda

Se precisar de informações adicionais sobre o script e seus parâmetros, pode usar o Get-Help cmdlet 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 facilmente adicionar usuários à lista de exclusão do Logon único do TeamViewer via importação de CSV, ajudando a gerenciar o acesso dos usuários de forma mais eficiente.