Antes de implantar TeamViewer em seus dispositivos, é importante escolher quais opções de atribuição você deseja aplicar a sua implantação.

Através das opções de atribuição, você pode definir uma grande variedade de parâmetros para sua implantação. Você encontrará na lista abaixo todas as opções de atribuição que você pode utilizar e suas respectivas ações.

Este artigo se aplica a clientes com licença Corporate ou Tensor que queiram implantar TeamViewer (13.2 ou mais recente) em seus dispositivos Windows.

Opções de atribuição

--alias [<name>]

Alias para o novo dispositivo na lista de computadores e contatos. Se o dispositivo já estiver na lista de contatos, nenhum pseudônimo será aplicado. O bem pode assumir os seguintes valores:

  1. --alias (sem valor)
    • o alias do computador será o ID do TeamViewer
  2. --alias hello
    • o alias do computador será 'hello'
  3. Parâmetro alias não especificado
    • o alias do computador será %computername%
  4. --alias %systemvariable%
    • alias será a variável de sistema utilizada, por exemplo %username%

Exemplo:

msiexec.exe /i "[Path_To]TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--alias %systemvariable%"

--grant-easy-access

Se você definir esta opção, o acesso fácil é concedido após a atribuição (o mesmo que a opção "Conceder acesso fácil" na guia Segurança das opções TeamViewer).

Exemplo:

msiexec.exe /i "[Path_To]\TeamViewer)_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--grant-easy-access"

--reassign

Atribui o dispositivo à conta, mesmo que o dispositivo já esteja atribuído a uma conta.

Exemplo:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--reassign"

Importante: O parâmetro --reassign repõe a atribuição existente e reaplica os parâmetros do roteiro de atribuição. Isto pode ter um impacto se, por exemplo, você alterar o pseudônimo ou a atribuição de grupo após a instalação inicial.

--group <name>

Nome do grupo ao qual o dispositivo será adicionado. Se o grupo não existir, ele será criado automaticamente. Caso o dispositivo já esteja presente na lista de computadores e contatos de outro grupo, ele não será movido para o grupo definido neste parâmetro. No entanto, se você também adicionar o parâmetro '--reassign', o dispositivo será movido para o grupo definido neste parâmetro.

Exemplo:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--group MyGroup"

💡Dica: Não é necessário se um Host personalizado for usado, pois já existe um grupo padrão definido na configuração personalizada.

--group-id <ID>

Esta opção é uma alternativa para usar o parâmetro --group se o id do grupo for conhecido. Isto pode ser útil em ambientes de clientes muito grandes, pois acelera o processo de atribuição. Normalmente, é suficiente usar o parâmetro --group.

📌Lembrete: Você pode encontrar o group-id ao entrar no Management Console, clicando no grupo desejado e verificando a URL. No final da URL você encontrará "g/123456789". A identificação deve ser precedida de um "g" literal e o "/" deve ser removido a fim de obter seu group-id (exemplo, g123456789).

Exemplo:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--group-id g123"

--proxy <name>:<port>

URL de seu representante (somente para a tarefa) no formato <nome>:<port>, por exemplo --proxy yourproxy:3201

Exemplo:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypassword"

⚠URL sem http://

--proxy-user <name>

Nome de usuário que é usado para autenticação contra o procurador (somente para a atribuição).

Exemplo:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass"

--proxy-pw <password>

Senha que é utilizada para autenticação contra o procurador (somente para a atribuição).

Exemplo:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw mypass"

--proxy-pw-base64 <encoded_password>

O mesmo que --proxy-pw, mas a senha precisa ser inserida como uma string codificada Base64. Útil para senhas com caracteres especiais.

Exemplo:

msiexec.exe /i "[Path_To]\TeamViewer_Host.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--proxy yourproxy:3201 --proxy-user FooBar --proxy-pw-base64 bXlwYXNz"

--monitoring-policyid <policy_id>

Esta opção só está disponível ao instalar o TeamViewer_Full.msi. Ela especifica a identificação da política para Remote Management Monitoramento que deve ser aplicado após a conclusão da tarefa com sucesso. Isto também requer --patchmanagement-policyid.

Exemplo:

msiexec.exe /i "[Path_To]\TeamViewer_Full.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--monitoring-policyid <YOUR_MONITORING_POLICYID> --patchmanagement-policyid <YOUR_PATCHMANAGEMENT_POLICYID>"

--patchmanagement-policyid <policy_id>

Esta opção só está disponível ao instalar o TeamViewer_Full.msi. Ela especifica a identificação da política para Remote Management Monitoramento que deve ser aplicado depois que a tarefa for concluída com sucesso. Isto também requer --monitoring-policyid.

Exemplo:

msiexec.exe /i "Path\To\TeamViewer_Full.msi" /qn APITOKEN=<YOUR_APITOKEN> CUSTOMCONFIGID=<YOUR_CONFIGID> ASSIGNMENTOPTIONS="--monitoring-policyid <YOUR_MONITORING_POLICYID> --patchmanagement-policyid <YOUR_PATCHMANAGEMENT_POLICYID>"