Windows 上的完整版 TeamViewer 可以运行命令行参数,使用预设 ID、密码和连接模式启动与远程设备的会话。

您可以使用这些参数从命令提示符、脚本(例如 .bat 文件)或桌面或开始菜单上的快捷方式运行 TeamViewer 。

本文适用于使用Windows或macOS的TeamViewer 用户。

使用命令行参数

有值和没有值得参数

📌注意:部分参数仅适用于 TeamViewer (Classic) v13.2 版本。

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

无值参数示例如下: 

TeamViewer.exe –noInstallation

有值参数示例如下: 

TeamViewer.exe --id 123456789

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

如果参数的值包含空格,则该值必须用引号引起来。

📌提示

  • 长参数以“--”(由两个“-”组成)方式调用:TeamViewer.exe –Minimize
  • 如果参数有短变量,可以仅用一个“-”调用:TeamViewer .exe -n
  • 但某些平台上也可以使用“--n”。多个参数可以在一起被同时调用,并且参数区分大小写。

应用

下列选项可供选择:

📌注意:请在第一行找到参数和简短变量,并在下面对每个变量进行描述。

最小化

最小化启动 TeamViewer。 如果启用“使用窗口启动 TeamViewer”,TeamViewer 将改为在托盘中启动

id -i

开始与给定合作伙伴 ID 的连接

password-p

与“id”结合使用。 用于连接的密码

passwprdB64 -B

与“id”结合使用。 用于连接的 Base64 加密密码。

mode-m

与“id”结合使用。 用于连接的连接模式。

如果省略,则使用遥控器 -

支持的值:

  • 文件传输
  • 虚拟专用网

示例:--mode fileTransfer

quality-q

与“id”结合使用。 用于连接的连接质量设置

支持的值:

  1. 自动质量选择
  2. 优化质量
  3. 优化速度
  4. 自定义设置
  5. 不明确的

示例:--quality2

ac -a

与“id”结合使用。 用于(传出)连接的访问控制权限。

支持的值:

0.完全访问

  1. 全部确认
  2. 查看和显示
  3. 自定义

📌注意:使用自定义参数时,将应用之前自定义的传出访问控制值。

9.未定义

示例:--ac1

播放

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

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

控制

启动与给定控制文件 (*.tvc) 中指定的 ID 的连接(RC/会议)

在哪里可以找到 .tvc 文件:

  • %appdata%\TeamViewer\MRU\RemoteSupport
  • %appdata%\TeamViewer \MRU\会议

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

代理服务器的IP

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

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

代理用户

与“ProxyIP”结合使用。 代理用户名

示例:TeamViewer (Classic).exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin

代理密码

与“ProxyIP”结合使用。 代理密码 Base64 编码。

示例:TeamViewer (Classic).exe --ProxyIP 192.168.0.2:8080 --ProxyUser admin --ProxyPassword test

发送至

将文件列表发送给合作伙伴列表中的合作伙伴。 可能会打开提示以供登录和选择收件人。

例子:

单个文件: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

例子

  • 远程控制:

teamviewer.exe -i <ID> -P <Password>

  • 文件传输:

teamviewer.exe -i <ID> -P <Password> -m fileTransfer

  • VPN:

teamviewer.exe -i <ID> -P <Password> -m vpn

设备分配(旧版)

在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 (Classic)_Service在有限的权限下写成。该工具只能在应用程序包中执行,否则该工具无法找到其所需的工作框架而无法使用。

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

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

参数

有下列选项可供使用: 

支持以下选项:

📌注意:请在下面找到每个选项及其说明。

api-token - 必需

令牌需要访问 API,可以在管理控制台中生成(例如,在“配置文件设置/应用程序”中)。 也可以使用用于部署自定义主机的令牌。

别名

计算机和联系人列表中新设备的别名。 如果设备已经在联系人列表中,则不会应用别名

授予轻松访问

默认值:false 账户分配后授予轻松访问(与 TeamViewer (Classic) 主窗口中的“授予轻松访问”选项相同)

重新分配

默认值:false 将设备分配给帐户,即使设备已分配给帐户也是如此。

等待

默认值:10 分配等待创建数据文件的等待时间(以秒为单位)。 通常,默认值就足够了。

仅在未使用自定义主机时才需要,因为该组已在自定义配置中定义。 设备将被添加到的组的名称。 如果该组不存在,它将自动创建。 如果设备已存在于不同组的计算机和联系人列表中,则不会将其移动到该组

组名

如果组的 ID 已知,则替代 --group 参数。 它可用于更大的客户环境,因为它可以加快分配过程。

通常,使用 --group 就足够了

代理

格式为 <name>:<port> 的代理 URL,

示例:--proxy yourproxy:3201

代理用户

用于对代理进行身份验证的用户名

代理密码

用于对代理进行身份验证的密码

代理-pwbase64

--proxy-pw 相同,但密码需要以 Base64 编码的字符串形式输入。

verbose

仅 macOS 需要。 它可用于启用更详细的日志记录。 仅在错误分析的情况下使用。

重试

如果出现临时错误,将重试分配。 请注意,每次尝试之间有 1 秒的等待时间。

暂停

设置用于所有分配尝试的总超时时间(以秒为单位)。 

示例

Windows

设备分配:

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

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

TeamViewer.exe assign --api-token 12345678 --group "Some Group" --alias %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 -api-token 12345678 -group SomeGroup

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

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -api-token 12345678 -group "Some Group" -alias $USER -grant-easy-access 

代理认证:

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

 

设备分配(新)

对于 TeamViewer 版本 15 及更高版本的大规模部署,我们建议使用新的命令行参数 - 您可以在知识库中找到更多信息 - 通过命令行分配设备 - 8/9

COM API

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

TeamViewer .exe api <options>

Option Description TeamViewer version

--install

Install the COM API

>=11

--uninstall

Uninstall the COM API

>=11

如何确认安装成功

通过日志文件

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

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确认如下例的版本信息:

 

如何确认卸载完成

通过日志文件

在文件夹%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是否有如下出错信息。