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
- Restaurar dados e configurações
- Servidor Web
- Atualizar
- Aplicar atualizações de compatibilidade do Windows
- Instalar Impressora Universal
- Remover Impressora Universal
- Configurar servidor proxy
- Abrir o formulário de Credenciais da Web
- Criar Credenciais da Web
- Remover Credenciais da Web
- Gerenciador de Sessões Abertas
- Monitor de Sessões Abertas
- Abrir gerenciador de balanceamento de carga
- Executar auditoria do sistema
- Ativação de licença
- Redefinição de licença após clonagem de uma VM
- Ativação de licença por volume
- Ativando e desativando a licença por volume
- Atualização de licença por volume
- Exibir 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
- 2FA - redefinir
- 2FA - adicionar usuários
- 2FA - adicionar grupos
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:
- Uma nova licença TSplus deve ser ativada usando uma nova Chave de Ativação.
- 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:
-
Abra uma sessão de Administrador no servidor clonado.
-
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.
-
Renomeie o servidor clonado e reinicie-o.
-
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
- 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)."
- 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