为方便起见,几乎所有的配置设置都具有键=值属性和一个相应的命令行选项名。对于一些设置,配置文件中有命令行选项,但没有可设置的相应属性。对于其他一些设置,您必须设置属性,因为没有可用的命令行选项。
有关 Horizon Client 配置文件的列表,请参阅使用 vmware-view 命令行界面和配置文件。
配置项 | 命令行选项 | 说明 |
---|---|---|
RemoteDisplay.updateCacheSizeKB | 无 | 使用此选项可设置 Blast 解码器映像缓存的最大大小(以千字节为单位)。
|
view.allMonitors | --allmonitors | 当 Horizon Client 启动时,在连接到客户端系统的所有显示器上隐藏主机操作系统并以全屏模式打开 Horizon Client。 设置该配置项时,可指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 |
view.allSessionsDisconnectedBehavior | --allSessionsDisconnectedBehavior | 自定义所有会话断开连接时的客户端行为。有效值如下:
默认值为空,表示未配置该设置。 |
view.allowDefaultBroker | -l, --lockServer | 使用此命令行选项或将此属性设置为“FALSE”将停用服务器文本框,除非客户端从未连接到任何服务器,且命令行或首选项文件中没有提供服务器地址。 例如: --lockServer -s view.company.com |
view.allowEnableHEVC | 无 | 将此属性设置为“FALSE”可停用客户端更改“VMware Horizon Blast 配置”窗口中的允许高效视频解码 (HEVC) 选项。 |
view.autoConnectBroker | 无 | 当用户启动 Horizon Client 时,自动连接到指定的服务器。指定服务器的完全限定域名。如果不使用默认的 443 端口,还可以指定一个端口号。 要允许用户在连接到指定的服务器时绕过登录按钮,请将 view.nonInteractive 属性设置为“TRUE”。 |
view.autoConnectDesktop | 无 | 自动连接到由 view.defaultDesktop 属性或 --desktopName= 命令行选项指定的桌面。如果用户在服务器上只有一个授权桌面,view.autoConnectDesktop 会连接到该授权桌面。 指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 |
view.autoDisconnectEmptyAppSession | 无 | 设置为 "TRUE"(默认值)时,如果应用程序会话因为用户退出所有应用程序而变为空,则会向最终用户显示一条消息。该消息提示用户选择断开空会话连接还是保持空会话继续运行。如果设置为 "FALSE",会根据 Horizon Console 中使用的超时设置关闭会话,默认超时设置可能是在一分钟后断开连接。 |
view.autoHideToolbar | 无 | 指定默认情况下是自动隐藏还是固定工具栏。指定 "TRUE" 将自动隐藏工具栏。默认值为 "FALSE"。 也可以通过启动 Horizon Client,从菜单栏中选择 ,然后选中自动隐藏工具栏复选框来设置此选项。 |
view.BENITServerConnectionMode | 无 | 设置在连接到服务器时要使用的连接模式。使用以下值之一:
|
view.BENITTcpConnectCount | 无 | 在通过丢包率较高的网络(数据包丢失率超过 20%)进行连接时,使用此值。将默认值设置为 12。
重要说明: 请始终将此选项与
view.BENITUdpSendCount 配置项结合使用。
|
view.BENITUdpSendCount | 无 | 在通过丢包率较高的网络(数据包丢失率超过 20%)进行连接时,使用此值。将默认值设置为 12。
重要说明: 请始终将此选项与
view.BENITTcpConnectCount 配置项结合使用。
|
view.defaultAppHeight | 无 | 指定已发布应用程序窗口的默认高度(以像素为单位)。在指定自定义桌面尺寸(view.defaultAppSize 属性设置为 "5")时,结合使用此属性和 view.defaultAppWidth。默认值为 "480"。 |
view.defaultAppWidth | 无 | 指定已发布应用程序窗口的默认宽度(以像素为单位)。在指定自定义桌面尺寸(view.defaultAppSize 属性设置为 "5")时,结合使用此属性和 view.defaultAppHeight。默认值为 "640"。 |
view.defaultBroker | -s, --serverURL= | 将您指定的名称添加到 Horizon Client 的服务器文本框中。指定一个完全限定域名。如果不使用默认的 443 端口,还可以指定一个端口号。 默认值为最近一次使用的值。 例如: --serverURL=https://view.company.com -s view.company.com --serverURL=view.company.com:1443 |
view.defaultDesktop | -n, --desktopName= | 当 autoConnectDesktop 设置为 "TRUE" 且用户有权访问多个远程桌面时,指定要使用的远程桌面。 指定的值是在“选择桌面”对话框中可以看到的名称。该名称通常为桌面池名称。 |
view.defaultDesktopHeight | 无 | 指定远程桌面窗口的默认高度(以像素为单位)。在指定自定义桌面尺寸(view.defaultDesktopSize 属性设置为 "5")时,结合使用此属性和 view.defaultDesktopWidth。 |
view.defaultDesktopSize | --desktopSize= | 设置远程桌面窗口的默认大小:
例如: --desktopSize="1280x800" --desktopSize="all" |
view.defaultDesktopWidth | 无 | 指定远程桌面窗口的默认宽度(以像素为单位)。在指定自定义桌面尺寸(view.defaultDesktopSize 属性设置为 "5")时,结合使用此属性和 view.defaultDesktopHeight。 |
view.defaultDomain | -d, --domainName= | 设置 Horizon Client 在所有连接中使用的域名,并将您指定的域名添加到身份验证对话框的域名文本框中。 |
view.defaultLogLevel | 无 | 设置 Horizon Client 日志的日志级别。将该属性设置为以下值之一:
默认值为 "3"。 |
view.defaultPassword | -p "-", --password="-" | 对于 VMware Blast、PCoIP 和 rdesktop 连接,始终指定 "-" 以从 stdin 读取密码。 设置 Horizon Client 在所有连接中使用的密码,如果服务器接受密码身份验证,则将该密码添加到身份验证对话框的密码文本框中。
注: 您不能使用空白密码。也就是说,您不能指定
--password=""。
|
view.defaultProtocol | --protocol= | 指定要使用的显示协议。指定 "PCOIP"、"BLAST" 或 "RDP"。这些值区分大小写。例如,如果您输入 rdp,那么将使用默认协议。默认设置是在 Horizon Console 中池的池设置下指定的值。 如果您使用 RDP,并且您想要使用 FreeRDP 而非 rdesktop,则必须同时使用 rdpClient 设置。 |
view.defaultUser | -u, --userName= | 设置 Horizon Client 在所有连接中使用的用户名,并将您指定的用户名添加到身份验证对话框的用户名文本框中。 在 kiosk 模式中,帐户名可基于客户端的 MAC 地址,或以可识别的前缀字符串为开头,例如 custom-。 |
view.enableDataSharing | 无 | 指定是否允许 Horizon Client 共享客户端系统上的匿名数据。 将值设置为 "TRUE" 或 "FALSE"。默认值为 "TRUE"。 |
view.enableDisplayScaling | 无 | 指定是否为所有远程桌面激活显示缩放功能。将值设置为 "TRUE" 或 "FALSE"。将此设置设为 "FALSE" 时,会为所有远程桌面停用显示缩放功能。如果未配置此设置或将此设置设为 "TRUE"(默认设置),将为所有远程桌面激活显示缩放功能。 |
view.enableFileAssociation | 无 | 启用或停用直接从本地文件系统中使用已发布的应用程序打开本地文件的功能。指定 "TRUE" 以启用此功能,或指定 "FALSE" 以停用此功能。有关更多信息,请参阅在已发布的应用程序中打开本地文件。 |
view.enableH264 | 无 | 启用或停用 H.264 解码。 指定 "TRUE" 或 "FALSE"。默认值为 "TRUE"。有关更多信息,请参阅为 Horizon Linux Client 配置 VMware Blast 选项。 |
view.enableHEVC | 无 | 启用或停用 HEVC 解码。 指定 "TRUE" 或 "FALSE"。默认值为 "TRUE"。有关更多信息,请参阅为 Horizon Linux Client 配置 VMware Blast 选项。 |
view.enableMMR | 无 | 启用或停用多媒体重定向 (MMR)。 指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 |
view.enableRelativeMouse | 无 | 指定是为当前远程桌面会话强制启用还是停用 Horizon Client 相对鼠标功能。如果设置此配置项,指定 "1" 将强制启用该功能,指定 "0" 将强制停用该功能。任何其他值均无效并会被忽略。在当前远程桌面会话期间,无法编辑指定的值。如果远程桌面不支持相对鼠标,则不使用此设置。如果未配置此设置(默认设置),最终用户可以从 Horizon Client 菜单栏中使用 来启用和停用相对鼠标功能。 |
view.enableSyncDesktopLayout | 无 | 指定是否将远程桌面的显示分辨率和缩放同步到连接服务器上存储的值。有关更多信息,请参阅自定义远程桌面的显示分辨率和显示缩放。
默认值为 "TRUE"。 |
view.fullScreen | --fullscreen | 在一个显示器上隐藏主机操作系统并以全屏模式打开 Horizon Client。此选项不会影响远程桌面会话的屏幕模式。 设置该配置项时,可指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 |
view.GlobalMaxDumpCount | 无 | 指定允许用于 Horizon Client 进程的最大核心转储文件数。默认值为 5。 |
view.hideClientAfterLaunchSession | --hideClientAfterLaunchSession | 远程桌面或已发布的应用程序打开后隐藏 VMware Horizon Client 窗口。 设置该配置项时,可指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 |
view.ipProtocolUsage | 无 | 指定连接到 Horizon Connection Server时使用的网络协议:
默认设置为“双重”。 |
view.kbdLayout | -k, --kbdLayout= |
指定键盘布局要使用的区域设置。
注:
rdesktop 使用区域设置代码,例如
"fr" 和
"de",而
freerdp 使用键盘布局 ID。关于这些 ID 列表,可使用以下命令:
xfreerdp --kbd-list 以下是对于 rdesktop 使用该命令行选项的示例: --kbdLayout="en-us" -k "fr" 以下是对于 freerdp 使用该命令行选项的示例: -k "0x00010407" |
view.kioskLogin | --kioskLogin | 指定 Horizon Client 使用 Kiosk 模式帐户进行身份验证。 设置该配置项时,可指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 例如,请参阅此表后面的 kiosk 模式示例。 |
无 | --launchMinimized | 以最小化模式启动 Horizon Client。在启动用户指定的远程桌面或已发布的应用程序时,Horizon Client 窗口保持最小化并隐藏在后台。 |
view.monitors | --monitors= numbered list | 允许您指定要用于 Horizon Client 的相邻显示器。使用 --allmonitors(或 view.allMonitors)指定要在所有显示器上使用全屏,并使用--monitors=编号列表指定要使用的部分显示器。 以下示例显示了在设有三个显示器彼此水平相邻的配置中,如何指定第一个和第二个显示器: --allmonitors --monitors="1,2" ` 为了帮助区分哪个物理显示器与 Horizon Client 中的显示器图标相关联,将在指定要使用的物理显示器的左上角显示一个矩形。该矩形具有选定显示器的图标所使用的相应颜色和编号。 |
view.noMenuBar | --nomenubar | 当客户端处于全屏模式时,隐藏 Horizon Client 菜单栏,以便用户无法访问用来从远程桌面注销、重置或断开连接的菜单选项。配置 kiosk 模式时使用该选项。 设置该配置项时,可指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 |
view.nonInteractive | -q, --nonInteractive | 通过跳过在命令行或配置属性中指定的屏幕,为最终用户隐藏不必要的用户界面步骤。 设置该配置项时,可指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 例如: --nonInteractive --serverURL="https://view.company.com" --userName="user1" --password="-" --domainName="xyz" --desktopName="Windows 10" |
view.once | --once | 指定在出现错误时不希望 Horizon Client 重试连接。 在使用 Kiosk 模式时,应指定此选项,并使用退出代码来处理错误。否则,可能难以远程停止 vmware-view 进程。 设置该配置项时,可指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 |
view.rdesktopOptions | --rdesktopOptions= | (使用 Microsoft RDP 显示协议时可用。)指定要转发到 rdesktop 应用程序的命令行选项。有关 rdesktop 选项的信息,请参阅 rdesktop 文档。 例如: --rdesktopOptions="-f -m" |
无 | -r, --redirect= | (使用 Microsoft RDP 显示协议时可用。)指定一个本地设备以供 rdesktop 重定向到远程桌面。 指定要传递到 rdesktop -r 选项的设备信息。您可以在一个命令中设置多个设备选项。 例如: --redirect="sound:off" |
view.rdpClient | --rdpclient= | (使用 Microsoft RDP 显示协议时可用。)指定要使用的 RDP 客户端类型。默认设置为 rdesktop。要改用 FreeRDP,请指定 xfreerdp。
注: 要使用 FreeRDP,您必须已安装正确的 FreeRDP 版本以及所有适用的补丁程序。有关更多信息,请参阅
使用 FreeRDP 和远程桌面进行 RDP 连接。
|
无 | --save | 保存上次成功登录时使用的用户名和域名,这样在系统下次提示您提供登录凭据时,便无需再输入这些信息。 |
view.sendCtrlAltDelToLocal | 无 | (使用 VMware Blast 或 PCoIP 显示协议时可用。)设置为 "TRUE" 时,会将组合键 Ctrl+Alt+Del 发送到客户端系统,而不是通过打开对话框来提示用户从远程桌面断开连接。默认值为 "FALSE"。
注: 如果您使用 Microsoft RDP 显示协议,则可使用
-K 选项(例如
vmware-view -K)实现此功能。
此选项与 /etc/vmware/view-keycombos-config 文件中的设置具有同等优先级。 |
view.sendCtrlAltDelToVM | 无 | (使用 VMware Blast 或 PCoIP 显示协议时可用。)设置为 "TRUE" 时,会将组合键 Ctrl+Alt+Del 发送到远程桌面,而不是通过打开对话框来提示用户从远程桌面断开连接。默认值为 "FALSE"。 此选项的优先级高于 /etc/vmware/view-keycombos-config 文件中的设置。 |
view.sendCtrlAltInsToVM | 无 | (使用 VMware Blast 或 PCoIP 显示协议时可用。)设置为 "TRUE" 时,会将组合键 Ctrl+Alt+Ins 发送到虚拟桌面,而不是发送 Ctrl+Alt+Del。默认值为 "FALSE"。
注: 要使用此功能,您还必须设置
使用备用键发送安全注意序列代理端组策略设置,该设置位于
pcoip.adm 模板文件中。有关更多信息,请参阅
《Horizon 远程桌面功能和 GPO》文档。
此选项的优先级低于 /etc/vmware/view-keycombos-config 文件中的设置。 |
view.shareRemovableStorage | 无 | 在设置为 "TRUE" 时,请启用允许访问可移动存储选项。默认值为 "TRUE"。 |
view.singleAutoConnect | --singleAutoConnect | 设置为 "TRUE" 时,如果用户仅有权访问一个远程桌面或应用程序,则在用户通过服务器的身份验证之后,会自动连接到远程桌面或已发布的应用程序。此选项可使用户无需从仅包含一个资源的列表中选择远程桌面或已发布的应用程序。默认值为 "FALSE"。 |
view.skipCRLRevocationCheck | --skipCRLRevocationCheck | 默认情况下,在连接到服务器时,Horizon Client 会检查并下载服务器的证书吊撤销表 (CRL)。此命令行选项指示 Horizon Client 在连接期间停止检查 CRL。 如果要设置配置密钥,请指定 "TRUE" 以停止检查 CRL。默认值为 "FALSE"。 |
view.sslCipherString | --sslCipherString= | 在建立加密 SSL 连接之前,配置密码列表来限制某些加密算法的使用。 有关密码字符串的列表,请参阅 http://www.openssl.org/docs/apps/ciphers.html 。 Horizon Client 默认值为 "!aNULL:kECDH+AESGCM:ECDH+AESGCM:RSA+AESGCM:kECDH+AES:ECDH+AES:RSA+AES"。 |
view.sslProtocolString | --sslProtocolString= | 在建立加密 SSL 连接之前,配置密码列表来限制某些加密协议的使用。 支持的协议包括 TLSv1.1 和 TLSv1.2。密码列表包含由冒号分隔的一个或多个协议字符串。字符串不区分大小写。 默认值为“TLSv1.1:TLSv1.2”。 |
view.sslVerificationMode | 无 | 设置服务器证书验证模式。 指定 "1":当证书未能通过任意验证检查时拒绝连接;指定 "2":对已使用自签名证书的连接发出警告但允许连接,或指定 "3":允许未经验证的连接。如果您指定 "3",将不会执行验证检查。默认值为 "2"。 |
view.UnauthenticatedAccessEnabled | --unauthenticatedAccessEnabled | 如果设置为 "TRUE",则启用未验证访问功能。 如果设置为 "FALSE” 或 "",则停用未验证访问功能。 设置处于可见状态并已取消选中。设置该配置项时,可指定 "TRUE" 或 "FALSE"。默认设置会将“未验证访问”功能配置为已停用。 例如: --unauthenticatedAccessEnabled="TRUE" |
设置处于可见状态并标记为已选中。
view.UnauthenticatedAccessAccount | --unauthenticatedAccessAccount | 指定将 unauthenticatedAccessEnabled 设置为 "TRUE" 时使用的帐户。 如果将 unauthenticatedAccessEnabled 设置为 "FALSE",则忽略该配置。 以下示例显示了如何将此命令行选项与 anonymous1 用户帐户结合使用: --unauthenticatedAccessAccount='anonymous1' |
view.usbAutoConnectAtStartUp | --usbAutoConnectAtStartUp= | 如果 USB 设备在连接远程桌面或已发布的应用程序之前插入到主机系统,则自动将 USB 设备重定向到该桌面或应用程序。 指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 |
view.usbAutoConnectOnInsert | --usbAutoConnectOnInsert= | 如果 USB 设备在连接远程桌面或已发布的应用程序之后插入到主机系统,则自动将 USB 设备重定向到该桌面或应用程序。 指定 "TRUE" 或 "FALSE"。默认值为 "FALSE"。 |
view.xfreerdpOptions | --xfreerdpOptions= | (使用 Microsoft RDP 显示协议时可用。)指定要转发到 xfreerdp 程序的命令行选项。有关 xfreerdp 选项的信息,请参阅 xfreerdp 文档。
注: 要使用 FreeRDP,您必须已安装正确的 FreeRDP 版本以及所有适用的补丁程序。有关更多信息,请参阅
使用 FreeRDP 和远程桌面进行 RDP 连接。
|
无 | --useExisting | 允许从单个会话中启动多个远程桌面和已发布的应用程序。指定此选项时,Horizon Client 确定是否已经有一个会话连接到同一服务器 URL。如果有,Horizon Client 将使用该会话,而不是启动新会话。 如果有一个会话连接到其他服务器 URL,Horizon Client 会断开与该会话的连接,然后启动一个连接到新服务器 URL 的新会话。如果存在多个此类会话,则 Horizon Client 会断开与最早会话的连接,然后再启动新会话。 在以下示例中,user1 启动 Calculator 应用程序并创建新的会话。 vmware-view -serverURL view.mycompany.com -userName user1 -password 'secret' -domainName domain -appName Calculator 在下一个示例中,user1 启动具有相同服务器 URL 的 Paint 应用程序,并使用相同的会话。 vmware-view -serverURL view.mycompany.com -userName user1 -password 'secret' -domainName domain -appName Paint --useExisting 在下一个示例中,user1 启动具有不同服务器 URL 的 Calculator 应用程序。Horizon Client 断开与具有 view.mycompany.com 的第一个会话的连接,然后启动具有 horizon.mycompany.com 的新会话。 vmware-view -serverURL horizon.mycompany.com -userName user1 -password 'secret' -domainName domain -appName Calculator --useExisting |
无 | --enableNla | (使用 FreeRDP 进行 RDP 连接时可用)启用网络级别身份验证 (NLA)。您必须将此选项和 --ignore-certificate 选项结合使用。有关更多信息,请参阅使用 FreeRDP 和远程桌面进行 RDP 连接。 如果您使用的是 FreeRDP,则默认情况下 NLA 处于关闭状态。 您必须已安装正确的 FreeRDP 版本以及所有适用的补丁程序。有关更多信息,请参阅使用 FreeRDP 和远程桌面进行 RDP 连接。
注:
rdesktop 应用程序不支持 NLA。
|
无 | --printEnvironmentInfo | 显示关于客户端设备环境的信息,包括其 IP 地址、MAC 地址、计算机名和域名。 对于 kiosk 模式,您可以基于 MAC 地址为客户端创建帐户。要显示 MAC 地址,需将此选项与 -s 选项结合使用。 例如: --printEnvironmentInfo -s view.company.com |
无 | --usb= | 指定要用于 USB 重定向的选项。有关更多信息,请参阅USB 重定向的系统要求。 |
无 | --version | 显示关于 Horizon Client 的版本信息。 |
无 | --tokenUserName | 对于 RSA SecurID 或 RADIUS 身份验证,请指定令牌用户名。如果不使用此选项,或者如果此选项为空,则将使用 Active Directory 用户名。 要指定 RSA SecurID 或 RADIUS 身份验证通行码,请使用 --passcode 选项。 以下示例显示了如何使用 -q 选项进行登录,而无需在 Horizon Client 中进行用户交互。如果未指定 -q 选项,则会在 Horizon Client 中显示 RSA SecurID 或 RADIUS 登录页面。 vmware-view --serverURL='12.345.67.89' -q --tokenUserName='pwduser' --userName='johndoe' --password='password' --domainName='mydomain' --passcode='passcode' |
无 | --passcode | 指定用于 RSA SecurID 或 RADIUS 身份验证的通行码。通行码只能使用一次。 将该选项与 --tokenUserName 选项结合使用。 |
Kiosk 模式示例
Kiosk 用户包括机场登记处的乘客、教室或图书馆内的学生、医疗数据录入工作站的医护人员或自助服务点的顾客。帐户与客户端设备(而不是用户)关联,因为用户不需要登录即可使用客户端设备或远程桌面。但仍可要求用户提供身份验证凭据来访问某些应用程序。
要设置 Kiosk 模式,您必须使用 Horizon Connection Server实例中的 vdmadmin 命令行界面,并执行《Horizon 8 管理指南》文档中有关 Kiosk 模式的章节所述的若干操作步骤。设置 Kiosk 模式后,可以在 Linux 客户端中使用 vmware-view 命令以 Kiosk 模式连接到远程桌面。
要以 Kiosk 模式从 Linux 客户端连接到远程桌面,您必须至少包含以下配置项或命令行选项。
配置项 | 等效的命令行选项 |
---|---|
view.kioskLogin | --kioskLogin |
view.nonInteractive | -q, --nonInteractive |
view.fullScreen | --fullscreen |
view.noMenuBar | --nomenubar |
view.defaultBroker | -s, --serverURL= |
view.hideClientAfterLaunchSession | --hideClientAfterLaunchSession |
不支持对 kiosk 模式省略上述任意配置设置。如果 Horizon Connection Server 设置为需要使用非默认的 kiosk 用户名,您还必须设置 fault-finders 属性或使用 -u 或 --user Name= 命令行选项。如果不需要使用非默认用户名,且您未指定用户名,Horizon Client 会派生并使用默认的 kiosk 用户名。
该示例中显示的命令可在 Linux 客户端系统中运行 Horizon Client 并具有以下特点:
- 用户帐户名基于客户端 MAC 地址。
- Horizon Client 以全屏模式运行,没有 Horizon Client 菜单栏。
- 用户会自动连接到指定的 Horizon Connection Server实例和远程桌面,系统不会提示用户输入登录凭据。
- 如果出现连接错误,根据收到的错误代码,某个脚本会运行或者某个 kiosk 监控应用程序可能会处理该错误。其结果可能是:客户端系统显示一个乱序屏幕,或在等待一段时间后尝试重新连接到 Horizon Connection Server。
./vmware-view --kioskLogin --nonInteractive --once --fullscreen --nomenubar --serverURL="server.mycomany.com" --userName="CM-00:11:22:33:44:55:66:77" --password="mypassword"