This document supports the version of each product listed and
supports all subsequent versions until the document is
replaced by a new edition. To check for more recent editions of
this document, see http://www.vmware.com/support/pubs.
EN-002372-00
Using VMware Horizon Client for iOS
You can find the most up-to-date technical documentation on the VMware Web site at:
hp://www.vmware.com/support/
The VMware Web site also provides the latest product updates.
If you have comments about this documentation, submit your feedback to:
3401 Hillview Ave.
Palo Alto, CA 94304
www.vmware.com
2 VMware, Inc.
Contents
Using VMware Horizon Client for iOS5
Setup and Installation7
1
System Requirements 7
System Requirements for Real-Time Audio-Video 8
Smart Card Authentication Requirements 8
Congure Smart Card Authentication 9
Touch ID Authentication Requirements 10
Supported Desktop Operating Systems 11
Preparing Connection Server for Horizon Client 11
Install or Upgrade Horizon Client on an iOS Device 12
Using Embedded RSA SecurID Software Tokens 13
Congure Advanced TLS/SSL Options 14
Congure VMware Blast Options 14
Congure the Horizon Client Default View 15
Congure AirWatch to Deliver Horizon Client to iOS Devices 15
Horizon Client Data Collected by VMware 16
Using URIs to Congure Horizon Client19
2
Syntax for Creating vmware-view URIs 19
Examples of vmware-view URIs 21
Managing Remote Desktop and Application Connections25
3
Connect to a Remote Desktop or Application 25
Seing the Certicate Checking Mode for Horizon Client 27
Manage Saved Servers 28
Select a Favorite Remote Desktop or Application 29
Disconnecting From a Remote Desktop or Application 29
Log O from a Remote Desktop 30
Manage Desktop and Application Shortcuts 30
Using 3D Touch with Horizon Client 31
Using Spotlight Search with Horizon Client 31
Using Split View and Slide Over with Horizon Client 32
VMware, Inc.
Using a Microsoft Windows Desktop or Application33
4
Feature Support Matrix for iOS 34
External Keyboards and Input Devices 36
Enable the Japanese 106/109 Keyboard Layout 37
Using the Real-Time Audio-Video Feature for Microphones 37
Using Native Operating System Gestures with Touch Redirection 37
Using the Unity Touch Sidebar with a Remote Desktop 38
3
Using VMware Horizon Client for iOS
Using the Unity Touch Sidebar with a Remote Application 40
Horizon Client Tools on a Mobile Device 41
Gestures 43
Multitasking 44
Copying and Pasting Text and Images 44
Saving Documents in a Remote Application 45
Congure Horizon Client to Support Reversed Mouse Buons 45
Screen Resolutions and Using External Displays 46
PCoIP Client-Side Image Cache 47
Suppress the Cellular Data Warning Message 47
Internationalization 47
Troubleshooting Horizon Client49
5
Collecting and Sending Logging Information 49
Enable Horizon Client Log Collection 49
Manually Retrieve and Send Horizon Client Log Files 50
Disable Horizon Client Log Collection 51
Reset a Remote Desktop or Application 51
Uninstall Horizon Client 52
Horizon Client Stops Responding or the Remote Desktop Freezes 52
Problem Establishing a Connection When Using a Proxy 52
Index55
4 VMware, Inc.
Using VMware Horizon Client for iOS
This guide, Using VMware Horizon Client for iOS, provides information about installing and using VMware
Horizon® Client™ software on an iOS device to connect to a remote desktop or application in the datacenter.
The information in this document includes system requirements and instructions for installing
Horizon Client. This document also provides tips for improving the user experience of navigating and using
Windows desktop elements on an iOS device such as an iPad.
This information is intended for administrators who need to set up a View deployment that includes iOS
client devices. The information is wrien for experienced system administrators who are familiar with
virtual machine technology and datacenter operations.
VMware, Inc. 5
Using VMware Horizon Client for iOS
6 VMware, Inc.
Setup and Installation1
Seing up a View deployment for iOS clients involves using certain Connection Server conguration
seings, meeting the system requirements for View servers and iOS clients, and installing the app for
Horizon Client from the Apple App Store. VMware also recommends that you set up a security server so
that your iOS clients will not need a VPN connection.
N In Horizon 7 and later, View Administrator is renamed Horizon Administrator. This document uses
the name View Administrator to refer to both View Administrator and Horizon Administrator.
This chapter includes the following topics:
“System Requirements,” on page 7
n
“System Requirements for Real-Time Audio-Video,” on page 8
n
“Smart Card Authentication Requirements,” on page 8
n
“Congure Smart Card Authentication,” on page 9
n
“Touch ID Authentication Requirements,” on page 10
n
“Supported Desktop Operating Systems,” on page 11
n
“Preparing Connection Server for Horizon Client,” on page 11
n
“Install or Upgrade Horizon Client on an iOS Device,” on page 12
n
“Using Embedded RSA SecurID Software Tokens,” on page 13
n
“Congure Advanced TLS/SSL Options,” on page 14
n
“Congure VMware Blast Options,” on page 14
n
“Congure the Horizon Client Default View,” on page 15
n
“Congure AirWatch to Deliver Horizon Client to iOS Devices,” on page 15
n
“Horizon Client Data Collected by VMware,” on page 16
n
System Requirements
The iOS device on which you install Horizon Client, and the peripherals it uses, must meet certain system
requirements.
Operating systems
External keyboards
VMware, Inc. 7
iOS 8.4.1 and later, including iOS 9.x and iOS 10
(Optional) iPad Keyboard Dock and Apple Wireless Keyboard (Bluetooth)
Using VMware Horizon Client for iOS
Smart card
authentication
Touch ID authentication
Connection Server,
Security Server, and
View Agent or
Horizon Agent
Display protocol for
View
Network protocol for
View
See “Smart Card Authentication Requirements,” on page 8.
See “Touch ID Authentication Requirements,” on page 10.
Latest maintenance release of View 5.3.x and later releases.
VMware recommends that you use a security server so that your iOS clients
will not require a VPN connection.
To use the Unity Touch feature with View 5.3.x desktops, the Remote
Experience Agent must be installed on the desktops.
Remote applications are available on Horizon 6.0 with View and later
servers.
PCoIP
n
VMware Blast (requires Horizon Agent 7.0 or later)
n
IPv4
n
IPv6 (requires iOS 9.2 or later)
n
For information about using View in an IPv6 environment, see the View
Installation document.
System Requirements for Real-Time Audio-Video
Real-Time Audio-Video works with standard audio devices and with standard conferencing applications
such as Skype, WebEx, and Google Hangouts. To support Real-Time Audio-Video, your View deployment
must meet certain software and hardware requirements.
I Only the audio-in feature is supported. The video feature is not supported.
View remote desktop
Client access device
The desktops must have View Agent 5.3 or later installed. For View Agent
5.3 desktops, the desktops must also have the corresponding Remote
Experience Agent installed. For example, if View Agent 5.3 is installed, you
must also install the Remote Experience Agent from View 5.3 Feature Pack 1.
See the View Feature Pack Installation and Administration document for View. If
you have View Agent 6.0 or later, or Horizon Agent 7.0 or later, no feature
pack is required.
To use Real-Time Audio-Video with RDS desktops and remote applications,
you must have Horizon Agent 7.0.2 or later.
Real-Time Audio-Video is supported on all iOS devices that run
Horizon Client for iOS. For more information, see “System Requirements,”
on page 7.
Smart Card Authentication Requirements
Client systems that use a smart card for user authentication must meet certain requirements.
Horizon Client for iOS supports using smart cards with remote desktops that have Windows 7, Windows
Vista, Windows XP, Windows 8.1, Windows 10, and Windows Server 2008 R2 guest operating systems. For
Microsoft RDS host-based desktops and applications, the Windows Server 2008 R2 and Windows Server
2012 R2 operating systems are supported. An iOS 8.4.1 or later operating system is required.
8 VMware, Inc.
Chapter 1 Setup and Installation
Each client system that uses a smart card for user authentication must have the following software and
hardware:
Horizon Client
n
A compatible smart card reader
n
Product-specic application drivers
n
You must also install product-specic application drivers on the remote desktops or Microsoft RDS host.
Users that authenticate with smart cards must have a smart card and each smart card must contain a user
certicate.
In addition to meeting these requirements for Horizon Client systems, other View components must meet
certain conguration requirements to support smart cards:
For information about conguring Connection Server to support smart card use, see "Seing Up Smart
n
Card Authentication" in the View Administration document.
You must add all applicable Certicate Authority (CA) certicates for all trusted user certicates to a
server truststore le on the Connection Server host or security server host. These certicates include
root certicates and must include intermediate certicates if the user's smart card certicate was issued
by an intermediate certicate authority.
For information about tasks you might need to perform in Active Directory to implement smart card
n
authentication, see "Seing Up Smart Card Authentication" in the View Administration document.
Enabling the Username Hint Field in Horizon Client
In some environments, smart card users can use a single smart card certicate to authenticate to multiple
user accounts. Users enter their user name in the Username hinteld during smart card sign-in.
To make the Username hinteld appear on the Horizon Client login dialog box, you must enable the smart
card user name hints feature for the Connection Server instance in View Administrator. The smart card user
name hints feature is supported only with Horizon 7 version 7.0.2 and later servers and agents. For
information about enabling the smart card user name hints feature, see "Seing Up Smart Card
Authentication" in the View Administration document.
If your environment uses an Access Point appliance rather than a security server for secure external access,
you must congure the Access Point appliance to support the smart card user name hints feature. The smart
card user name hints feature is supported only with Access Point 2.7.2 and later. For information about
enabling the smart card user name hints feature in Access Point, see the Deploying and Conguring AccessPoint document.
N Horizon Client still supports single-account smart card certicates when the smart card user name
hints feature is enabled.
Configure Smart Card Authentication
Conguration tasks include connecting and pairing the card reader with the device and seing the smart
card removal policy.
Prerequisites
Verify that you are using the correct version of the client, desktop agent, server, operating system, smart
n
card reader, and smart card. See “Smart Card Authentication Requirements,” on page 8.
If you have not already done so, perform the tasks described in "Prepare Active Directory for Smart
n
Card Authentication," in the View Installation document.
VMware, Inc. 9
Using VMware Horizon Client for iOS
Congure View servers to support smart card use. See the topic "Congure Smart Card
n
Authentication," in the View Administration document.
Procedure
1Pair the device with the smart card reader, according to the documentation provided by the
manufacturer of the reader.
If your iOS device has a 30-pin connector, you can plug the smart card reader into the connector. For
iPad Air and iPhone 5S, which have Lightning interfaces, you must use a 30-pin adapter to plug the
smart card reader into the device's 30-pin connector.
2Congure the smart card removal policy.
OptionDescription
Set the policy on the server
Set the policy on the desktop
If you use View Administrator to set a policy, the choices are to disconnect
users from Connection Server when they remove their smart cards or to
keep users connected to Connection Server when they remove their smart
cards and let them start new desktop or application sessions without
reauthenticating.
aIn View Administrator, select View > Servers.
b On the Connection Servers tab, select the Connection Server instance
and click Edit.
cOn the Authentication tab, select or deselect the Disconnect user
sessions on smart card removal check box to congure the smart card
removal policy.
d Click OK to save your changes.
e Restart the Connection Server service to make your changes take eect.
If you select the Disconnect user sessions on smart card removal check
box, Horizon Client returns to the Recent screen when users remove their
smart cards.
If you use the Group Policy Editor (gpedit.msc), you have the following
possible seings: no action, lock workstation, force log o, or Disconnect if
a Remote Desktop Services session.
After you open gpedit.msc in the desktop operating system, go to
Windows > Security > Local policies > Security options >
Interactive logon: smart card removal behavior. Run the
gpupdate /force command after you change the conguration to force a
group policy refresh.
Touch ID Authentication Requirements
To use Touch ID for user authentication in Horizon Client, you must meet certain requirements.
iPad and iPhone models
Operating system
requirements
Connection Server
requirements
10 VMware, Inc.
Any iPad or iPhone model that supports Touch ID, for example, iPad Air 2
and iPhone 6.
iOS 8 or later.
n
Add at least one ngerprint in the Touch ID & Passcode seing.
n
Horizon 6 version 6.2 or a later release.
n
Enable biometric authentication in Connection Server. For information,
n
see "Congure Biometric Authentication" in the View Administration
document.
Chapter 1 Setup and Installation
The Connection Server instance must present a valid root-signed
n
certicate to Horizon Client.
Horizon Client
requirements
Set the certicate checking mode to Never connect to untrusted servers
n
or Warn before connecting to untrusted servers. For information aboutseing the certicate checking mode, see “Seing the Certicate
Checking Mode for Horizon Client,” on page 27.
Enable Touch ID by tapping Enable Touch ID on the View server login
n
screen. After you successfully log in, your Active Directory credentials
are stored securely in the iOS device's Keychain. The Enable Touch ID
option is shown the rst time you log in and does not appear after Touch
ID is enabled.
You can use Touch ID with smart card authentication and as part of two-factor authentication with RSA
SecurID and RADIUS authentication. If you use Touch ID with smart card authentication, Horizon Client
connects to the server after you enter your PIN and the Touch ID login screen does not appear.
Supported Desktop Operating Systems
Administrators create virtual machines with a guest operating system and install agent software in the guest
operating system. End users can log in to these virtual machines from a client device.
For a list of the supported Windows guest operating systems, see the "Supported Operating Systems for
View Agent" topic in the View 5.x or 6.x installation documentation. See the "Supported Operating Systems
for Horizon Agent" topic in the Horizon 7 installation documentation.
Some Linux guest operating systems are also supported if you have View Agent 6.1.1 or later, or
Horizon Agent 7.0 or later. For information about system requirements, conguring Linux virtual machines
for use in Horizon 6 or Horizon 7, and a list of supported features, see Seing Up Horizon 6 for Linux
Desktops, which is part of the Horizon 6, version 6.1 documentation, or see Seing Up Horizon 7 for Linux
Desktops.
Preparing Connection Server for Horizon Client
Administrators must perform specic tasks to enable end users to connect to remote desktops and
applications.
Before end users can connect to Connection Server or a security server and access a remote desktop or
application, you must congure certain pool seings and security seings:
If you plan to use Access Point, congure Connection Server to work with Access Point. See Deploying
n
and Conguring Access Point. Access Point appliances fulll the same role that was previously played by
only security servers.
If you are using a security server, verify that you are using the latest maintenance releases of
n
Connection Server 5.3.x and Security Server 5.3.x or later releases. For more information, see the View
Installation document.
If you plan to use a secure tunnel connection for client devices and if the secure connection is
n
congured with a DNS host name for Connection Server or a security server, verify that the client
device can resolve this DNS name.
To enable or disable the secure tunnel, in View Administrator, go to the Edit View Connection Server
Seings dialog box and use the check box called Use secure tunnel connection to desktop.
Verify that a desktop or application pool has been created and that the user account that you plan to use
n
is entitled to access the pool.
VMware, Inc. 11
Using VMware Horizon Client for iOS
For Connection Server 5.3.x, see the topics about creating desktop pools in the View Administration
document. For Connection Server 6.0 and later, see the topics about creating desktop and application
pools in the Seing Up Desktop and Application Pools in View document.
To use two-factor authentication with Horizon Client, such as RSA SecurID or RADIUS authentication,
n
you must enable this feature on Connection Server. For more information, see the topics about twofactor authentication in the View Administration document.
To use Touch ID authentication, you must enable biometric authentication in Connection Server.
n
Biometric authentication is supported in Horizon 6 version 6.2 and later. For more information, see
"Congure Biometric Authentication" in the View Administration document.
To enable end users to save their passwords with Horizon Client, so that they do not always need to
n
supply credentials when connecting to a Connection Server instance, congure View LDAP for this
feature on the Connection Server host.
Users can save their passwords if View LDAP is congured to allow it, if the Horizon Client certicate
verication mode is set to Warn before connecting to untrusted servers or Never connect to untrusted
servers, and if Horizon Client can fully verify the server certicate that Connection Server presents. For
instructions, see "Saving Credentials in Mobile and Mac Horizon Clients" in the View Administration
document.
Verify that the desktop or application pool is set to use the VMware Blast display protocol or the PCoIP
n
display protocol. For Connection Server 5.3.x, see the View Administration document. For Connection
Server 6.0 and later, see the Seing Up Desktop and Application Pools in View document.
Install or Upgrade Horizon Client on an iOS Device
You can install Horizon Client from the VMware Downloads page or from the App Store.
Prerequisites
If you have not already set up the iOS device, do so. See the user guide from Apple.
n
Verify that you have the URL for a download page that contains the Horizon Client installer. This URL
n
might be the VMware Downloads page at hp://www.vmware.com/go/viewclients, or it might be the
URL for a Connection Server instance.
Procedure
1On your iOS device, Mac, or PC, browse to the URL for downloading the installer le, or search the
App Store for the Horizon Client app.
2Download the app.
3If you downloaded the app to a Mac or PC, connect your iOS device to the computer and follow the
onscreen instructions in iTunes.
4To determine whether the installation succeeded, verify that the Horizon app icon appears on the iOS
device.
12 VMware, Inc.
Using Embedded RSA SecurID Software Tokens
If you create and distribute RSA SecurID software tokens to end users, they need enter only their PIN, rather
than PIN and token code, to authenticate.
Setup Requirements
You can use Compressed Token Format (CTF) or dynamic seed provisioning, which is also called CT-KIP
(Cryptographic Token Key Initialization Protocol), to set up an easy-to-use RSA authentication system. With
this system, you generate a URL to send to end users. To install the token, end users paste this URL directly
into Horizon Client on their client devices. The dialog box for pasting this URL appears when end users
connect to Connection Server with Horizon Client.
After the software token is installed, end users enter a PIN to authenticate. With external RSA tokens, end
users must enter a PIN and the token code generated by a hardware or software authentication token.
The following URL prexes are supported if end users will be copying and pasting the URL into
Horizon Client when Horizon Client is connected to an RSA-enabled Connection Server instance:
viewclient-securid://
n
com.rsa.securid.iphone://
n
Chapter 1 Setup and Installation
com.rsa.securid://
n
For end users who will be installing the token by tapping the URL, only the prexviewclient-securid:// is
supported.
For information about using dynamic seed provisioning or le-based (CTF) provisioning, see the Web page
RSA SecurID Software Token for iPhone Devices at hp://www.rsa.com/node.aspx?id=3652 or RSA SecurID
Software Token for Android at hp://www.rsa.com/node.aspx?id=3832.
Instructions to End Users
When you create a CTFString URL or CT-KIP URL to send to end users, you can generate a URL with or
without a password or activation code. You send this URL to end users in an email that must include the
following information:
Instructions for navigating to the Install Software Token dialog box.
n
Tell end users to tap External Token in the Horizon Client dialog box that prompts them for RSA
SecurID credentials when they connect to a Connection Server instance.
CTFString URL or CT-KIP URL in plain text.
n
If the URL has formaing on it, end users will get an error message when they try to use it in
Horizon Client.
Activation code, if the CT-KIP URL that you create does not already include the activation code.
n
End users must enter this activation code in a text eld of the dialog box.
If the CT-KIP URL includes an activation code, tell end users that they need not enter anything in the
n
Password or Activation Code text box in the Install Software Token dialog box.
VMware, Inc. 13
Using VMware Horizon Client for iOS
Configure Advanced TLS/SSL Options
You can select the security protocols and cryptographic algorithms that are used to encrypt communications
between Horizon Client and Horizon servers and between Horizon Client and the agent in the remote
desktop.
By default, TLSv1.0, TLSv1.1, and TLSv1.2 are enabled. SSL v2.0 and 3.0 are not supported. The default
cipher control string is "!aNULL:kECDH+AESGCM:ECDH+AESGCM:RSA+AESGCM:kECDH+AES:ECDH
+AES:RSA+AES".
If you congure a security protocol for Horizon Client that is not enabled on the Horizon server to which the
client connects, a TLS/SSL error occurs and the connection fails.
For information about conguring the security protocols that are accepted by Connection Server instances,
see the View Security document.
Procedure
1Tap at the boom of the Horizon Client screen.
2Tap Advanced SSL Options.
3Make sure that the Reset to Default option is set to o.
4To enable or disable a security protocol, tap the On or toggle next to the security protocol name.
5To change the cipher control string, replace the default string.
6(Optional) If you need to revert to the default seings, tap Reset in the upper right corner of the screen.
Your changes take eect the next time you connect to the server.
Configure VMware Blast Options
You can congure H.264 decoding and network protocol options for remote desktop and application
sessions that use the VMware Blast display protocol.
Prerequisites
This feature requires Horizon Agent 7.0 or later.
Procedure
1Tap at the boom of the Horizon Client screen.
2Tap VMware Blast.
14 VMware, Inc.
3Congure the decoding and network protocol options.
OptionDescription
H.264
UDP
Select this option to allow H.264 decoding in Horizon Client. When this
option is selected (the default seing), Horizon Client uses H.264 decoding
if the agent supports H.264 software encoding. If the agent does not
support H.264 software encoding, Horizon Client uses JPG/PNG decoding.
Deselect this option to use JPG/PNG decoding.
Select this option to allow UDP networking in Horizon Client. When this
option is selected (the default seing), Horizon Client uses UDP
networking if UDP connectivity is available. If UDP networking is blocked,
Horizon Client uses TCP networking.
Deselect this option to use TCP networking.
N UDP is disabled by default on a Horizon remote desktop. For UDP
to work, it must be enabled on the desktop, the client, and the Blast Secure
Gateway (BSG).
Your changes take eect the next time a user connects to a remote desktop or application and selects the
VMware Blast display protocol. Your changes do not aect existing VMware Blast sessions.
Configure the Horizon Client Default View
You can congure whether the Recent screen or the Servers screen appears when you launch Horizon Client.
Chapter 1 Setup and Installation
Procedure
1Tap at the boom of the Horizon Client screen.
2Tap Default View.
3Tap an option to select the default view.
OptionDescription
Recent
Servers
The Recent screen appears when you launch Horizon Client. The Recent
screen contains shortcuts to recently used desktops and applications. This
is the default seing.
The Servers screen appears when you launch Horizon Client. The Servers
screen contains shortcuts to the servers that you added to Horizon Client.
The default view you selected takes eect immediately.
Configure AirWatch to Deliver Horizon Client to iOS Devices
You can congure AirWatch to deliver Horizon Client to iOS device users.
You can optionally specify a default list of Connection Server instances. The Connection Server instances
that you specify appear as shortcuts in Horizon Client.
Prerequisites
Install and deploy AirWatch. See hp://www.air-watch.com.
n
Become familiar with the AirWatch console. This procedure assumes you know how to use the
n
AirWatch console. For more information, see the AirWatch documentation or online help.
Procedure
1Log in to the AirWatch console as an administrator.
VMware, Inc. 15
Using VMware Horizon Client for iOS
2Select Accounts > Users > List View, click Add User, and add user accounts for the users who will run
Horizon Client on their mobile devices.
3Select Accounts > Users > User Groups, click Add, and create a user group for the user accounts that
you created.
4Upload and add the Horizon Client application to AirWatch.
aSelect Apps & Books > Applications > List View and click Add Application on the Public tab.
bSearch for and select VMware Horizon Client for Apple iOS in the App Store.
cOn the Info tab, type an application name and specify the supported iOS device models.
dOn the Assignment tab, assign the Horizon Client application to the user group that you created.
e(Optional) To congure a default Connection Server instance, on the Deployment tab, select the
Send Application check box, type servers in the Key text box, select
String from the Value Type drop-down menu, and type an IP address or host name in the Value text box.
servers is case sensitive. To specify a list of Connection Server instances, type multiple IP
addresses or host names, separated by commas, in the Value text box.
For example: 123.456.1.1, viewserver4.mydomain.com, 123.456.1.2
N This feature is supported only for iOS 7 and later devices. You cannot push a default
Connection Server list to an iOS 6 device.
fPublish the Horizon Client application.
5Install and set up the AirWatch MDM Agent on each iOS device.
You can download the AirWatch MDM Agent from iTunes.
6Use the AirWatch console to install the Horizon Client application on the mobile devices.
You cannot install the Horizon Client application before the eective date on the Deployment tab.
AirWatch delivers Horizon Client to the iOS devices in the user group that you associated with the
Horizon Client application.
When a user launches Horizon Client, Horizon Client communicates with the AirWatch MDM Agent on the
device. If you congured a default list of Connection Server instances, AirWatch pushes the server
information to the AirWatch MDM Agent on the device and shortcuts for those servers appear in
Horizon Client.
What to do next
You can use the AirWatch console to edit the Horizon Client application and push those changes to iOS
devices. For example, you can add a default Connection Server instance to the server list for the
Horizon Client application.
Horizon Client Data Collected by VMware
If your company participates in the customer experience improvement program, VMware collects data from
certain Horizon Client elds. Fields containing sensitive information are made anonymous.
VMware collects data on the clients to prioritize hardware and software compatibility. If your company's
administrator has opted to participate in the customer experience improvement program, VMware collects
anonymous data about your deployment in order to improve VMware's response to customer requirements.
No data that identies your organization is collected. Horizon Client information is sent rst to Connection
Server and then on to VMware, along with data from Connection Server instances, desktop pools, and
remote desktops.
16 VMware, Inc.
Chapter 1 Setup and Installation
Although the information is encrypted while in transit to Connection Server, the information on the client
system is logged unencrypted in a user-specic directory. The logs do not contain any personally identiable
information.
The administrator who installs Connection Server can select whether to participate in the VMware customer
experience improvement program while running the Connection Server installation wizard, or an
administrator can set an option in View Administrator after the installation.
Table 1‑1. Data Collected from Horizon Clients for the Customer Experience Improvement Program
Is This Field
Made
Anonymous
Description
Company that produced the
Horizon Client application
Product nameNoVMware Horizon Client
Client product versionNo(The format is x.x.x-yyyyyy, where x.x.x is the client version
Client binary architectureNoExamples include the following:
Client build nameNoExamples include the following:
Host operating systemNoExamples include the following:
Host operating system kernelNoExamples include the following:
Host operating system architectureNoExamples include the following:
Host system modelNoExamples include the following:
?Example Value
NoVMware
number and yyyyyy is the build number.)
i386
n
x86_64
n
arm
n
VMware-Horizon-Client-Win32-Windows
n
VMware-Horizon-Client-Linux
n
VMware-Horizon-Client-iOS
n
VMware-Horizon-Client-Mac
n
VMware-Horizon-Client-Android
n
VMware-Horizon-Client-WinStore
n
Windows 8.1
n
Windows 7, 64-bit Service Pack 1 (Build 7601 )
n
iPhone OS 5.1.1 (9B206)
n
Ubuntu 12.04.4 LTS
n
Mac OS X 10.8.5 (12F45)
n
Windows 6.1.7601 SP1
n
Darwin Kernel Version 11.0.0: Sun Apr 8 21:52:26 PDT
n
2012; root:xnu-1878.11.10~1/RELEASE_ARM_S5L8945X
Darwin 11.4.2
n
Linux 2.6.32-44-generic #98-Ubuntu SMP Mon Sep 24
n
17:27:10 UTC 2012
unknown (for Windows Store)
n
x86_64
n
i386
n
armv71
n
ARM
n
Dell Inc. OptiPlex 960
n
iPad3,3
n
MacBookPro8,2
n
Dell Inc. Precision WorkStation T3400 (A04 03/21/2008)
n
VMware, Inc. 17
Using VMware Horizon Client for iOS
Table 1‑1. Data Collected from Horizon Clients for the Customer Experience Improvement Program
(Continued)
Description
Host system CPUNoExamples include the following:
Number of cores in the host system's
processor
MB of memory on the host systemNoExamples include the following:
Number of USB devices connectedNo2 (USB device redirection is supported only for Linux,
Maximum concurrent USB device
connections
USB device vendor IDNoExamples include the following:
USB device product IDNoExamples include the following:
USB device familyNoExamples include the following:
USB device usage countNo(Number of times the device was shared)
Is This Field
Made
Anonymous
?Example Value
Intel(R) Core(TM)2 Duo CPU E8400 @ 3.00GH
n
Intel(R) Core(TM)2 Quad CPU Q6600 @ 2.40GH
n
unknown (for iPad)
n
No
For example: 4
4096
n
unknown (for Windows Store)
n
Windows, and Mac clients.)
No2
Kingston
n
NEC
n
Nokia
n
Wacom
n
DataTraveler
n
Gamepad
n
Storage Drive
n
Wireless Mouse
n
Security
n
Human Interface Device
n
Imaging
n
18 VMware, Inc.
Using URIs to Configure
Horizon Client2
Using uniform resource identiers (URIs), you can create a Web page or an email with links that end users
click to start Horizon Client, connect to a server, and open a specic desktop or application with specicconguration options.
You can simplify the process of connecting to a remote desktop or application by creating Web or email links
for end users. You create these links by constructing URIs that provide some or all the following
information, so that your end users do not need to supply it:
Connection Server address
n
Port number for Connection Server
n
Active Directory user name
n
RADIUS or RSA SecurID user name, if dierent from the Active Directory user name
n
Domain name
n
Desktop or application display name
n
Actions including reset, log out, and start session
n
To construct a URI, you use the vmware-view URI scheme with Horizon Client specic path and query parts.
N You can use URIs to start Horizon Client only if the client software is already installed on client
computers.
This chapter includes the following topics:
“Syntax for Creating vmware-view URIs,” on page 19
n
“Examples of vmware-view URIs,” on page 21
n
Syntax for Creating vmware-view URIs
Syntax includes the vmware-view URI scheme, a path part to specify the desktop or application, and,
optionally, a query to specify desktop or application actions or conguration options.
URI Specification
Use the following syntax to create URIs to start Horizon Client:
The only required element is the URI scheme, vmware-view. For some versions of some client operating
systems, the scheme name is case-sensitive. Therefore, use vmware-view.
I In all parts, non-ASCII characters must rst be encoded according to UTF-8 [STD63], and then
each octet of the corresponding UTF-8 sequence must be percent-encoded to be represented as URI
characters.
For information about encoding for ASCII characters, see the URL encoding reference at
hp://www.utf8-chartable.de/.
authority-part
path-part
query-part
Species the server address and, optionally, a user name, a non-default port
number, or both. Underscores (_) are not supported in server names. Server
names must conform to DNS syntax.
To specify a user name, use the following syntax:
user1@server-address
You cannot specify a UPN address, which includes the domain. To specify
the domain, you can use the domainName query part in the URI.
To specify a port number, use the following syntax:
server-address:port-number
Species the desktop or application. Use the desktop display name or
application display name. This name is the one specied in View
Administrator when the desktop or application pool was created. If the
display name has a space in it, use the %20 encoding mechanism to represent
the space.
Species the conguration options to use or the desktop or application
actions to perform. Queries are not case-sensitive. To use multiple queries,
use an ampersand (&) between the queries. If queries conict with each
other, the last query in the list is used. Use the following syntax:
query1=value1[&query2=value2...]
Supported Queries
This topic lists the queries that are supported for this type of Horizon Client. If you are creating URIs for
multiple types of clients, such as desktop clients and mobile clients, see the Using VMware Horizon Client
guide for each type of client system.
action
20 VMware, Inc.
Table 2‑1. Values That Can Be Used With the action Query
ValueDescription
browse
start-session
Displays a list of available desktops and applications hosted on the
specied server. You are not required to specify a desktop or
application when using this action.
If you use the browse action and specify a desktop or application,
the desktop or application is highlighted in the list of available
items.
Opens the specied desktop or application. If no action query is
provided and the desktop or application name is provided,
start-session is the default action.
Chapter 2 Using URIs to Configure Horizon Client
Table 2‑1. Values That Can Be Used With the action Query (Continued)
ValueDescription
reset
logoff
Shuts down and restarts the specied desktop or remote
application. Unsaved data is lost. Reseing a remote desktop is the
equivalent of pressing the Reset buon on a physical PC.
Logs the user out of the guest operating system in the remote
desktop. If you specify an application, the action is ignored or the
end user sees the warning message "Invalid URI action."
args
appProtocol
defaultLaunchView
desktopProtocol
domainName
tokenUserName
Species command-line arguments to add to remote application launch. Use
the syntax args=value, where value is a string. Use percent encoding for the
following characters:
For a colon (:), use %3A
n
For a back slash (\), use %5C
n
For a space ( ), use %20
n
For a double quotation mark ("), use %22
n
For example, to specify the lename"My new file.txt" for the Notepad++
application, use %22My%20new%20file.txt%22.
For remote applications, valid values are PCOIP and BLAST. For example, to
specify PCoIP, use the syntax appProtocol=PCOIP.
Sets the default launch view for Horizon Client. Valid values are recent and
servers.
For remote desktops, valid values are PCOIP and BLAST. For example, to
specify PCoIP, use the syntax desktopProtocol=PCOIP.
The NETBIOS domain name associated with the user who is connecting to
the remote desktop or application. For example, you might use mycompany
rather than mycompany.com.
Species the RSA or RADIUS user name. Use this query only if the RSA or
RADIUS user name is dierent from the Active Directory user name. If you
do not specify this query and RSA or RADIUS authentication is required, the
Windows user name is used. The syntax is tokenUserName=name.
Examples of vmware-view URIs
You can create hypertext links or buons with the vmware-view URI scheme and include these links in email
or on a Web page. Your end users can click these links to, for example, open a particular remote desktop
with the startup options you specify.
URI Syntax Examples
Each URI example is followed by a description of what the end user sees after clicking the URI link.
Horizon Client starts and connects to the view.mycompany.com server. The login box prompts the user for
a user name, domain name, and password. After a successful login, the client connects to the desktop
whose display name is displayed as Primary Desktop, and the user is logged in to the guest operating
system.
N The default display protocol and window size are used. The default display protocol is PCoIP.
The default window size is full screen.
This URI has the same eect as the previous example, except that it uses the nondefault port of 7555 for
Connection Server. (The default port is 443.) Because a desktop identier is provided, the desktop opens
even though the start-session action is not included in the URI.
Horizon Client starts and connects to the view.mycompany.com server. In the login box, the User name
text box is populated with the name fred. The user must supply the domain name and password. After
a successful login, the client connects to the desktop whose display name is displayed as FinanceDesktop, and the user is logged in to the guest operating system. The connection uses the PCoIP
display protocol.
Horizon Client starts and connects to the view.mycompany.com server. In the login box, the user must
supply the user name, domain name, and password. After a successful login, the client connects to the
application whose display name is displayed as Calculator. The connection uses the VMware Blast
display protocol.
Horizon Client starts and connects to the view.mycompany.com server. In the login box, the User name
text box is populated with the name fred, and the Domain text box is populated with mycompany. The
user must supply only a password. After a successful login, the client connects to the desktop whose
display name is displayed as Finance Desktop, and the user is logged in to the guest operating system.
6
vmware-view://view.mycompany.com/
Horizon Client starts and the user is taken to the login prompt for connecting to the
Horizon Client starts and connects to the view.mycompany.com server. The login box prompts the user for
a user name, domain name, and password. After a successful login, Horizon Client displays a dialog
box that prompts the user to conrm the reset operation for Primary Desktop. After the reset occurs,
depending on the type of client, the user might see a message that indicates whether the reset was
successful.
N This action is available only if a View administrator has enabled this feature for end users.
8
vmware-view://
If the client is already running, the Horizon Client application comes to the foreground. If the client is
not already running, Horizon Client starts.
9
vmware-view://?defaultlaunchview=recent
Horizon Client starts and the user sees the Recent screen.
Launches My Notepad++ on server 10.10.10.10 and passes the argument My new file.txt in the
application launch command. The lename is enclosed in double quotes because it contains spaces.
Launches Notepad++ 12 on server 10.10.10.10 and passes the argument a.text b.txt in the application
launch command. Because the argument is not enclosed in quotes, a space separates the lenames and
the two les are opened separately in Notepad++.
N Applications can dier in the way they use command line arguments. For example, if you pass
the argument a.txt b.txt to Wordpad, Wordpad will open only one le,a.txt.
HTML Code Examples
You can use URIs to make hypertext links and buons to include in emails or on Web pages. The following
examples show how to use the URI from the rst URI example to code a hypertext link that says, Test Link,
and a buon that says, .
Use Horizon Client to connect to a server, edit the list of servers you connect to, log in to or o of remote
desktops, and use remote applications. For troubleshooting purposes, you can also reset remote desktops
and applications.
Depending on how the administrator congures policies for remote desktops, end users might be able to
perform many operations on their desktops.
This chapter includes the following topics:
“Connect to a Remote Desktop or Application,” on page 25
n
“Seing the Certicate Checking Mode for Horizon Client,” on page 27
n
“Manage Saved Servers,” on page 28
n
“Select a Favorite Remote Desktop or Application,” on page 29
n
“Disconnecting From a Remote Desktop or Application,” on page 29
n
“Log O from a Remote Desktop,” on page 30
n
“Manage Desktop and Application Shortcuts,” on page 30
n
“Using 3D Touch with Horizon Client,” on page 31
n
“Using Spotlight Search with Horizon Client,” on page 31
n
“Using Split View and Slide Over with Horizon Client,” on page 32
n
Connect to a Remote Desktop or Application
To connect to a remote desktop or application, you must provide the name of a server and supply
credentials for your user account.
To use remote applications, you must connect to Connection Server 6.0 or later.
N Before you have end users access their remote desktops, test that you can log in to a remote desktop
from a client device.
Prerequisites
Obtain credentials to log in, such as an Active Directory user name and password, RSA SecurID user
n
name and passcode, or RADIUS authentication user name and passcode.
Obtain the NETBIOS domain name for logging in. For example, you might use mycompany rather than
n
mycompany.com.
VMware, Inc.
25
Using VMware Horizon Client for iOS
Perform the administrative tasks described in “Preparing Connection Server for Horizon Client,” on
n
page 11.
If you are outside the corporate network and are not using a security server to access the remote
n
desktop, verify that your client device is set up to use a VPN connection and turn on that connection.
I VMware recommends using a security server rather than a VPN.
If your company has an internal wireless network to provide routable access to remote desktops that
your device can use, you do not have to set up a View security server or VPN connection.
Verify that you have the fully qualied domain name (FQDN) of the server that provides access to the
n
remote desktop or application. Underscores (_) are not supported in server names. You also need the
port number if the port is not 443.
If you plan to use embedded RSA SecurID software, verify that you have the correct CT-KIP URL and
n
activation code. See “Using Embedded RSA SecurID Software Tokens,” on page 13.
Congure the certicate checking mode for the SSL certicate presented by Connection Server. See
n
“Seing the Certicate Checking Mode for Horizon Client,” on page 27.
If you plan to use Touch ID to authenticate, add at least one ngerprint in the Touch ID & Passcode
n
seing on your iOS device. For complete Touch ID authentication requirements, see “Touch ID
Authentication Requirements,” on page 10.
Procedure
1If a VPN connection is required, turn on the VPN.
2Tap the Horizon app icon on the Home screen.
3Connect to a server.
OptionAction
Connect to a new server
Connect to an existing server
Enter the name of a server, enter a description (optional), and tap Add
Server.
Tap the server icon on the Servers screen.
Connections between Horizon Client and servers always use SSL. The default port for SSL connections
is 443. If the server is not congured to use the default port, use the format shown in this example:
view.company.com:1443.
4If a smart card is required or optional, select the smart card certicate to use and enter your PIN.
If your smart card has only one certicate, that certicate is already selected. If there are many
certicates, you can scroll through them if necessary.
5If you are prompted for RSA SecurID credentials or RADIUS authentication credentials, either type
your credentials or, if you plan to use an embedded RSA SecurID token, install an embedded token.
OptionAction
Existing token
Install software token
If you use a hardware authentication token or software authentication
token on a smart phone, enter your user name and passcode. The passcode
might include both a PIN and the generated number on the token.
Click External Token. In the Install Software Token dialog box, paste the
CT-KIP URL or CTFString URL that your administrator sent to you in
email. If the URL contains an activation code, you do not need to enter
anything in the Password or Activation Code text box.
26 VMware, Inc.
Chapter 3 Managing Remote Desktop and Application Connections
6If you are prompted a second time for RSA SecurID credentials or RADIUS authentication credentials,
enter the next generated number on the token.
Do not enter your PIN and do not enter the same generated number entered previously. If necessary,
wait until a new number is generated.
If this step is required, it is required only when you mistype the rst passcode or when congurationseings in the RSA server change.
7(Optional) If the Enable Touch ID seing is available, turn the seing on to use Touch ID to
authenticate.
The Enable Touch ID seing is available only if biometric authentication is enabled on the server and
you have not previously authenticated with Touch ID.
8If you are prompted for a user name and password, supply Active Directory credentials.
aType the user name and password of a user who is entitled to use at least one desktop or
application pool.
bSelect a domain.
c(Optional) Tap to toggle the Remember this Password option to on if your administrator has
enabled this feature and if the server certicate can be fully veried.
dTap Login.
If Touch ID is enabled and you are logging in for the rst time, your Active Directory credentials are
stored securely in the iOS devices's Keychain for future use.
9If you are prompted for Touch ID authentication, place your nger on the Homebuon.
10 (Optional) Tap at the boom of the Horizon Client screen and tap Preferred Protocol to select
the display protocol to use.
VMware Blast provides beerbaery life and is the best protocol for high-end 3D and mobile device
users. The default display protocol is PCoIP.
11 Tap a desktop or application to connect to it.
If you are using smart card authentication, you are not prompted to supply your PIN again, but the
login process takes longer than if you use Active Directory authentication.
If you are connecting to a session-based remote desktop, which is hosted on a Microsoft RDS host, and
if the desktop is already set to use the Microsoft RDP display protocol, you cannot connect immediately.
You are prompted to have the system log you o the remote operating system so that a connection can
be made with the PCoIP display protocol or the VMware Blast display protocol. VMware Blast requires
Horizon Agent 7.0 or later.
After you connect to a desktop or application for the rst time, a shortcut for the desktop or application is
saved to the Recent screen. The next time you want to connect to the remote desktop or application, you can
tap the shortcut instead of typing the server's name.
Setting the Certificate Checking Mode for Horizon Client
Administrators and sometimes end users can congure whether client connections are rejected if any or
some server certicate checks fail.
Certicate checking occurs for SSL connections between Connection Server and Horizon Client. Certicate
verication includes the following checks:
Is the certicate intended for a purpose other than verifying the identity of the sender and encrypting
n
server communications? That is, is it the correct type of certicate?
VMware, Inc. 27
Using VMware Horizon Client for iOS
Has the certicate expired, or is it valid only in the future? That is, is the certicate valid according to
n
the computer clock?
Does the common name on the certicate match the host name of the server that sends it? A mismatch
n
can occur if a load balancer redirects Horizon Client to a server that has a certicate that does not match
the host name entered in Horizon Client. Another reason a mismatch can occur is if you enter an IP
address rather than a host name in the client.
Is the certicate signed by an unknown or untrusted certicate authority (CA)? Self-signed certicates
n
are one type of untrusted CA.
To pass this check, the certicate's chain of trust must be rooted in the device's local certicate store.
I For information about distributing a self-signed root certicate that users can install on their
iOS devices, see the instructions on the Apple Web site. For example, for iPads, see
To set the certicate checking mode, tap at the boom of the Horizon Client screen and tap Server
Mode. You have three choices:
Never connect to untrusted servers. If any of the certicate checks fails, the client cannot connect to the
n
server. An error message lists the checks that failed.
Warn before connecting to untrusted servers. If a certicate check fails because the server uses a self-
n
signed certicate, you can click Continue to ignore the warning. For self-signed certicates, the
certicate name is not required to match the server name you entered in Horizon Client.
Do not verify server identity . This seing means that no certicate checking occurs.
n
If the certicate checking mode is set to Warn, you can still connect to a Connection Server instance that uses
a self-signed certicate.
If an administrator later installs a security certicate from a trusted certicate authority, so that all certicate
checks pass when you connect, this trusted connection is remembered for that specic server. In the future,
if that server ever presents a self-signed certicate again, the connection fails. After a particular server
presents a fully veriablecerticate, it must always do so.
Manage Saved Servers
When you connect to a View server, Horizon Client saves the server to the Servers screen. You can edit and
remove saved servers.
Horizon Client saves the server, even if you mistype the name or type the wrong IP address. You can delete
or change this information.
I You tap a server name to connect to the server.
Procedure
1Tap Servers (cloud icon) at the boom of the screen to display the saved servers.
2To manage a saved server, touch and hold the server icon until the context menu appears.
OptionAction
Change the user name, domain,
server name, or description
Remove a server
a Tap Edit Server in the context menu.
b Make your changes on the Edit Server screen.
cTap Update to save your changes.
Tap Delete Server in the context menu.
The desktop and application shortcuts associated with the server are also
deleted.
28 VMware, Inc.
Chapter 3 Managing Remote Desktop and Application Connections
OptionAction
Forget a saved password
Disable Touch ID
Tap Forget Password in the context menu. This option is available only if
you previously saved your password.
Tap Sign Out. This option is available only if you previously enabled
Touch ID.
Select a Favorite Remote Desktop or Application
You can select remote desktops and applications as favorites. Favorites are identied by a star. The star helps
you quickly nd your favorite desktops and applications. Your favorite selections are saved, even after you
log o from the server.
Prerequisites
Obtain the credentials you need to connect to the server, such as a user name and password or RSA SecurID
and passcode.
Procedure
1Tap Servers (cloud icon) at the boom of the screen and tap the server icon to connect to the server.
2If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3Perform these steps to select or deselect a desktop or application as a favorite.
OptionAction
Select a favorite
Deselect a favorite
Touch and hold the desktop or application name until the context menu
appears and tap Mark as Favorite. A star appears in the upper right corner
of the name and the name appears on the Favorites page.
Touch and hold the desktop or application name until the context menu
appears and tap Unmark Favorite. A star no longer appears in the upper
right corner of the name and the name disappears from the Favorites page.
4(Optional) Tap Favorites (star icon) at the boom of the screen to display only favorite desktops or
applications.
You can tap All (cloud icon) at the boom of the screen to display all the available desktops and
applications.
Disconnecting From a Remote Desktop or Application
You can disconnect from a remote desktop without logging o, so that applications remain open on the
remote desktop. You can also disconnect from a remote application so that the remote application remains
open.
When you are logged in to the remote desktop or application, you can disconnect by tapping the
Horizon Client Tools radial menu icon and tapping the Disconnect icon.
N A View administrator can congure your desktop to automatically log o when disconnected. In that
case, any open programs in your desktop are stopped.
VMware, Inc. 29
Using VMware Horizon Client for iOS
Log Off from a Remote Desktop
You can log o from a remote desktop operating system, even if you do not have a desktop open in
Horizon Client.
If you are currently connected to and logged in to a remote desktop, you can use the Windows Start menu
to log o. After Windows logs you o, the desktop is disconnected.
N Any unsaved les that are open on the remote desktop are closed during the logo operation.
Prerequisites
Obtain the credentials that you need to log in, such as Active Directory user name and password, RSA
n
SecurID user name and passcode, or RADIUS authentication user name and passcode.
If you have not logged in at least once, become familiar with the procedure “Connect to a Remote
n
Desktop or Application,” on page 25.
Procedure
1Tap Servers (cloud icon) at the boom of the screen and tap the server icon.
2If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3Touch and hold the desktop name until the context menu appears.
4Tap Log in the context menu.
What to do next
Tap the Logoutbuon in the upper-left corner of the screen to disconnect from the server.
Manage Desktop and Application Shortcuts
After you connect to a remote desktop or application, Horizon Client saves a shortcut for the recently used
desktop or application. You can rearrange and remove these shortcuts.
Desktop and application shortcuts can appear on multiple pages and you can swipe across pages to see
more shortcuts. Horizon Client creates new pages, as needed, to accommodate all of your shortcuts.
Procedure
Perform these steps to remove a desktop or application shortcut from the Recent screen.
n
aTouch and hold the shortcut.
bTap the Xbuon.
To move a desktop or application shortcut, touch and hold the shortcut, drag it to the new location, and
n
tap Done.
You cannot drag a shortcut to another page unless that page already exists.
30 VMware, Inc.
Chapter 3 Managing Remote Desktop and Application Connections
Using 3D Touch with Horizon Client
You can use Peek and Pop gestures to interact with Horizon Client on a 3D Touch-enabled iPhone 6s or
iPhone 6s Plus.
Using Peek and Pop with the Horizon app on Your Home Screen
You can Peek at the Horizon app on your Home screen to show a quick action menu. On the quick action
menu, you can tap the Connect to Most Recent Server item to quickly connect to the most recently used
server. If a recent server does not exist, you can tap the Connect to Most Recent Server item to add a new
server.
After you connect to a remote desktop or application, Horizon Client adds a shortcut to the desktop or
application to the quick action menu. For example, if you connect to a remote desktop named Win7,
Horizon Client adds Connect to Win7. You can tap a shortcut to quickly connect a remote desktop or
application. The Horizon icon quick action menu can contain up to three shortcuts.
Using Peek and Pop Inside Horizon Client
On the desktop and application selection screen, you can Peek at a remote desktop or application to show a
quick action menu. You can tap items in the quick action menu to connect, log o, mark a favorite, and
perform other actions, depending on the remote desktop or application. You can also Pop into a remote
desktop or application to connect to it.
Quick action menus are also available on the Servers, Recent, and Favorites screens. For example, on the
Servers screen, you can Peek at a saved server and tap items in the quick action menu to edit, remove, or
connect to the server. On the Recent screen, you can Peek at a remote desktop or application shortcut and
tap items in the quick action menu to remove the shortcut or connect to the desktop or application. You can
also Pop into a saved server or remote desktop or application shortcut to connect to it.
Enabling Peek for the Horizon Client Tools
By default, the Horizon Client Tools radial menu icon appears in the middle of the screen when you are
connected to a remote desktop or application. You tap the radial menu icon to expand the menu and display
icons for each tool, which you tap to select. For pictures of the radial menu icon and tools icons, see
Table 4-6.
If you enable Peek for the Horizon Client Tools, the Horizon Client Tools radial menu icon does not appear.
To display the icons for each tool, press deeply on any place on the screen.
To enable Peek for the Horizon Client Tools, tap at the boom of the Horizon Client screen, tap
Touch, and toggle the Peek for the menuseing to on. If you are connected to a remote desktop or
application, you can access seings by tapping the (gear) icon in the Horizon Client Tools radial
menu.
Using Spotlight Search with Horizon Client
You can use Spotlight search on iOS 9 and later devices to search for and connect to remote desktops and
applications.
When you log in to a server in Horizon Client, the remote desktops and applications on the server are added
to the Spotlight index. Only the remote desktops and applications on the last server to which you logged in
are indexed.
To use Spotlight search to search for a particular remote desktop or application, type its name or a partial
name in the Spotlight search eld. For example, to nd a remote desktop named Win 2008 RDS Desktop,
you might type Win or RDS.
VMware, Inc. 31
Using VMware Horizon Client for iOS
To use Spotlight search to nd your favorite remote desktops and applications, type favorite in the
Spotlight search eld. To search for any remote desktop or application, type vmware or horizon in the
Spotlight search eld. The search results can contain up to 10 items.
To connect to a remote desktop or application, tap its name in the search results. If you are not currently
connected to the server, the Horizon Client login screen appears and you can log in.
Using Split View and Slide Over with Horizon Client
You can use Split View and Slide Over with Horizon Client on any iPad model that supports Split View and
Slide Over and is running iOS 9 or later.
With Split View and Slide Over, you can open Horizon Client and another app at the same time. You can run
Horizon Client as either the primary app or the secondary app.
If you rotate your device or slide the vertical divider that separates the primary and secondary apps,
Horizon Client automatically adjusts to t the size of the window. If you are connected to a remote desktop,
the remote desktop automatically adjusts to t the size of the window if the Resolutionseing is set to Auto
- Fit. For information about seing the resolution for a remote desktop, see “Changing the Display
Resolution Seing,” on page 46.
N Horizon Client does not support Picture in Picture.
32 VMware, Inc.
Using a Microsoft Windows Desktop
or Application4
On iOS devices, Horizon Client includes additional features to aid in navigation.
This chapter includes the following topics:
“Feature Support Matrix for iOS,” on page 34
n
“External Keyboards and Input Devices,” on page 36
n
“Enable the Japanese 106/109 Keyboard Layout,” on page 37
n
“Using the Real-Time Audio-Video Feature for Microphones,” on page 37
n
“Using Native Operating System Gestures with Touch Redirection,” on page 37
n
“Using the Unity Touch Sidebar with a Remote Desktop,” on page 38
n
“Using the Unity Touch Sidebar with a Remote Application,” on page 40
n
“Horizon Client Tools on a Mobile Device,” on page 41
n
“Gestures,” on page 43
n
“Multitasking,” on page 44
n
“Copying and Pasting Text and Images,” on page 44
n
“Saving Documents in a Remote Application,” on page 45
n
“Congure Horizon Client to Support Reversed Mouse Buons,” on page 45
n
“Screen Resolutions and Using External Displays,” on page 46
n
“PCoIP Client-Side Image Cache,” on page 47
n
“Suppress the Cellular Data Warning Message,” on page 47
n
“Internationalization,” on page 47
n
VMware, Inc.
33
Using VMware Horizon Client for iOS
Feature Support Matrix for iOS
Some features are supported on one type of Horizon Client but not on another.
Table 4‑1. Features Supported on Windows Desktops for iOS Horizon Clients
Windows
Feature
RSA SecurID or
RADIUS
Single sign-onXXXLimitedLimitedX
RDP display protocol
PCoIP display protocolXXXLimitedLimitedX
VMware Blast display
protocol
USB access
Real-Time Audio-Video
(audio-in only)
Wyse MMR
Windows 7 MMR
Virtual printing
Location-based printing XXXLimitedLimitedX
Smart cardsXXXLimitedLimitedX
Multiple monitors
10 Desktop
XXXLimitedLimitedX
XXXX
XXXX
Windows
8.x Desktop
Windows
7 Desktop
Windows
Vista
Desktop
Windows
XP Desktop
Windows Server
2008/2012 R2 or
Windows Server
2016 Desktop
Windows 10 desktops require View Agent 6.2 or later or Horizon Agent 7.0 or later. Windows Server 2012
R2 desktops require View Agent 6.1 or later or Horizon Agent 7.0 or later. Windows Server 2016 desktops
require Horizon Agent 7.0.2 or later.
I View Agent 6.1 and later and Horizon Agent 7.0 and later releases do not support Windows XP
and Windows Vista desktops. View Agent 6.0.2 is the last View release that supports these guest operating
systems. Customers who have an extended support agreement with Microsoft for Windows XP and Vista,
and an extended support agreement with VMware for these guest operating systems, can deploy the View
Agent 6.0.2 version of their Windows XP and Vista desktops with Connection Server 6.1.
For descriptions of these features, see the View Planning document.
Feature Support for Session-Based Desktops on RDS Hosts
RDS hosts are server computers that have Windows Remote Desktop Services and View Agent or
Horizon Agent installed. Multiple users can have desktop sessions on an RDS host simultaneously. An RDS
host can be either a physical machine or a virtual machine.
N The following table contains rows only for the features that are supported. Where the text species a
minimum version of View Agent, the text "and later" is meant to include Horizon Agent 7.0.x and later.
34 VMware, Inc.
Chapter 4 Using a Microsoft Windows Desktop or Application
Table 4‑2. Features Supported for RDS Hosts with View Agent 6.0.x or Later, or Horizon Agent 7.0.x or
Later, Installed
Windows Server 2008 R2
Feature
RSA SecurID or RADIUSXXHorizon Agent 7.0.2 and later
Smart cardView Agent 6.1 and laterView Agent 6.1 and laterHorizon Agent 7.0.2 and later
Single sign-onXXHorizon Agent 7.0.2 and later
RDP display protocol (for
desktop clients)
PCoIP display protocolXXHorizon Agent 7.0.2 and later
VMware Blast display
protocol
HTML AccessView Agent 6.0.2 and later
Virtual printing (for desktop
clients)
Location-based printingView Agent 6.0.1 and later
Multiple monitors (for
desktop clients)
Unity Touch (for mobile and
Chrome OS clients)
Real-Time Audio-Video
(RTAV)
RDS Host
XXHorizon Agent 7.0.2 and later
Horizon Agent 7.0 and laterHorizon Agent 7.0 and
(virtual machine only)
View Agent 6.0.1 and later
(virtual machine only)
(virtual machine only)
XXHorizon Agent 7.0.2 and later
XXHorizon Agent 7.0.2 and later
Horizon Agent 7.0.2 and
later
Windows Server 2012
RDS Host
later
View Agent 6.0.2 and
later (virtual machine
only)
View Agent 6.0.1 and
later (virtual machine
only)
View Agent 6.0.1 and
later (virtual machine
only)
Horizon Agent 7.0.2 and
later
Windows Server 2016 RDS
Host
Horizon Agent 7.0.2 and later
Horizon Agent 7.0.2 and later
Horizon Agent 7.0.2 and later
(virtual machine only)
Horizon Agent 7.0.2 and later
(virtual machine only)
Horizon Agent 7.0.3 and later
For information about which editions of each guest operating system are supported, or which service packs,
see the "Supported Operating Systems for View Agent" topic in the View 5.x or 6.x installation
documentation. See the "Supported Operating Systems for Horizon Agent" topic in the Horizon 7
installation documentation.
Limitations for Specific Features
Specic features that are supported on Windows desktops for Horizon Client for iOS have certain
restrictions.
Table 4‑3. Requirements for Specific Features
FeatureRequirements
Left Handed ModeThis feature is iOS specic. If your remote desktop is
congured so that the primary and secondary mouse
buons are switched, use the Left Handed Mode feature.
See “Congure Horizon Client to Support Reversed Mouse
Buons,” on page 45.
Location-based printing for Windows Server 2008 R2
desktops, RDS desktops (on virtual machine RDS hosts),
and remote applications
Horizon 6.0.1 with View and later servers.
VMware, Inc. 35
Using VMware Horizon Client for iOS
Table 4‑3. Requirements for Specific Features (Continued)
FeatureRequirements
Smart cards for RDS desktopsView Agent 6.1 and later.
Real-Time Audio-Video (audio-in only)See “System Requirements for Real-Time Audio-Video,” on
N You can also use Horizon Client to securely access remote Windows-based applications, in addition
to remote desktops. Selecting an application in Horizon Client opens a window for that application on the
local client device, and the application looks and behaves as if it were locally installed.
You can use remote applications only if you are connected to Connection Server 6.0 or later. For information
about which operating systems are supported for the RDS (Remote Desktop Sessions) host, which provides
remote applications and session-based desktops, see "Supported Operating Systems for Horizon Agent"
topic in the View 5.x or 6.x installation documentation. See the "Supported Operating Systems for
Horizon Agent" topic in the Horizon 7 installation documentation.
Feature Support for Linux Desktops
Some Linux guest operating systems are supported if you have View Agent 6.1.1 or later or Horizon Agent
7.0 or later. For a list of supported Linux operating systems and information about supported features, see
Seing Up Horizon 6 for Linux Desktops, which is part of the Horizon 6 version 6.1 documentation, or see
Seing Up Horizon 7 for Linux Desktops, which is part of the Horizon 7 version 7 documentation.
page 8
External Keyboards and Input Devices
Horizon Client supports the iPad Keyboard Dock and Apple Wireless Keyboard (Bluetooth) external
keyboards. Horizon Client supports Apple Pencil as a pointer device on iPad Pro and the Swiftpoint GT
mouse on any iOS device that the Swiftpoint GT mouse supports.
Using an External Keyboard
Horizon Client automatically detects the iPad Keyboard Dock external keyboard. To use the Apple Wireless
Keyboard (Bluetooth) with a remote desktop or application, you must rst pair the keyboard with the client
device. After you pair the keyboard with the iPad, make sure that you do not have the onscreen keyboard in
split keyboard mode when you aempt to make the iPad detect the Bluetooth keyboard. To make the client
device detect the wireless keyboard, tap the screen with three ngers at the same time, or tap the Keyboardbuon in the Horizon Client Tools.
Also with the Apple Wireless Keyboard (Bluetooth), after the external keyboard is detected, you cannot use
the Horizon Client Tools or three-nger tap to display the onscreen keyboard. You must rst deactivate the
external keyboard by pressing its Eject key.
N The Apple Wireless Keyboard (Bluetooth) does not input the Japanese full-width tilde correctly in
remote desktops.
Using the Swiftpoint GT Mouse
Horizon Client automatically detects the SwiftPoint GT mouse. To use the Swiftpoint GT mouse with a
remote desktop or application, you must rst pair the mouse with the client device. After you pair the
mouse with the device, mouse actions are redirected to remote desktops and applications that you open
with Horizon Client.
36 VMware, Inc.
Chapter 4 Using a Microsoft Windows Desktop or Application
International Keyboards
You can input characters for English, Japanese, French, German, Simplied Chinese, Traditional Chinese,
Korean, and Spanish.
Use an English keyboard on your iOS device with a remote desktop that uses a Korean or Japanese input
method editor (IME). If you use a Korean or Japanese keyboard on your iOS device and you connect to a
remote desktop that uses a Korean or Japanese IME, the remote desktop Windows IME English/Korean or
English/Japanese mode is not synchronized with the iOS keyboard locale.
Enable the Japanese 106/109 Keyboard Layout
If you are connected to a Windows XP desktop, you can congure Horizon Client to use the Japanese
106/109 keyboard layout.
Prerequisites
Use Horizon Client to connect to a Windows XP desktop that has the Japanese keyboard layout enabled.
Procedure
1Use the Horizon Client Tools to display the Options dialog box.
2Tap to toggle the Japanese 106/109 Keyboard option to on.
This seing is disabled if the keyboard layout on the Windows XP desktop is not set to Japanese. This
seing is hidden if the desktop is not running Windows XP.
3Tap Done.
Using the Real-Time Audio-Video Feature for Microphones
With the Real-Time Audio-Video feature, you can use a microphone connected to your mobile device on
your remote desktop. Real-Time Audio-Video is compatible with standard audio devices and with standard
conferencing applications such as Skype, WebEx, and Google Hangouts.
Real-Time Audio-Video is enabled by default when you install Horizon Client on your device.
N Only the audio-in feature is supported. The video feature is not supported.
For information about seing up the Real-Time Audio-Video feature on a remote desktop, see the Seing UpDesktop and Application Pools in View document.
The rst time you use the microphone, Horizon Client prompts you for permission to access it. You must
grant permission for the microphone to work with your remote desktop. You can enable and disable access
to the microphone by changing the Microphone permission for Horizon Client in the iOS Seings app.
Using Native Operating System Gestures with Touch Redirection
You can use native operating system gestures from your touch-based mobile device when you are connected
to a Windows 8, Windows 10, or Windows Server 2012 remote desktop, or to a remote application that is
hosted on Windows Server 2012. For example, you can touch, hold, and release an item on a Windows 8
desktop to display the item's context menu.
When touch redirection is enabled, you can use only native operating system touch gestures. Horizon Client
local gestures, such as double-click and pinch, no longer work. You must drag the Unity Touch tab buon to
display the Unity Touch sidebar.
Touch redirection is enabled by default when you connect to a Windows 8, Windows 10, or Windows Server
2012 remote desktop, or to a remote application that is hosted on Windows Server 2012.
VMware, Inc. 37
Using VMware Horizon Client for iOS
To disable touch redirection, tap at the boom of the Horizon Client screen, tap Touch, and toggle
the Windows Native Touch Gestures seing to o. If you are connected to a remote desktop or application,
you can access seings by tapping the (gear) icon in the Horizon Client Tools radial menu.
Using the Unity Touch Sidebar with a Remote Desktop
You can quickly navigate to a remote desktop application or le from a Unity Touch sidebar. From this
sidebar, you can open les and applications, switch between running applications, and minimize, maximize,
restore, or close windows and applications in a remote desktop.
If the Unity Touch feature is enabled, the sidebar appears on the left side of the screen when you rst access
a remote desktop.
Figure 4‑1. Unity Touch Sidebar
If you access a desktop that has Unity Touch enabled but the sidebar is not displayed, you can see a tab on
the left side of the screen. Besides swiping this tab to the right to open the sidebar, you can slide the tab up
or down.
From this sidebar, you can perform many actions on a le or application.
Table 4‑4. Unity Touch Sidebar Actions for a Remote Desktop
ActionProcedure
Show the sidebarSwipe the tab to the right. When the sidebar is open, you cannot perform actions on the
desktop screen or the Horizon Client Tools radial menu.
Hide the sidebarSwipe the tab to the left to close the sidebar. When the sidebar is open, you cannot
perform actions on the desktop screen or the Horizon Client Tools radial menu.
You can also touch the desktop screen, including the Horizon Client Tools radial menu,
to hide the sidebar.
38 VMware, Inc.
Chapter 4 Using a Microsoft Windows Desktop or Application
Table 4‑4. Unity Touch Sidebar Actions for a Remote Desktop (Continued)
ActionProcedure
Navigate to an applicationTap All Programs and navigate to the application just as you would from the Windows
Start menu.
Navigate to a le
Search for an application or le
Open an application or leTap the name of the le or application in the sidebar. The application starts and the
Switch between running
applications or open windows
Minimize a running application
or window
Maximize a running
application or window
Close a running application or
window
Restore a running application
or window to its previous size
and position
Create a list of favorite
applications or les
Tap My Files to access the User folder, and navigate to the le.My Files includes
folders such as My Pictures, My Documents, and Downloads.
My Files includes the folders in the user prole (%USERPROFILE% directory). If you
relocate the system folder in the %USERPROFILE% directory, the My Files menu can
also display content from the relocated folder, whether it is a local relocated folder or a
network share folder.
Tap in the Search box and type the name of the application or le.
n
To use voice dictation, tap the microphone on the keyboard.
n
To launch an application or le, tap the name of the application or le in the search
n
results.
To return to the home view of the sidebar, tap the X to close the Search box.
n
sidebar closes.
Tap the application name under Running Applications. If more than one le is open
for one application, tap the chevron (>) next to the application to expand the list.
1 Touch the application name under Running Applications and swipe from right to
left.
2 Tap the Morebuon that appears.
3 Tap Minimize.
1 Touch the application name under Running Applications and swipe from right to
left.
2 Tap the Morebuon that appears.
3 Tap Maximize.
Touch the application name under Running Applications and swipe from right to left.
Tap the Closebuon that appears.
1 Touch the application name under Running Applications and swipe from right to
left.
2 Tap the Morebuon that appears.
3 Tap Restore.
1 Search for the application or le, or tap Manage under the Favorite Applications
or Favorite Documents list.
If the Manage bar is not visible, tap the chevron (>) next to Favorite Applications
or Favorite Files.
2 Tap the check box next to the names of your favorites in the search results or in the
list of available applications or les.
The favorite that you add last appears at the top of your favorites list.
Your favorites are remembered across all of your mobile devices so that, for example,
you have the same list whether using your smart phone or your tablet.
VMware, Inc. 39
Using VMware Horizon Client for iOS
Table 4‑4. Unity Touch Sidebar Actions for a Remote Desktop (Continued)
ActionProcedure
Remove an application or le
from the favorites list
Reorder an application or le in
the favorites list
N To use the Unity Touch feature with View 5.3.x desktops, the Remote Experience Agent must be
installed on the desktops. If you have the Remote Experience Agent installed but want to turn o this
feature, you can set a registry value on the remote desktop.
If users have a oating desktop, users’ favorite applications and les can be saved only if Windows roaming
user proles are congured for the desktop. Administrators can create a default Favorite Applications list
that end users see the rst time the sidebar appears.
1 Search for the application or le, or tap Manage under the Favorite Applications
or Favorite Dcuments list.
If the Manage bar is not visible, tap the chevron (>) next to Favorite Applications
or Favorite Documents.
2 Tap to remove the check mark next to the name of the application or le in the
favorites list.
1 Tap Manage under the Favorite Applications or Favorite Documents list.
If the Manage bar is not visible, tap the chevron (>) next to Favorite Applications
or Favorite Documents.
2 In the favorites list, touch and hold the handle on the left side of the application or
le name and drag the favorite up or down the list.
For Connection Server 5.3.x servers, see the View Feature Pack Installation and Administration document. For
Connection Server 6.0 and later servers, see the Seing Up Desktop and Application Pools in View document.
Using the Unity Touch Sidebar with a Remote Application
You can quickly navigate to a remote application from a Unity Touch sidebar. From this sidebar, you can
launch applications, switch between running applications, and minimize, maximize, restore, or close remote
applications. You can also switch to a remote desktop.
When you access a remote application, the Unity Touch sidebar appears on the left side of the screen. If the
Unity Touch sidebar is closed, a tab appears on the left side of the screen. You can swipe this tab to the right
to reopen the sidebar. You can also slide the tab up or down.
N You can use remote applications only if you are connected to Connection Server 6.0 or later.
Figure 4‑2. Unity Touch Sidebar for a Remote Application
40 VMware, Inc.
Chapter 4 Using a Microsoft Windows Desktop or Application
From the Unity Touch sidebar, you can perform many actions on a remote application.
Table 4‑5. Unity Touch Sidebar Actions for a Remote Application
ActionProcedure
Show the sidebarSwipe the tab to the right to open the sidebar. When the sidebar is open, you cannot
perform actions on the application screen.
Hide the sidebarSwipe the tab to the left to close the sidebar. When the sidebar is open, you cannot
perform actions on the application screen.
In Horizon Client 3.1 and later, you can also touch the application screen, including
the Horizon Client Tools radial menu, to hide the sidebar.
Switch between running
applications
Open an applicationTap the name of the application under Available Applications in the sidebar. The
Close a running application1 Touch the application name under Current Connection and swipe from right to
Minimize a running application1 Touch the application name under Current Connection and swipe from right to
Maximize a running application1 Touch the application name under Current Connection and swipe from right to
Restore a running application1 Touch the application name under Current Connection and swipe from right to
Switch to a remote desktopTap the desktop name under Desktops.
Tap the application under Current Connection.
application starts and the sidebar closes.
left.
2 Tap the Closebuon that appears.
left.
2 Tap the Morebuon that appears.
3 Tap Minimize.
left.
2 Tap the Morebuon that appears.
3 Tap Maximize.
left.
2 Tap the Morebuon that appears.
3 Tap Restore.
Horizon Client Tools on a Mobile Device
On a mobile device, the Horizon Client Tools include buons for displaying the onscreen keyboard, virtual
touchpad, congurationseings, and a virtual keypad for arrow keys and function keys.
The Horizon Client radial menu icon appears in the middle of the screen when you are connected to a
remote desktop or application. Tap to expand the radial menu and display icons for each tool, which you
can tap to select. Tap outside the tool icons to collapse the icons back into the radial menu icon.
The radial menu includes several tools.
Table 4‑6. Radial Menu Icons
IconDescription
Horizon Client Tools radial menu
Disconnect
Onscreen keyboard (toggles to show or hide)
VMware, Inc. 41
Using VMware Horizon Client for iOS
Table 4‑6. Radial Menu Icons (Continued)
IconDescription
Onscreen Keyboard
The onscreen keyboard has more keys than the standard onscreen keyboard, for example, Control keys and
function keys are available. To display the onscreen keyboard, tap the screen with three ngers at the same
time or tap the Keyboard icon.
Seings
Navigation keys
Virtual touchpad
Gesture help
You can also use the feature that displays the onscreen keyboard whenever you tap a text eld, such as in a
note or new contact. If you then tap in an area that is not a text eld, the keyboard is dismissed.
I To use the three-nger tap, make sure the iOS accessibility feature for zooming is turned o.
When the zoom accessibility feature is turned on, you zoom by double-tapping with three ngers, and
tapping once with three ngers does nothing.
Even if you use an external keyboard, a one-row onscreen keyboard might still appear, which contains
function keys, and the Ctrl, Alt, Win, and arrow keys. Some external keyboards do not have all these keys.
Sending a String of Characters
From the onscreen keyboard, tap the pen icon on the left side of the Ctrl key to display the local input buer.
Text that you type into this text box is not sent to an application until you tap Send. For example, if you
open an application such as Notepad and tap the pen icon, the text that you type does not appear in the
Notepad application until you tap Send.
Use this feature if you have a poor network connection. That is, use this feature if, when you type a
character, the character does not immediately appear in the application. With this feature, you can quickly
type up to 1,000 characters and then either tap Send or tap Return to have all 1,000 characters appear at
once in the application.
Navigation Keys
Tap the Ctrl/Page icon in the Horizon Client Tools or onscreen keyboard to display the navigation keys.
These keys include Page Up, Page Down, arrow keys, function keys, and other keys that you often use in
Windows environments, such as Alt, Del, Shift, Ctrl, Win, and Esc. You can press and hold arrow keys for
continuous key strokes. For a picture of the Ctrl/Page icon, see the table at the beginning of this topic.
Use the Shift key on this keypad when you need to use key combinations that include the Shift key, such as
Ctrl+Shift. To tap a combination of these keys, such as Ctrl+Alt+Shift, rst tap the onscreen Ctrl key. After
the Ctrl key turns blue, tap the onscreen Alt key. After the Alt key turns blue, tap the onscreen Shift key. A
single onscreen key is provided for the key combination Ctrl+Alt+Del.
42 VMware, Inc.
Chapter 4 Using a Microsoft Windows Desktop or Application
Onscreen Touchpad and Full Screen Touchpad
The virtual touchpad can be either regular-size, to resemble a touchpad on a laptop computer, or full screen,
so that the entire device screen is a touchpad.
By default, when you tap the touchpad icon, you can touch anywhere on the screen to move the mouse
pointer. The screen becomes a full-screen touchpad.
Moving your nger around the touchpad creates a mouse pointer that moves around the remote
n
desktop or application.
You can use the regular-size and full screen virtual touchpad for single-clicking and double-clicking.
n
The regular touchpad also contains left-click and right-click buons.
n
To simulate holding down the left-click buon while dragging, double-tap with one nger and then
n
drag.
To enable this feature, use the Horizon Client Tools to display the Options dialog box, and click to
toggle the Touchpad Tap & Drag option to on.
You can tap with two ngers and then drag to scroll vertically.
n
You can drag the regular-size virtual touchpad to the side of the device so that you can use your thumb to
operate the touchpad while you are holding the device.
You can make the virtual touchpad resemble the touchpad on a laptop, including right-click and left-click
buons. Tap to expand the Horizon Client Tools radial menu icon, tap the (gear) icon, tap Touch,
and toggle the Full Screen Touchpad Mode seing to o.
To adjust how quickly the pointer moves when you use the touchpad, tap to expand the Horizon Client
Tools radial menu icon, tap the (gear) icon, tap Touch, and drag the slider in the TouchpadSensitivity option.
You can also set the Full Screen Touchpad Mode and Touchpad Sensitivity seings from the
Horizon Client Seings screen. Tap at the boom of the Horizon Client screen and tap Touch to
display the touchpad seings.
Gestures
VMware has created user interaction aids to help you navigate conventional Windows user interface
elements on a non-Windows device.
Clicking
As in other applications, you tap to click a user interface element.
In a remote desktop, if you tap and hold for a second, a magnifying glass appears, along with a mouse
pointer, for precise placement. This feature is especially helpful when you want to resize a window.
N If your remote desktop is congured for a left-handed user, see “Congure Horizon Client to
Support Reversed Mouse Buons,” on page 45.
Right-Clicking
The following options are available for right-clicking:
Use the Horizon Client Tools to display the regular virtual touchpad and use the touchpad's right-click
n
buon.
On a touch screen, tap with two ngers at nearly the same time. The right-click occurs where the rst
n
nger tapped.
VMware, Inc. 43
Using VMware Horizon Client for iOS
Scrolling and Scrollbars
The following options are available for vertical scrolling.
On a touch screen, tap with one or two ngers and then drag to scroll. The text under your ngers
n
moves in the same direction as your ngers.
I Scrolling with one nger has the following limitations: It does not work if you have
zoomed in, or when the onscreen keyboard is displayed, or when you are using the full screen
touchpad.
Use the Horizon Client Tools to display the touchpad, tap the touchpad with two ngers, and then drag
n
to scroll.
Use the onscreen touchpad to move the mouse pointer and click scroll bars.
n
Zooming In and Out
As in other applications, pinch your ngers together or apart to zoom on a touch screen.
Window Resizing
If you use the full screen touchpad to resize a window, touch and hold one nger at the corner or side of the
window and drag to resize, or double-tap with one nger and then drag.
If you use the regular-size virtual touchpad, to simulate holding down the left-click buon while dragging
the corner or side of a window, double-tap with one nger and then drag.
If you are not using either type of virtual touchpad, tap and hold until the magnifying glass appears at the
corner or side of the window. Move your nger around until the resizing arrows appear. Lift your ngero
the screen. The magnifying glass is replaced by a resizing circle. Tap this resizing circle and drag it to resize
the window.
Sound, Music, and Video
If sound is turned on for your device, you can play audio in a remote desktop.
Multitasking
You can switch between Horizon Client and other apps without losing a remote desktop or application
connection.
In a WiFi network, by default Horizon Client runs in the background for up to three minutes on iOS 7.0 and
later devices. In a 3G network, Horizon Client suspends data transmission when you switch to another app.
Data transmission resumes when you switch back to Horizon Client.
Copying and Pasting Text and Images
By default, you can copy and paste text from your iOS device to a remote desktop or application. If a View
administrator enables the feature, you can also copy and paste text from a remote desktop or application to
your iOS device or between two remote desktops or applications. Supported le formats include plain text,
images, and Rich Text Format (RTF). Some restrictions apply.
A View administrator can set this feature so that copy and paste operations are allowed only from your iOS
device to a remote desktop or application, or only from a remote desktop or application to your iOS device,
or both, or neither.
44 VMware, Inc.
Chapter 4 Using a Microsoft Windows Desktop or Application
Data that you copy to the clipboard is automatically copied to your remote desktop's clipboard when you
log in to the remote desktop. If you are logged in to a remote desktop, data that you copy to the remote
desktop's clipboard is automatically copied to your iOS device's clipboard. If RTF data contains images, the
images are lost when Horizon Client synchronizes the RTF data in the remote desktop's clipboard with the
data in your iOS device's clipboard.
View administrators congure the ability to copy and paste by conguring group policy seings that pertain
to Horizon Agent. Depending on the Horizon server and agent version, administrators might also be able to
use group policies to restrict clipboard formats during copy and paste operations or use Smart Policies to
control copy and paste behavior in remote desktops. For information, see the Seing Up Desktop andApplication Pools in View document.
The clipboard can accommodate a maximum of 1 MB of data for copy and paste operations. If the text and
RTF data together use less than maximum clipboard size, the formaed text is pasted. Often the RTF data
cannot be truncated, so that if the text and formaing use more than the maximum clipboard size amount,
the RTF data is discarded, and plain text is pasted. If you are unable to paste all of the formaed text you
selected in one operation, you might need to copy and paste smaller amounts in each operation.
Saving Documents in a Remote Application
With certain remote applications, such as Microsoft Word or WordPad, you can create and save documents.
Where these documents are saved depends on your company's network environment. For example, your
documents might be saved to a home share mounted on your local computer.
Administrators can use an ADMX template le to set a group policy that species where documents are
saved. This policy is called "Set Remote Desktop Services User Home Directory." For more information, see
the "RDS ProlesSeings" topic in the Seing Up Desktop and Application Pools in View document.
Configure Horizon Client to Support Reversed Mouse Buttons
You can use the Left Handed Mode option if the primary and secondary mouse buons are switched in
your remote desktop.
If you set the mouse properties inside your remote desktop so that the primary mouse buon is the one on
the right side, as many left-handed people do, you must turn on the Left Handed Mode option in
Horizon Client. If you do not turn on this option when mouse buons are reversed, a single tap acts as a
click of the secondary mouse buon. For example, a single tap might display a context menu rather than
selecting something or inserting a cursor.
Procedure
If you are already connected to the remote desktop, perform these steps.
n
aTap to expand the Horizon Client Tools radial menu icon and tap the (gear) icon to open
the Seings screen.
bTap Touch on the Seings screen.
cTap Left Handed Mode to toggle the option to on.
dTap Done to close the Seings screen.
If you are not connected to the remote desktop, perform these steps.
n
aTap at the boom of the Horizon Client screen.
bTap Touch on the Seings screen.
cTap Left Handed Mode to toggle the option to on.
A single tap now acts as a click with the primary mouse buon.
VMware, Inc. 45
Using VMware Horizon Client for iOS
Screen Resolutions and Using External Displays
You can use Horizon Client with external displays and you can change screen resolutions.
When you connect your device to an external display or projector, Horizon Client supports certain
maximum display resolutions. You can change the screen resolution used on your device to allow scrolling a
larger screen resolution.
Enlarging the Screen Resolution for a Remote Desktop
By default, the display resolution is set so that the entire Windows desktop ts inside your device, and the
desktop icons and task bar icons are a certain size. If you change the default to a higher resolution, the
desktop still ts inside the device, but the desktop and taskbar icons become smaller.
You can pinch your ngers apart to zoom in and make the desktop larger than the device screen. You can
then tap and drag to access the edges of the desktop.
Changing the Display Resolution Setting
To change the resolution from a remote desktop or application, tap to expand the Horizon Client Tools
radial menu icon, tap the (gear) icon, and tap Resolution. You can also change the resolution from
the Horizon Client Seings screen. Tap at the boom of the Horizon Client screen and tap
Resolution.
N Certain options, including 3/4 Scaling and No Scaling, are not available on iPhone 6 when the device
is in zoomed mode. To display these options, you must exit zoomed mode.
Using Projectors
You can use the Resolutionseing to set a larger resolution for projectors.
To display the keyboard and an expanded onscreen touchpad on the device while displaying the remote
desktop on the projector or aached monitor, enable the Presentation Modeseing. The expanded
touchpad and keyboard appear when you plug the device into the external monitor. The device detects the
maximum resolution provided by the external display.
You can mirror the entire device display on a projector or aached monitor, including the Unity Touch
sidebar, by turning o the Presentation modeseing. If you are connected to a remote desktop and the
Presentation Modeseing is enabled, you can click Done to switch to mirror mode.
You can use the Keep the screen alive during Presentationseing to keep the display from turning o after
a period of inactivity while in presentation mode.
You can congure these seing from a remote desktop or application by tapping to expand the
Horizon Client Tools radial menu icon and tapping the (gear) icon. You can also congure these
seing by tapping the (gear) icon at the boom of the Horizon Client screen.
Hiding Sensitive Information on External Displays
When you use Horizon Client with an external display or projector, sensitive information, such as
passwords and passcodes, is automatically hidden to protect user data security.
46 VMware, Inc.
PCoIP Client-Side Image Cache
PCoIP client-side image caching stores image content on the client to avoid retransmission. This feature
reduces bandwidth usage.
The PCoIP image cache captures spatial, as well as temporal, redundancy. For example, when you scroll
down through a PDF document, new content appears from the boom of the window and the oldest content
disappears from the top of the window. All the other content remains constant and moves upward. The
PCoIP image cache is capable of detecting this spatial and temporal redundancy.
Because during scrolling, the display information sent to the client device is primarily a sequence of cache
indices, using the image cache saves a signicant amount of bandwidth. This ecient scrolling has benets
both on the LAN and over the WAN.
On the LAN, where bandwidth is relatively unconstrained, using client-side image caching delivers
n
signicant bandwidth savings.
Over the WAN, to stay within the available bandwidth constraints, scrolling performance would be
n
degraded without client-side caching. Over the WAN, client-side caching saves bandwidth and ensure a
smooth, highly responsive scrolling experience.
With client-side caching, the client stores portions of the display that were previously transmied. The cache
size is one-half of the available RAM. If that amount of RAM is less than 50 MB, the cache size is 50 MB.
Chapter 4 Using a Microsoft Windows Desktop or Application
Suppress the Cellular Data Warning Message
When Horizon Client detects that you are using a cellular data connection, the Network Usage dialog box
appears to notify you that your remote desktop or application connection might use a substantial portion of
your data plan.
The Network Usage dialog box appears after you connect to a server and try to launch a remote desktop or
application, after you tap a recent desktop or application shortcut, and after you connect to a remote
application and try to launch another application or remote desktop from the Unity Touch sidebar. The
Network Usage dialog box appears only when you launch Horizon Client.
You can suppress the Network Usage dialog box after it appears. You can also set an option to always
suppress the Network Usage dialog box.
Procedure
To suppress the Network Usage dialog box after it appears in Horizon Client, tap Never Remind in the
n
Network Usage dialog box.
To set an option to always suppress the Network Usage dialog box, tap at the boom of the
n
Horizon Client screen and toggle the Cellular Data Warning option to o.
Internationalization
Both the user interface and the documentation are available in English, Japanese, French, German,
Simplied Chinese, Traditional Chinese, Korean, and Spanish. You can also input characters for these
languages.
VMware, Inc. 47
Using VMware Horizon Client for iOS
48 VMware, Inc.
Troubleshooting Horizon Client5
You can solve most Horizon Client problems by reseing the desktop or reinstalling the app.
You can also enable log collection and send log les to VMware for troubleshooting.
This chapter includes the following topics:
“Collecting and Sending Logging Information,” on page 49
n
“Reset a Remote Desktop or Application,” on page 51
n
“Uninstall Horizon Client,” on page 52
n
“Horizon Client Stops Responding or the Remote Desktop Freezes,” on page 52
n
“Problem Establishing a Connection When Using a Proxy,” on page 52
n
Collecting and Sending Logging Information
You can congure Horizon Client to collect log information and send log les to VMware for
troubleshooting.
If Horizon Client quits unexpectedly while log collection is enabled, Horizon Client prompts you to send log
les to VMware when you relaunch Horizon Client.
If you choose to send log les to VMware, Horizon Client sends a message from the email account
congured on your device and aaches a GZ le that contains the last ve log les. The le name contains a
time stamp, for example, Horizon_View_Client_logs_timestamp.log.gz.
You can also manually retrieve and send log les at any time.
Enable Horizon Client Log Collection
When you enable log collection, Horizon Client creates log les that contain information that can help
VMware troubleshoot problems with Horizon Client.
Because log collection aects the performance of Horizon Client, enable log collection only if you are
experiencing a problem.
Prerequisites
Verify that an email account is congured on your device. Horizon Client uses this email account to send log
les.
VMware, Inc.
49
Using VMware Horizon Client for iOS
Procedure
1If you are already connected to a remote desktop or application, perform these steps:
aTap to expand the Horizon Client Tools radial menu icon and tap the (gear) icon to open
the Seings screen.
bTap Log Collection on the Seings screen.
cTap to toggle the Logging option to on.
dTap Done to close the Seings screen.
2If you are not connected to a remote desktop or application, perform these steps:
aTap at the boom of the Horizon Client screen to open the Seings screen.
bTap Log Collection on the Seings screen.
cTap to toggle the Logging option to on.
After log collection is enabled, Horizon Client generates several log les. When Horizon Client quits
unexpectedly or is exited and relaunched, the log les are merged and compressed into a single GZ le. If
you choose to send the log, Horizon Client aaches the GZ le to an email message.
If you switch from a running desktop to seings, enable log collection, and switch back to the desktop, you
must reconnect to the desktop to collect a complete log le.
Manually Retrieve and Send Horizon Client Log Files
When Horizon Client log collection is enabled on your device, you can manually retrieve and send log les
at any time.
This procedure shows you how to retrieve and send log les through Horizon Client. If your device is
connected to a PC or Mac, you can also use iTunes to retrieve log les.
Prerequisites
Verify that an email account is congured on your device. Horizon Client sends log les from this email
n
account.
Enable Horizon Client log collection. See “Enable Horizon Client Log Collection,” on page 49.
n
Procedure
1In Horizon Client, tap the email icon at the top of the screen.
2Type the address of the email recipient in the To: line and click Send to send the message.
The email account congured on your device appears in the From: line.
The existing GZ log le is aached to the message. Horizon Client saves a maximum of ve GZ log les.
It deletes the oldest les when the GZ log le count is greater then ve.
50 VMware, Inc.
Chapter 5 Troubleshooting Horizon Client
Disable Horizon Client Log Collection
Because log collection aects the performance of Horizon Client, disable log collection if you are not
troubleshooting a problem.
Procedure
1If you are already connected to a remote desktop or application, perform these steps.
aTap to expand the Horizon Client Tools radial menu icon and tap the (gear) icon to open
the Seings screen.
bTap Log Collection on the Seings screen.
cTap to toggle the Logging option to o.
dTap Done to close the Seings screen.
2If you are not connected to a remote desktop or application, perform these steps.
aTap at the boom of the Horizon Client screen to open the Seings screen.
bTap Log Collection on the Seings screen.
cTap to toggle the Logging option to o.
Reset a Remote Desktop or Application
Reseing a remote desktop shuts down and restarts the desktop. Reseing a remote application quits the
application. You might need to reset a desktop or application if the desktop operating system or application
stops responding.
Reseing a remote desktop is the equivalent of pressing the Resetbuon on a physical PC to force the PC to
restart. Any les that are open on the remote desktop will be closed without being saved rst.
Reseing a remote application quits all remote applications and logs o all of your remote application
sessions. Unsaved changes in remote applications might be lost.
N A View administrator can disable the reset feature for certain types of desktops. For more
information, see the View Administration document.
Prerequisites
Obtain credentials to log in, such as an Active Directory user name and password, RSA SecurID user
n
name and passcode, or RADIUS authentication user name and passcode.
If you have not logged in at least once, become familiar with the procedure “Connect to a Remote
n
Desktop or Application,” on page 25.
Procedure
1Tap Servers (cloud icon) at the boom of the screen and tap the server icon to connect to the server.
2If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3Touch and hold the desktop or application name until the context menu appears.
4Tap Reset in the context menu.
Reset is available only if the status of the desktop or application is such that the action can be taken.
VMware, Inc. 51
Using VMware Horizon Client for iOS
Uninstall Horizon Client
You can sometimes resolve problems with Horizon Client by uninstalling and reinstalling Horizon Client.
Procedure
1If you have Horizon Client in iTunes on your Mac or PC, browse or search the Apps Library for the
Horizon Client app and remove it.
Use the same procedure that you would use to remove any iTunes app.
2Connect your device to your computer and allow the device to synchronize with iTunes on your Mac or
PC.
3If the Horizon Client app is not removed from your device, touch and hold the Horizon app icon until
it wiggles and tap the X icon to delete the app.
What to do next
Reinstall Horizon Client.
See “Install or Upgrade Horizon Client on an iOS Device,” on page 12.
Horizon Client Stops Responding or the Remote Desktop Freezes
When the screen freezes, rst, try reseing the remote desktop operating system.
Problem
Horizon Client does not work or repeatedly exits unexpectedly or the remote desktop freezes.
Cause
Assuming that View servers are congured properly and that rewalls surrounding them have the correct
ports open, other issues usually relate to Horizon Client on the device or to the guest operating system on
the remote desktop.
Solution
If the operating system in the remote desktop freezes, use Horizon Client on the device to reset the
n
desktop.
This option is available only if the View administrator has enabled this feature.
Uninstall and reinstall the app on the device.
n
If reseing the remote desktop and reinstalling Horizon Client do not help, you can reset the iOS
n
device, as described in the device user guide from Apple.
If you get a connection error when you aempt to connect to the server, you might need to change your
n
proxy seings.
Problem Establishing a Connection When Using a Proxy
Sometimes if you aempt to connect to Connection Server using a proxy while on the LAN, an error occurs.
Problem
If the View environment is set up to use a secure connection from the remote desktop to Connection Server,
and if the client device is congured to use an HTTP proxy, you might not be able to connect.
52 VMware, Inc.
Chapter 5 Troubleshooting Horizon Client
Cause
Unlike Windows Internet Explorer, the client device does not have an Internet option to bypass the proxy
for local addresses. When an HTTP proxy is used for browsing external addresses, and you try to connect to
Connection Server using an internal address, you might see the error message Could not establish
connection.
Solution
Remove the proxy seings so that the device no longer uses a proxy.
u
VMware, Inc. 53
Using VMware Horizon Client for iOS
54 VMware, Inc.
Index
Numerics
3D Touch 31
A
agent, installation requirements 11
AirWatch integration 15
App Store 12
B
background multitasking 44
C
caching, client-side image 47
cellular data warning message 47
certificates, ignoring problems 27
client image cache 47
Connection Server 11
connection problems 52
copying and pasting 44
customer experience program, desktop pool
data 16
D
default view 15
disconnecting from a remote desktop 29
display requirements 46
displays, external 46
E
external displays 46
Horizon Client for iOS
installing 12
uninstalling 52
I
image cache, client 47
input devices for the iPad 36
iOS, installing Horizon Client on 7
iOS Horizon Client
installing 12
uninstalling 52
iTunes Store 52
J
Japanese keyboard layout 37
K
keyboard
navigation keys 41
onscreen 41, 43
keyboard support 36
keys, navigation 41
L
Left Handed mode 45
log collection 50, 51
log off 30
logging 49
logging in
to a desktop 25
to a server 25
F
favorites 29
favorites list in Unity Touch sidebar 38
feature support matrix 34
H
hardware requirements
iOS devices 7
smart card authentication 8
Horizon Client
disconnect from a desktop 29
logging in 25
setup for iOS clients 7
system requirements for iPad and iPhone 7
troubleshooting 52
VMware, Inc. 55
M
Mac iOS, installing Horizon Client on 7
manage desktop shortcuts 30
managing desktops 25
mouse buttons, reversed 45
multitasking 44
N
navigation keys 41
O
operating systems, supported on the agent 11
options, configuration 41