命令行参数

无评分

本文适用于所有mac和Windows的TeamViewers用户。

Windonws系统命令行参数

如何使用?

有值和没有值得参数

参数有两种类型:有值的和无值参数:

无值参数示例如下: 

TeamViewer.exe –noInstallation


有值参数示例如下: 

TeamViewer.exe --id 123456789

这些值会按各自定义的类型解析。大多数情况下默认只有一个值,如果有多个值,仅使用最后一个值。

如果参数值中包含空格,该值必须以“”定义。

其他信息

长参数以“--”(由两个“-”组成)方式调用:TeamViewer.exe –Minimize

如果参数有短变量,可以仅用一个“-”调用:TeamViewer.exe -n

但某些平台上也可以使用“--n”。

多个参数可以在一起被同时调用,并且参数区分大小写。

 

命令行任务

通常在传递命令行参数时,TeamViewer将继续运行。 但是,有些“任务”可以通过命令行触发,之后TeamViewer将自行关闭。

任务:

  • 设备分配
  • COM API安装

应用

下列选项可供选择:

 

参数 短参数 描述
Minimize 最小化启动TV,当启用“TV与windows同时启动”时,TV会自动在后台启动。
id  i 与给定的ID开启远程连接。
Password P 与"id"一起使用. 用于远程连接密码。
PasswordB64 B 与"id"一起使用。用于远程连接 Base64加密密码。 
mode m

与"id"一起使用。用于连接会话的连接模式。如果省略,默认为远程连接。

可选值:

  • fileTransfer(文件传输)
  • vpn
示例: --mode fileTransfer
quality q

与"id"一起使用。
用于连接时连接质量的设置。

可选值:

1: automatic quality selection(自动画质选择)

2: optimize quality (画质优先)

3: optimize speed(速度优先)

4: custom settings(个性设置)

5: undefined(未定义)

示例: --quality 2
ac a

与"id"一起使用。用于呼出连接的控制权限管理。

 

可选参数:

0: full access(完全控制)

1: confirm all(需全部确认)

2: view and show(浏览和显示)

3: custom(个性设置)

9: undefined(未定义)

示例: –-ac 1

play  

播放TeamViewer会话录影文件 (*.tvs)

示例: Teamviewer.exe  --play C:\Users\shvarts\Desktop\A\abc.tvs
control  

用给定的TeamViewer的tvc控制文件开启远程控制或会议的连接。

如何找到 *.tvc 文件:

%appdata%\TeamViewer\MRU\RemoteSupport

%appdata%\TeamViewer\MRU\Meeting

示例:Teamviewer.exe  --control C:\Users\shvarts\Desktop\A\abc.tvc
ProxyIP  

代理IP 和端口,格式如 IPAddress: Port

示例:Teamviewer.exe --ProxyIP 192.168.0.2:8080

 

手动代理设置: (TV Options → General → Proxy settings → Configure)
ProxyUser  

与"ProxyIP"一起使用
代理用户名

Example: Teamviewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin
ProxyPassword  

与"ProxyIP"一起使用。代理密码以Base64加密。

 

示例:Teamviewer.exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin --ProxyPassword test
sendto  

向您的联系人名单中的联系人发送文件清单,可能会提示需要登录和选择接收人:

示例:

单个文件:

Teamviewer.exe --sendto C:\Users\shvarts\Desktop\A\abc.jpg

多文件:
Teamviewer.exe --sendto C:\Users\shvarts\Desktop\A\abc.jpg C:\Users\shvarts\Desktop\A\abcd.jpg

 

设备分配

在Windows上,以如下方式开始分配任务:

TeamViewer.exe assign <options>

 

在mac上如下:

Host版本: 

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment <options>

 

完整版本:

sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment <options>

 

使用"sudo" 需要取得管理权限,因为AssignmentData.json由TeamViewer_Service在有限的权限下写成。该工具只能在应用程序包中执行,否则该工具无法找到其所需的工作框架而无法使用。

如果参数值(例如 group)中包含空格,则该值必须用“”括起来,或者在macOS上每个空格前后必须用“\”。

Windows中的每个选项前必须用“--" ;macOS中的每个选项前须用“-" 

 

有下列选项可供使用: 

选项 要求 默认值 描述
api-token  yes   需要令牌(token)访问API,令牌(token)可以在管理控制台上生成(在"Profile settings / Apps"). 您也可以使用定制化的host模块快速部署口令牌(Token)。
alias     为新添加进“计算机和联系人”的设备命名,如果该设备已经在“计算机和联系人”中,命名则不可用。
grant-easy-access   false 在设备分配后设置为无人值守访问。(此功能与TeamViewer主界面的“设置无人值守访问”选项相同)
reassign   false 在设备已经被分配到某个账户下再次将设备分配到其他设备。
wait   10 设备分配时等待数据文件生成的时间(秒)。通常默认值设置为足够时间。
group *  

设备添加至群组的名称。如果群组不存在,该群主将会自动生成。如果该设备已经在当前计算机与联系人列表其他群组里,它将不会被移至指定群组中。

*仅在使用定制化Host以外模块的情况下要求使用该参数。定制化模块已经定义了群组信息。

group-id     如果在群组ID已知的情况下,该参数可以作为--group参数的替代方法,这在有大量客户的情况非常有用,可以大大加快分配进程,但通常情况下使用--group参数已经足够。
proxy     您代理的URL必须按此格式: <name>:<port>, 比如 --proxy yourproxy:3201
proxy-user     代理服务器授权时使用的用户名。
proxy-pw     代理服务器授权时使用的密码。
proxy-pw-base64     与--proxy-pw相同,但输入的密码需要为Base64编码的字符串, 可适用于有特殊字符的密码。
verbose (仅在macOS使用)    用于设置更详细的日志记录,仅用于出错分析。

 

示例

Windows

设备分配:

TeamViewer.exe assign --api-token 12345678 --group SomeGroup

 

设备命名和设置无人值守访问:

TeamViewer.exe assign --api-token 12345678 --group "Some Group" --devicealias %COMPUTERNAME% --grant-easy-access

 

代理认证:

 

TeamViewer.exe assign --api-token 12345678 --group SomeGroup --reassign --proxy testproxy:3201 --proxy-user someuser --proxy-pw passwd

 

macOS

Host版本示例。完整版的示例仅需将“TeamViewerHost.app”改为“TeamViewer.app”。

 

设备分配:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment assign YES -api-token 12345678 -group SomeGroup

 

设备命名和设置无人值守访问:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment assign YES -api-token 12345678 -group "Some Group" -devicealias %COMPUTERNAME% -grant-easy-access 

 

代理认证:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment assign YES -api-token 12345678 -group SomeGroup -reassign -proxy testproxy:3201 -proxy-user someuser -proxy-pw passwd

 COM API

 Windows上可按如下方式使用COM API:

TeamViewer.exe api <options>

参数 描述 适用版本
--install  安装COM API TeamViewer 3-6
--uninstall  卸载COM API TeamViewer 3-6

 

如何确认安装成功

通过日志文件

在 %appdata%\TeamViewer文件夹下打开日子文件,找到下列记录:

CommandLineTasks: initializing...

CommandLineTasks: installing COM-API

API: Installing API ...

API: ... successfully installed, calling SignalServiceParamChange ...

API: ... SignalServiceParamChange finished

CommandLineTasks: installing COM-API successful

CommandLineTasks: finished

 

通过Windows Powershell

使用下列Powershell命令:

$tv = new-object -com TeamViewer.Application
$tv.ApiVersion

您可以在Windows Powershell确认如下例的版本信息:

Powershell1.png

 

如何确认卸载完成

通过日志文件

在文件夹%appdata%\TeamViewer下打开日子文件找到如下记录:

 

CommandLineTasks: initializing...

CommandLineTasks: uninstalling COM-API

API: Uninstalling API ...

API: ... successfully uninstalled, calling SignalServiceParamChange ...

API: ... SignalServiceParamChange finished

CommandLineTasks: uninstalling COM-API successful

CommandLineTasks: finished

 

通过Windows Powershell

使用如下 Powershell命令:

$tv = new-object -com TeamViewer.Application

确认Powershell是否有如下出错信息。

Powershell2.png

 

版本历史
修订号
1 / 1
上次更新时间:
‎13 Sep 2018, 5:15 PM
更新依据:
 
标签 (2)
贡献者