通过命令行分配一个设备

要通过命令行分配 Windows 设备,请按照以下说明操作:
  1. 打开 CMD。 
  2. 导航到您的 TeamViewer 安装文件夹。 
  3. 在命令行中输入以下命令(如下所示)。 
  4. 按键盘上的 Enter 键。 
  5. (可选)输入

echo %errorlevel%

进入命令行以验证该过程是否成功。

  • 如果赋值成功,应将值 "0 "返回到命令行。
  • 任何其他的返回值都表明在赋值过程中出现了问题。欲了解更多信息,请参考 "错误代码" 部分。

TeamViewer.exe assignment --id paste_your_assignment_id_here --offline 

示例:

TeamViewer.exe assignment --id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline

可选的命令行选项

您可以将其他选项添加到命令行中:

别名

Windows:

--device-alias=[<name>]

新设备在设备列表中出现的别名;此属性可以采用以下值:

  1. --alias(无值)
    • 计算机的别名将是 TeamViewer ID
  2. --alias Hello
    • 计算机的别名将为“hello”
  3. 未指定别名参数
    • 此计算机的别名将为 %computername%
  4. --别名%systemvariable%
    • 别名将是使用的系统变量,例如 %username%

示例:

C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=%COMPUTERNAME-%USERNAME%

提示:如果您想使用空格,则必须将所有内容放入“...”中,如下例所示:

C:\Program Files\TeamViewer\TeamViewer.exe" assignment --id 123 --device-alias=“%COMPUTERNAME Test %USERNAME%“

重试

--retries

在出现临时错误的情况下,会重新进行分配。请注意,每次尝试之间有1秒钟的等待时间。

超时

--timeout

设置用于所有分配尝试的总体超时(秒)。

例子:

TeamViewer.exe assignment --id YOUR_ASSIGNMENT_ID
--retries=3 --timeout=120

-- offline

为处理在分配过程中处于离线状态的设备,系统会将分配信息以加密属性的形式存储在注册表中,并在设备上线时自动执行分配操作。一旦设备成功分配,该属性将被删除。

错误代码

错误代码
描述
问题/解决方案

1

Invalid command line arguments

您似乎拼写错误或使用了错误的命令。请检查您的命令并重试。

2

Signature verification error

-

3

Product not installed

TeamViewer 未安装。请在完成分配作业前安装 TeamViewer。

4

Service config - access failed

// ComAPI

无法根据 TeamViewer Cloud 验证分配配置。请稍后重试。

400

(40 under Linux/FreeBSD)

MDv2Assignment - invalid argument

命令行语法似乎有误,或者使用了无效的分配 ID。请检查您的整体命令行语法,并从管理控制台验证复制的分配 ID 是否为有效配置。

 401

 (41 under Linux/FreeBSD)

MDv2Assignment - service not running

由于 TeamViewer 运行不正常,无法完成任务。请确认 TeamViewer 服务正在运行。

402

 (42 under Linux/FreeBSD)

MDv2Assignment - service incompatible version

TeamViewer 服务与当前执行的 TeamViewer 客户端版本不兼容。安装似乎未正确完成。请检查安装,如有必要,请重新安装 TeamViewer。

403

 (43 under Linux/FreeBSD)

MDv2Assignment - not online

TeamViewer 客户端无法连接到 TeamViewer 云以分配您的设备。请检查客户端是否在线以及您的网络连接是否正常,然后重新尝试分配。如果这种情况经常发生,请考虑使用命令行界面上的“重试”选项。

404

 (44 under Linux/FreeBSD)

MDv2Assignment - already running

另一个分配流程已在运行。请检查该分配的状态。例如,您可以通过检查该设备是否已在管理控制台中注册为受管设备来检查。

405

 (45 under Linux/FreeBSD)

MDv2Assignment - timeout

您的分配作业尝试已超时。请重试。如果这种情况频繁发生和/或网络不稳定(例如移动网络),请考虑增加命令行界面的超时时间。

406

 (46 under Linux/FreeBSD)

MDv2Assignment - failed

您的分配作业因未知原因失败。

407

 (47 under Linux/FreeBSD)

MDv2Assignment - access denied

您没有执行分配作业所需的权限。请确保您的用户拥有本地管理员权限。

408

(48 under Linux/FreeBSD)

MDv2Assignment - Denied by policy

此设备上有效的 TeamViewer 策略阻止删除现有的分配状态。请在管理控制台中禁用该策略。

注意:重新分配会隐式删除现有状态,因此也会被拒绝。

409
(49 under Linux/Free BSD)

MDv2Assignment - Device already managed

该设备已分配给您的公司,且具有相同的分配 ID。

先决条件:

  • TeamViewer 已安装。
  • 对于 TeamViewer 完整客户端,需要启用“从 macOS 开始”选项。

要通过命令行分配 macOS 设备,请按照以下说明操作:

  1. 打开终端。
  2. 在命令行中输入以下命令(如下所示)。
  3. 按下键盘上的 Enter 键。

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id <ID> --offline

示例:

sudo /Applications/TeamViewerHost.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline

sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id paste_your_assignment_id_here --offline

示例:

sudo /Applications/TeamViewer.app/Contents/Helpers/TeamViewer_Assignment -assignment_id 0001CoBBChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAOjwtNCVK_JiM5lVdgdfguSk-gQ= --offline

可选命令行选项

这是您可以添加到命令行的附加选项:

别名

-device_alias [<name>]

设备列表中新设备的别名。如果设备已存在于联系人列表中,则不会应用别名。此属性可采用以下值:

  1. --alias (无值)
    • 计算机的别名将为 TeamViewer ID
  2. --alias hello
    • 计算机的别名将为“hello” 

--offline

为了处理分配期间离线的设备,它会将分配信息作为加密属性存储在注册表中,并在设备上线时自动执行。设备分配成功后,此属性将被删除。

sudo teamviewer assignment --id paste_your_assignment_id_here --offline 

示例:

sudo teamviewer assignment --id 0001CoABChARKJtw_okR6o_fJ7AisynpEigIACAfAgAJAO4PLaOBrqNDgr6jwtNCVK_JiM5lVdgdfgYo3uQ3pGkAbX8bo_VqPw1Rt61-RLe9AKSwZ14uwOXtUN7FYflrHbWAqRKBF0h8V18ldMcVT1rLF --offline

可选命令行选项

这是您可以添加到命令行的附加选项:

别名

--device_alias [<name>]

设备列表中新设备的别名。如果设备已存在于联系人列表中,则不会应用别名。该属性可以采用以下值:

  1. --alias (无值)
    • 计算机的别名将是 TeamViewer ID
  2. --alias hello
    • 计算机的别名将是“hello”

--offline

为了处理在分配过程中处于离线状态的设备,它会将分配情况作为加密属性存储在注册表中,并在设备上线时自动执行。设备分配成功后,此属性将被删除。

错误代码

错误代码
描述
问题/解决方案

1

Invalid command line arguments

您似乎拼写错误或使用了错误的命令。请检查您的命令并重试。

2

Signature verification error

-

3

Product not installed

TeamViewer 未安装。请在完成分配作业前安装 TeamViewer。

4

Service config - access failed

// ComAPI

无法根据 TeamViewer Cloud 验证分配配置。请稍后重试。

400

(40 under Linux/FreeBSD)

MDv2Assignment - invalid argument

命令行语法似乎有误,或者使用了无效的分配 ID。请检查您的整体命令行语法,并从管理控制台验证复制的分配 ID 是否为有效配置。

 401

 (41 under Linux/FreeBSD)

MDv2Assignment - service not running

由于 TeamViewer 运行不正常,无法完成任务。请确认 TeamViewer 服务正在运行。

402

 (42 under Linux/FreeBSD)

MDv2Assignment - service incompatible version

TeamViewer 服务与当前执行的 TeamViewer 客户端版本不兼容。安装似乎未正确完成。请检查安装,如有必要,请重新安装 TeamViewer。

403

 (43 under Linux/FreeBSD)

MDv2Assignment - not online

TeamViewer 客户端无法连接到 TeamViewer 云以分配您的设备。请检查客户端是否在线以及您的网络连接是否正常,然后重新尝试分配。如果这种情况经常发生,请考虑使用命令行界面上的“重试”选项。

404

 (44 under Linux/FreeBSD)

MDv2Assignment - already running

另一个分配流程已在运行。请检查该分配的状态。例如,您可以通过检查该设备是否已在管理控制台中注册为受管设备来检查。

405

 (45 under Linux/FreeBSD)

MDv2Assignment - timeout

您的分配作业尝试已超时。请重试。如果这种情况频繁发生和/或网络不稳定(例如移动网络),请考虑增加命令行界面的超时时间。

406

 (46 under Linux/FreeBSD)

MDv2Assignment - failed

您的分配作业因未知原因失败。

407

 (47 under Linux/FreeBSD)

MDv2Assignment - access denied

您没有执行分配作业所需的权限。请确保您的用户拥有本地管理员权限。

408

(48 under Linux/FreeBSD)

MDv2Assignment - Denied by policy

此设备上有效的 TeamViewer 策略阻止删除现有的分配状态。请在管理控制台中禁用该策略。

注意:重新分配会隐式删除现有状态,因此也会被拒绝。

409
(49 under Linux/Free BSD)

MDv2Assignment - Device already managed

该设备已分配给您的公司,且具有相同的分配 ID。

更新/重新分配

如果你已经有了一个分配的设备,并且你再次通过命令行执行分配,设备分配会被新的分配覆盖。覆盖意味着旧的分配被删除,已经分配的管理器或策略将被丢失。

注意: TeamViewer 策略 "防止删除分配 "也防止在已经分配的设备上进行新的分配。