Pular para o conteúdo

Linhas de comando

Estamos satisfeitos em fornecer a você um conjunto abrangente de ferramentas de linha de comando projetadas para aumentar a flexibilidade e a eficiência do nosso software. Essas ferramentas permitem que os usuários criem scripts e automatizem várias funcionalidades, adaptando o software para atender às suas necessidades e fluxos de trabalho específicos.

Explore as possibilidades e otimize sua experiência com nossas opções de linha de comando.

Você só precisa executar as seguintes linhas de comando como um Administrador elevado. Como lembrete, AdminTool.exe e TwoFactor.Admin.exe (complemento 2FA) devem estar localizados aqui: C:\Program Files (x86)\TSplus\UserDesktop\files

Tabela de conteúdos


Backup de dados e configurações: /backup

Sintaxe:

AdminTool.exe /backup [caminhoOpcional] [parâmetros]

Descrição:

Comando /backup é usado para fazer backup dos dados e configurações do TSplus.

Por padrão, o backup será criado no diretório de arquivos (C:\Backupparam)

Parâmetros:

  • optionalPath para fazer backup em outro diretório que não o padrão. Caminhos relativos e absolutos são permitidos.
  • /silent se este parâmetro for mencionado, o backup é feito silenciosamente

Exemplos:

AdminTool.exe /backup AdminTool.exe /backup “c:/TSplus/CustomBackupFolder” /silent

Para mais informações, por favor, vá para TSplus - Configurações de Backup


Restaurar dados e configurações: /restore

Sintaxe:

AdminTool.exe /restaurar [caminhoDoBackup] [parâmetros]

Descrição:

Comando /restore é usado para restaurar dados e configurações do TSplus.

O diretório de backup especificado deve conter uma pasta de dados e uma pasta de configurações, conforme criado pelo comando /backup.

Parâmetros:

  • backupPath o caminho onde está localizada a pasta de backup para restaurar.
  • /silent se este parâmetro for mencionado, a restauração é feita silenciosamente

Exemplos:

AdminTool.exe /restore “C:/Backupparam” /silent AdminTool.exe /restore “C:/TSplus/CustomBackupFolder” /silent

Para mais informações, por favor, vá para TSplus - Configurações de Backup


Servidor Web: /webstop , /webstart e /webrestart

Sintaxe:

AdminTool.exe /webstop

AdminTool.exe /webstart

AdminTool.exe /webrestart

Descrição:

Comando /webstop é usado para parar o servidor Web.

Comando /webstart é usado para iniciar o servidor Web.

Comando /webrestart é usado para reiniciar o servidor Web.

Parâmetros:

Nenhum


Atualização: /update

Sintaxe:

AdminTool.exe /atualizar [opções]

Descrição:

Comando update é usado para atualizar TSplus Remote Access e potencialmente Advanced Security.

Parâmetros:

  • [options] :
    • /addons se esta opção for utilizada, a Segurança Avançada também é atualizada, se uma nova versão estiver disponível.

Exemplo:

AdminTool.exe /atualizar /adicionais


Aplicar atualizações de compatibilidade do Windows: /updatekernel

Sintaxe:

svcac.exe /atualizarkernel [/silencioso]

svcac.exe deve estar localizado aqui: C:\Program Files (x86)\TSplus

Descrição:

Comando /updatekernel é usado para aplicar atualizações de compatibilidade do Windows.

Essas atualizações automáticas garantem que o TSplus Remote Access permaneça compatível com novas atualizações do Windows e evitam a necessidade de baixar e reinstalar uma versão mais recente do TSplus Remote Access.

Atualizações de compatibilidade do Windows podem ocorrer diariamente. TSplus Remote Access permite atualizações forçadas. Isso é útil quando a compatibilidade parece estar quebrada e você precisa recuperar o último patch do TSplus Remote Access fora do cronograma regular de atualizações.

Por favor, note que uma licença válida é necessária para recuperar atualizações de compatibilidade. Se sua licença de teste expirou ou se sua licença é inválida, uma caixa de mensagem de erro será exibida. Por favor, entre em contato com nossa equipe de suporte com uma captura de tela desta mensagem de erro se o problema for inesperado.

Parâmetros:

  • [/silent] Atualize silenciosamente fornecendo este parâmetro. Nenhuma caixa de mensagem será exibida.

Instalar Impressora Universal: /InstallUniversalPrinter

Sintaxe:

universalprintermanagement.exe /InstallUniversalPrinter

universalprintermanagement.exe está localizado aqui: C:\Program Files (x86)\TSplus\UserDesktop\files

Descrição:

Comando /InstallUniversalPrinter é usado para instalar a Impressora Universal.

Esta é uma instalação limpa, pois remove a Impressora Universal existente, se instalada anteriormente.

Parâmetros:

Nenhum

Você também pode realizar esta ação manualmente, por favor, veja em Impressora Universal


Remover UniversalPrinter: /RemoveUniversalPrinter

Sintaxe:

universalprintermanagement.exe /RemoverImpressoraUniversal

universalprintermanagement.exe está localizado aqui: C:\Program Files (x86)\TSplus\UserDesktop\files

Descrição:

Comando /RemoveUniversalPrinter é usado para desinstalar a Impressora Universal.

Parâmetros:

Nenhum

Você também pode realizar esta ação manualmente, por favor, veja em Impressora Universal


Configurar servidor proxy: /proxy /set

Sintaxe:

AdminTool.exe /proxy /set [parâmetros]

Descrição:

Comando /proxy /set é usado para configurar um servidor proxy para acesso à Internet.

Parâmetros:

  • /host o host de destino pode ser um valor predefinido (“ie” ou “none”) ou um valor definido pelo usuário (por exemplo: 127.0.0.1 ou proxy.company.org). Este parâmetro é obrigatório
  • /port o número da porta usado para se conectar ao servidor proxy. Necessário se o valor do nome do host for um valor definido pelo usuário.
  • /username o nome de usuário para se conectar ao servidor proxy. Esta configuração é opcional
  • /password a senha do usuário deve ser fornecida se um nome de usuário tiver sido definido. No entanto, seu valor pode estar vazio

Exemplos:

AdminTool.exe /proxy /set /host proxy.company.org /port 80 /username dummy /password pass@word1

AdminTool.exe /proxy /set /host ie

Para mais informações, por favor, vá para Como configurar um Servidor Proxy para Acesso à Internet?


Abra o formulário de credenciais da Web: /webcredentials

Sintaxe:

AdminTool.exe /webcredentials

Descrição:

Comando /webcredentials lança em uma única janela a interface de Credenciais da Web (como você faria em AdminTool > Web > Credenciais da Web).

Parâmetros:

Nenhum


Criar Credenciais da Web: /webcredentials-add

Sintaxe:

AdminTool.exe /webcredentials-add [webLogin] [webPassword] [windowsLogin] [windowsPassword] [maximumConcurrentSessions]

Descrição:

Comando /webcredentials-add é usado para criar Credenciais da Web (como você faria em AdminTool > Web > Credenciais da Web).

Parâmetros:

  • webLogin o login da web que você deseja criar.
  • webPassword a senha da web associada. Pode ser uma credencial em branco. Para isso, use aspas duplas "" para indicar uma senha em branco.
  • windowsLogin o login do Windows do usuário correspondente.
  • windowsPassword a senha do Windows.
  • maximumConcurrentSessions (opcional): o número máximo de sessões simultâneas para este usuário.

Exemplo:

AdminTool.exe /webcredentials-add johndoe passwordABCD johnWinuser johnWinpassword 4

Para mais informações, por favor, vá para Credenciais da Web


Remover Credenciais da Web: /webcredentials-remove

Sintaxe:

AdminTool.exe /webcredentials-remove [webLogin]

Descrição:

Comando /webcredentials-remove é usado para remover uma Credencial da Web existente (como você faria em AdminTool > Web > Credenciais da Web).

Parâmetros:

  • webLogin o login da web que você deseja remover.

Exemplo:

AdminTool.exe /webcredentials-remove johndoe

Para mais informações, por favor, vá para Credenciais da Web


Gerenciador de Sessões Abertas: /sessionmanager

Sintaxe:

AdminTool.exe /gerenciador de sessão

Descrição:

Comando /sessionmanager lança em uma única janela de tamanho considerável o gerenciador de sessões (como você faria em AdminTool > Início > Gerenciador de Sessões).

Parâmetros:

Nenhum


Monitor de Sessões Abertas: /farm-sessions-monitor

Sintaxe:

AdminTool.exe /monitorar-sessões-farm

Descrição:

Comando /farm-sessions-monitor lança em uma única janela grande o monitor de sessões do gerenciador de fazendas (como você faria em AdminTool > Fazenda > Monitorar Sessões).

Parâmetros:

Nenhum


Abrir o gerenciador de balanceamento de carga: /farm-loadbalancing

Sintaxe:

AdminTool.exe /balanceamento-de-carga-farm

Descrição:

Comando /farm-loadbalancing lança em uma única janela de tamanho considerável o gerenciador de balanceamento de carga do gerenciador de fazenda (como você faria em AdminTool > Fazenda > Balanceamento de Carga).

Parâmetros:

Nenhum


Executar auditoria do sistema: /systemaudit

Sintaxe:

AdminTool.exe /systemaudit

Descrição:

Comando /systemaudit executa uma auditoria do sistema (como você faria manualmente em AdminTool > Início > Auditoria do Sistema > Executar Auditoria do Sistema).

Parâmetros:

Nenhum


Ativação de licença: /activate

Sintaxe:

AdminTool.exe /ativar [licensePath]

Descrição:

Comando activate é usado para ativar a licença de Remote Access, usando um arquivo de licença.

Parâmetros:

  • [licensePath] o caminho do arquivo de licença

Exemplo:

AdminTool.exe /activate “C:\Program Files (x86)\TSplus\license.lic”


Redefinição de licença após clonagem de uma máquina virtual: /reset

Sintaxe:

AdminTool.exe /license /reset

Descrição:

Ao clonar um servidor, a aba 'Licença' no AdminTool pode não exibir um ID de Computador ou pode mostrar a mensagem de erro: “Identificador de hardware inválido.” O comando /reset visa inicializar a licença no servidor clonado para que novas licenças possam ser atribuídas aos produtos TSplus instalados.

Notas Importantes:

  1. Uma nova licença TSplus deve ser ativada usando uma nova Chave de Ativação.
  2. Não use o comando /license /reset em uma máquina não clonada, pois isso impede permanentemente a atribuição de licença. Sempre confirme o status da máquina antes de prosseguir.

Passos para redefinir a licença em um servidor clonado:

  1. Abra uma sessão de Administrador no servidor clonado.

  2. Altere o número de série do volume do HDD.

  • Execute o vol comando para exibir o número de série do volume atual (VSN). O resultado deve se parecer com: 74F8-9C08 .

  • Baixe e instale a ferramenta VolumeID, disponível aqui .

  • Execute o comando: volumeid C: 84F8-9C08 como administrador para alterar o VSN da unidade. Neste exemplo, alteramos o VSN do disco C: e eu mudei apenas um caractere (o primeiro) do VSN antigo para especificar o novo.

  • Nota: esta etapa é crítica porque certas versões do Windows Server não geram um novo Número de Série de Volume durante a clonagem, mesmo ao usar o SysPrep.

  1. Renomeie o servidor clonado e reinicie-o.

  2. Redefinir a Licença no AdminTool:

  • Abra um Prompt de Comando com privilégios de Administrador.

  • Navegue até o diretório que contém o executável do AdminTool usando este comando: cd "C:\Program Files (x86)\TSplus\UserDesktop\files"

  • Execute o seguinte comando: AdminTool.exe /license /reset

  1. Verifique a redefinição.
  • Após executar o comando, a aba 'Licença' deve exibir o seguinte erro: "Failed to read license file (unexpected file format)."
  1. Ative a nova licença.
  • Na aba 'Licença', clique em 'Ativar sua licença' e insira a nova Chave de Ativação para ativar as licenças e suportes necessários.

Exemplo:

AdminTool.exe /license /reset TSplus-Security.exe /license /reset ServerMonitoring.exe /license /reset


Ativação de licença por volume: /vl /activate

Sintaxe:

AdminTool.exe /vl /activate [chave de licença] [parâmetros]

Descrição :

Comando vl /activate é usado para ativar uma licença por volume.

Parâmetros:

  • licensekey chave de licença para ativar, neste formato: AAAA-BBBB-CCCC-DDDD
  • /users : qualquer número de 1 a 50, ou "ilimitado"
  • /edition “Desktop”, “MobileWeb” ou “Enterprise”
  • /supportyears Qualquer número de 0 a 3.
  • /comments Especifica os comentários a serem anexados à licença no portal de Licenças

Exemplo:

AdminTool.exe /vl /activate VOLU-MELI-CENS-EKEY /users ilimitados /edition Enterprise /supportyears 3 /comments “Este é um comentário”

Para mais informações, por favor, vá para Documentação de licença por volume


Habilitando e desabilitando a licença de volume: /vl /enable e /vl /disable

Sintaxe:

AdminTool.exe /vl /enable [chave de licença]

AdminTool.exe /vl /disable [licensekey]

Descrição:

Comando vl /enable é usado para habilitar uma licença por volume.

Comando vl /disable é usado para desativar uma licença de volume.

Parâmetros:

  • licensekey chave de licença para ativar/desativar, neste formato: AAAA-BBBB-CCCC-DDDD

Exemplos:

AdminTool.exe /vl /enable VOLU-MELI-CENS-EKEY

AdminTool.exe /vl /disable VOLU-MELI-CENS-EKEY

Para mais informações, por favor, vá para Como habilitar/desabilitar uma licença no servidor?


Atualização da licença por volume: /vl /update

Sintaxe:

AdminTool.exe /vl /update [chave de licença] [parâmetros]

Descrição:

Comando vl /update é usado para atualizar os usuários de uma licença por volume.

Parâmetros:

  • licensekey chave de licença para atualização, neste formato: AAAA-BBBB-CCCC-DDDD
  • /users : qualquer número de 1 a 50, ou "ilimitado"

Exemplos:

AdminTool.exe /vl /update /users 2 AdminTool.exe /vl /update /users ilimitado

Para mais informações, por favor, vá para Como atualizar os usuários de uma licença por volume a partir do servidor?


Exibir créditos de licença restantes para uma chave de Licença por Volume: /vl /credits-license

Sintaxe:

AdminTool.exe /vl /credits-license [licensekey] [parameters]

Descrição:

Comando vl /credits-license é usado para exibir os créditos de licença restantes associados a uma chave de Licença por Volume.

Parâmetros:

  • licensekey Chave de Licença por Volume, neste formato: AAAA-BBBB-CCCC-DDDD
  • /login forneça o login do parceiro associado à chave de Licença por Volume
  • /edition forneça o parâmetro de edição opcional para produtos de Segurança Avançada e Monitoramento de Servidor
  • /silent executa o comando silenciosamente

A saída será armazenada na variável de ambiente de nível de usuário chamada VOLUME_LICENSE_CREDITS . Pode ser necessário ler o valor de VOLUME_LICENSE_CREDITS de um processo diferente, usando o comando echo %VOLUME_LICENSE_CREDITS% .

Exemplos:

AdminTool.exe /vl /credits-license VOLU-MELI-CENS-EKEY /login JOHNDOE TSplus-Security.exe /vl /credits-license VOLU-MELI-CENS-EKEY /login JOHNDOE /edition Essentials /silent

Para mais informações, por favor, vá para Como exibir os créditos de licença restantes para uma chave de Licença por Volume?


Exibir créditos de suporte restantes para uma chave de Licença por Volume: /vl /credits-support

Sintaxe:

AdminTool.exe /vl /credits-support [chave de licença] [parâmetros]

Descrição:

Comando vl /credits-support é usado para exibir os créditos de suporte restantes associados a uma chave de Licença por Volume.

Parâmetros:

  • licensekey Chave de Licença por Volume, neste formato: AAAA-BBBB-CCCC-DDDD
  • /login forneça o login do parceiro associado à chave de Licença por Volume
  • /edition forneça o parâmetro de edição opcional para produtos de Segurança Avançada e Monitoramento de Servidor
  • /silent executa o comando silenciosamente

A saída será armazenada na variável de ambiente de nível de usuário chamada VOLUME_LICENSE_CREDITS . Pode ser necessário ler o valor de VOLUME_LICENSE_CREDITS de um processo diferente, usando o comando echo %VOLUME_LICENSE_CREDITS% .

Exemplos:

AdminTool.exe /vl /credits-support VOLU-MELI-CENS-EKEY /login JOHNDOE TSplus-Security.exe /vl /credits-support VOLU-MELI-CENS-EKEY /login JOHNDOE /edition Essentials

Para mais informações, por favor, vá para Como exibir os créditos de suporte restantes para uma chave de Licença por Volume?


2FA - redefinir: /resetuser

Sintaxe:

TwoFactor..Admin.exe /resetuser [user1] [user2] … [userN]

Descrição:

Comando /resetuser é usado para redefinir usuários 2FA, em vez de fazê-lo através da interface do usuário (isso pode ser feito aqui na interface: TwoFactor.Admin > Gerenciar Usuários > Redefinir)

Parâmetros:

  • user1 user2 ... userN os nomes de domínio dos usuários que você deseja redefinir (separados por espaço simples)

Exemplos:

TwoFactor.Admin.exe /resetuser johndoe jackrussell chuckbartowski

Para mais informações, por favor, vá para Redefinir Configuração para Usuários


2FA - adicionar usuários: /addusers

Sintaxe:

TwoFactor.Admin.exe /addusers [userInfos1] [userInfos2] … [userInfosN]

Descrição:

Comando /addusers é usado para adicionar vários usuários 2FA, em vez de fazê-lo através da interface do usuário, usuário por usuário (isso pode ser feito aqui na interface: TwoFactor.Admin > Gerenciar Usuários > Adicionar Usuário)

Parâmetros:

  • userInfos1 userInfos2 ... userInfosN as informações dos usuários que você deseja adicionar. Essas informações consistem nos seguintes campos, separados por ponto e vírgula.
    • domainName (nome obrigatório): o nome de domínio do usuário a ser adicionado
    • receivedMethod (opcional): o método para receber códigos de confirmação. Deve ser um destes valores: SMS, App, Email ou DeixeOUsuárioEscolher. App é o valor padrão.
    • mobilePhone (opcional): o telefone do usuário a adicionar
    • email (opcional): o e-mail do usuário a ser adicionado

Exemplos:

TwoFactor.Admin.exe /addusers johndoe jackrussell;DeixeOUsuárioEscolher chuckbartowski;Telefone;+33101010101; [email protected] samanthacarter;Email;;

Para mais informações, por favor, vá para Adicionar Usuários e Grupos


2FA - adicionar grupos: /addgroups

Sintaxe:

TwoFactor.Admin.exe /addgroups [grupo1] [grupo2] … [grupoN]

Descrição:

Comando /addgroups é usado para adicionar vários grupos de 2FA, em vez de fazê-lo através da interface do usuário, grupo por grupo (isso pode ser feito aqui na interface: TwoFactor.Admin > Gerenciar Usuários > Adicionar Grupo)

Parâmetros:

  • group1 group2 ... groupN os nomes dos grupos que você deseja adicionar.

Exemplos:

TwoFactor.Admin.exe /addgroups grupo1 grupo2 grupo3

Para mais informações, por favor, vá para Adicionar Usuários e Grupos


2FA - listar usuários: /getusers

Sintaxe:

TwoFactor.Admin.exe /getusers

Descrição:

Comando /getusers é usado para obter uma lista de todos os usuários/grupos configurados no console de administração 2FA. Uma representação em json dessa lista de usuários/grupos é retornada e pode ser usada, por exemplo, em um script do Powershell.

Esta lista pode ser vista aqui na interface: TwoFactor.Admin > Gerenciar Usuários.

Parâmetros:

Nenhum


2FA - adicionar grupos: /deleteuser

Sintaxe:

TwoFactor.Admin.exe /deleteuser [domainName] [userType]

Descrição:

Comando /deleteuser é usado para remover um usuário da configuração de 2FA (isso pode ser feito aqui na interface: TwoFactor.Admin > Gerenciar Usuários > Remover)

Parâmetros:

  • domainName o nome do usuário ou do grupo a ser removido.
  • userType o tipo de objeto a ser excluído. Seu valor deve ser "usuário" ou "grupo"

Exemplos:

TwoFactor.Admin.exe /deleteuser “Este é um nome de grupo” grupo TwoFactor.Admin.exe /deleteuser administrador usuário

Para mais informações, por favor, vá para Remover Usuários e Grupos