VMware Horizon Client 4.3 User Guide

Using VMware Horizon Client for iOS
Horizon Client 4.3
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:
hp://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:
docfeedback@vmware.com
Copyright © 2010–2016 VMware, Inc. All rights reserved. Copyright and trademark information.
VMware, Inc.
3401 Hillview Ave. Palo Alto, CA 94304 www.vmware.com

Contents

Using VMware Horizon Client for iOS 5
Setup and Installation 7
1
System Requirements 7
System Requirements for Real-Time Audio-Video 8
Smart Card Authentication Requirements 8
Congure 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
Congure Advanced TLS/SSL Options 14
Congure VMware Blast Options 14
Congure the Horizon Client Default View 15
Congure AirWatch to Deliver Horizon Client to iOS Devices 15
Horizon Client Data Collected by VMware 16
Using URIs to Congure Horizon Client 19
2
Syntax for Creating vmware-view URIs 19
Examples of vmware-view URIs 21
Managing Remote Desktop and Application Connections 25
3
Connect to a Remote Desktop or Application 25
Seing the Certicate 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 Application 33
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
Congure Horizon Client to Support Reversed Mouse Buons 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 Client 49
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
Index 55
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 wrien for experienced system administrators who are familiar with virtual machine technology and datacenter operations.
Using VMware Horizon Client for iOS

Setup and Installation 1

Seing up a View deployment for iOS clients involves using certain Connection Server conguration seings, 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
“Congure 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
“Congure Advanced TLS/SSL Options,” on page 14
n
“Congure VMware Blast Options,” on page 14
n
“Congure the Horizon Client Default View,” on page 15
n
“Congure 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.
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-specic application drivers
n
You must also install product-specic 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
certicate.
In addition to meeting these requirements for Horizon Client systems, other View components must meet certain conguration requirements to support smart cards:
For information about conguring Connection Server to support smart card use, see "Seing Up Smart
n
Card Authentication" in the View Administration document.
You must add all applicable Certicate Authority (CA) certicates for all trusted user certicates to a server truststore le on the Connection Server host or security server host. These certicates include root certicates and must include intermediate certicates if the user's smart card certicate was issued by an intermediate certicate authority.
For information about tasks you might need to perform in Active Directory to implement smart card
n
authentication, see "Seing 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 certicate to authenticate to multiple user accounts. Users enter their user name in the Username hint eld during smart card sign-in.
To make the Username hint eld 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 "Seing 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 congure 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 Conguring Access Point document.
N Horizon Client still supports single-account smart card certicates when the smart card user name hints feature is enabled.

Configure Smart Card Authentication

Conguration tasks include connecting and pairing the card reader with the device and seing 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
Congure View servers to support smart card use. See the topic "Congure Smart Card
n
Authentication," in the View Administration document.
Procedure
1 Pair 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.
2 Congure the smart card removal policy.
Option Description
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.
a In View Administrator, select View  > Servers.
b On the Connection Servers tab, select the Connection Server instance
and click Edit.
c On the Authentication tab, select or deselect the Disconnect user
sessions on smart card removal check box to congure the smart card removal policy.
d Click OK to save your changes.
e Restart the Connection Server service to make your changes take eect.
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 seings: 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 conguration 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 seing.
n
Horizon 6 version 6.2 or a later release.
n
Enable biometric authentication in Connection Server. For information,
n
see "Congure Biometric Authentication" in the View Administration document.
Chapter 1 Setup and Installation
The Connection Server instance must present a valid root-signed
n
certicate to Horizon Client.
Horizon Client requirements
Set the certicate checking mode to Never connect to untrusted servers
n
or Warn before connecting to untrusted servers. For information about seing the certicate checking mode, see “Seing the Certicate
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, conguring Linux virtual machines for use in Horizon 6 or Horizon 7, and a list of supported features, see Seing Up Horizon 6 for Linux
Desktops, which is part of the Horizon 6, version 6.1 documentation, or see Seing Up Horizon 7 for Linux Desktops.

Preparing Connection Server for Horizon Client

Administrators must perform specic 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 congure certain pool seings and security seings:
If you plan to use Access Point, congure Connection Server to work with Access Point. See Deploying
n
and Conguring Access Point. Access Point appliances fulll 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
congured 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 Seings 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 Seing 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 two­factor 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 "Congure 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, congure View LDAP for this feature on the Connection Server host.
Users can save their passwords if View LDAP is congured to allow it, if the Horizon Client certicate
verication 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 certicate 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 Seing 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 hp://www.vmware.com/go/viewclients, or it might be the URL for a Connection Server instance.
Procedure
1 On 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.
2 Download the app.
3 If you downloaded the app to a Mac or PC, connect your iOS device to the computer and follow the
onscreen instructions in iTunes.
4 To determine whether the installation succeeded, verify that the Horizon app icon appears on the iOS
device.

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 prexes 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 prex viewclient-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 hp://www.rsa.com/node.aspx?id=3652 or RSA SecurID Software Token for Android at hp://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 formaing 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 congure 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 conguring the security protocols that are accepted by Connection Server instances, see the View Security document.
Procedure
1 Tap  at the boom of the Horizon Client screen.
2 Tap Advanced SSL Options.
3 Make sure that the Reset to Default  option is set to o.
4 To enable or disable a security protocol, tap the On or  toggle next to the security protocol name.
5 To change the cipher control string, replace the default string.
6 (Optional) If you need to revert to the default seings, tap Reset in the upper right corner of the screen.
Your changes take eect the next time you connect to the server.

Configure VMware Blast Options

You can congure 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
1 Tap  at the boom of the Horizon Client screen.
2 Tap VMware Blast.
14 VMware, Inc.
3 Congure the decoding and network protocol options.
Option Description
H.264
UDP
Select this option to allow H.264 decoding in Horizon Client. When this option is selected (the default seing), 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 seing), 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 eect the next time a user connects to a remote desktop or application and selects the VMware Blast display protocol. Your changes do not aect existing VMware Blast sessions.

Configure the Horizon Client Default View

You can congure whether the Recent screen or the Servers screen appears when you launch Horizon Client.
Chapter 1 Setup and Installation
Procedure
1 Tap  at the boom of the Horizon Client screen.
2 Tap Default View.
3 Tap an option to select the default view.
Option Description
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 seing.
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 eect immediately.

Configure AirWatch to Deliver Horizon Client to iOS Devices

You can congure 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 hp://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
1 Log in to the AirWatch console as an administrator.
VMware, Inc. 15
Using VMware Horizon Client for iOS
2 Select Accounts > Users > List View, click Add User, and add user accounts for the users who will run
Horizon Client on their mobile devices.
3 Select Accounts > Users > User Groups, click Add, and create a user group for the user accounts that
you created.
4 Upload and add the Horizon Client application to AirWatch.
a Select Apps & Books > Applications > List View and click Add Application on the Public tab.
b Search for and select VMware Horizon Client for Apple iOS in the App Store.
c On the Info tab, type an application name and specify the supported iOS device models.
d On the Assignment tab, assign the Horizon Client application to the user group that you created.
e (Optional) To congure 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.
f Publish the Horizon Client application.
5 Install and set up the AirWatch MDM Agent on each iOS device.
You can download the AirWatch MDM Agent from iTunes.
6 Use the AirWatch console to install the Horizon Client application on the mobile devices.
You cannot install the Horizon Client application before the eective 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 congured 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 identies 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-specic directory. The logs do not contain any personally identiable 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 11. 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 name No VMware Horizon Client
Client product version No (The format is x.x.x-yyyyyy, where x.x.x is the client version
Client binary architecture No Examples include the following:
Client build name No Examples include the following:
Host operating system No Examples include the following:
Host operating system kernel No Examples include the following:
Host operating system architecture No Examples include the following:
Host system model No Examples include the following:
? Example Value
No VMware
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 11. Data Collected from Horizon Clients for the Customer Experience Improvement Program (Continued)
Description
Host system CPU No Examples include the following:
Number of cores in the host system's processor
MB of memory on the host system No Examples include the following:
Number of USB devices connected No 2 (USB device redirection is supported only for Linux,
Maximum concurrent USB device connections
USB device vendor ID No Examples include the following:
USB device product ID No Examples include the following:
USB device family No Examples include the following:
USB device usage count No (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.)
No 2
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 Client 2
Using uniform resource identiers (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 specic desktop or application with specic conguration 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 dierent 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 specic 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 conguration options.
URI Specification
Use the following syntax to create URIs to start Horizon Client:
vmware-view://[authority-part][/path-part][?query-part]
VMware, Inc.
19
Using VMware Horizon Client for iOS
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
hp://www.utf8-chartable.de/.
authority-part
path-part
query-part
Species 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
Species the desktop or application. Use the desktop display name or application display name. This name is the one specied 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.
Species the conguration 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 conict 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 21. Values That Can Be Used With the action Query
Value Description
browse
start-session
Displays a list of available desktops and applications hosted on the specied 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 specied 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 21. Values That Can Be Used With the action Query (Continued)
Value Description
reset
logoff
Shuts down and restarts the specied desktop or remote application. Unsaved data is lost. Reseing a remote desktop is the equivalent of pressing the Reset buon 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
Species 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.
Species the RSA or RADIUS user name. Use this query only if the RSA or RADIUS user name is dierent 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 buons 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.
1
vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session
VMware, Inc. 21
Using VMware Horizon Client for iOS
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.
2
vmware-view://view.mycompany.com:7555/Primary%20Desktop
This URI has the same eect as the previous example, except that it uses the nondefault port of 7555 for Connection Server. (The default port is 443.) Because a desktop identier is provided, the desktop opens even though the start-session action is not included in the URI.
3
vmware-view://fred@view.mycompany.com/Finance%20Desktop?desktopProtocol=PCOIP
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 Finance Desktop, and the user is logged in to the guest operating system. The connection uses the PCoIP display protocol.
4
vmware-view://view.mycompany.com/Calculator?action=start-session&appProtocol=BLAST
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.
5
vmware-view://fred@view.mycompany.com/Finance%20Desktop?domainName=mycompany
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
view.mycompany.com server.
7
vmware-view://view.mycompany.com/Primary%20Desktop?action=reset
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 conrm 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.
10
vmware-view://10.10.10.10/My%20Notepad++?args=%22My%20new%20file.txt%22
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.
Chapter 2 Using URIs to Configure Horizon Client
11
vmware-view://10.10.10.10/Notepad++%2012?args=a.txt%20b.txt
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 dier 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 buons 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 buon that says, .
<html>
<body>
<a href="vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session">Test
Link</a><br>
<form><input type="button" value="TestButton" onClick="window.location.href=
'vmware-view://view.mycompany.com/Primary%20Desktop?action=start-session'"></form> <br>
</body>
</html>
Using VMware Horizon Client for iOS
24 VMware, Inc.
Managing Remote Desktop and
Application Connections 3
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 congures 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
“Seing the Certicate 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 qualied 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.
Congure the certicate checking mode for the SSL certicate presented by Connection Server. See
n
“Seing the Certicate 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
seing on your iOS device. For complete Touch ID authentication requirements, see “Touch ID
Authentication Requirements,” on page 10.
Procedure
1 If a VPN connection is required, turn on the VPN.
2 Tap the Horizon app icon on the Home screen.
3 Connect to a server.
Option Action
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 congured to use the default port, use the format shown in this example:
view.company.com:1443.
4 If a smart card is required or optional, select the smart card certicate to use and enter your PIN.
If your smart card has only one certicate, that certicate is already selected. If there are many certicates, you can scroll through them if necessary.
5 If 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.
Option Action
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
6 If 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 conguration seings in the RSA server change.
7 (Optional) If the Enable Touch ID seing is available, turn the seing on to use Touch ID to
authenticate.
The Enable Touch ID seing is available only if biometric authentication is enabled on the server and you have not previously authenticated with Touch ID.
8 If you are prompted for a user name and password, supply Active Directory credentials.
a Type the user name and password of a user who is entitled to use at least one desktop or
application pool.
b Select 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 certicate can be fully veried.
d Tap 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.
9 If you are prompted for Touch ID authentication, place your nger on the Home buon.
10 (Optional) Tap  at the boom of the Horizon Client screen and tap Preferred Protocol to select
the display protocol to use.
VMware Blast provides beer baery 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 congure whether client connections are rejected if any or some server certicate checks fail.
Certicate checking occurs for SSL connections between Connection Server and Horizon Client. Certicate verication includes the following checks:
Is the certicate 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 certicate?
Using VMware Horizon Client for iOS
Has the certicate expired, or is it valid only in the future? That is, is the certicate valid according to
n
the computer clock?
Does the common name on the certicate 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 certicate 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 certicate signed by an unknown or untrusted certicate authority (CA)? Self-signed certicates
n
are one type of untrusted CA.
To pass this check, the certicate's chain of trust must be rooted in the device's local certicate store.
I For information about distributing a self-signed root certicate that users can install on their iOS devices, see the instructions on the Apple Web site. For example, for iPads, see
hp://www.apple.com/ipad/business/docs/iPad_Certicates.pdf.
To set the certicate checking mode, tap  at the boom of the Horizon Client screen and tap Server   Mode. You have three choices:
Never connect to untrusted servers. If any of the certicate 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 certicate check fails because the server uses a self-
n
signed certicate, you can click Continue to ignore the warning. For self-signed certicates, the certicate name is not required to match the server name you entered in Horizon Client.
Do not verify server identity . This seing means that no certicate checking occurs.
n
If the certicate checking mode is set to Warn, you can still connect to a Connection Server instance that uses a self-signed certicate.
If an administrator later installs a security certicate from a trusted certicate authority, so that all certicate checks pass when you connect, this trusted connection is remembered for that specic server. In the future, if that server ever presents a self-signed certicate again, the connection fails. After a particular server presents a fully veriable certicate, 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
1 Tap Servers (cloud icon) at the boom of the screen to display the saved servers.
2 To manage a saved server, touch and hold the server icon until the context menu appears.
Option Action
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.
c Tap 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
Option Action
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 identied 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
1 Tap Servers (cloud icon) at the boom of the screen and tap the server icon to connect to the server.
2 If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3 Perform these steps to select or deselect a desktop or application as a favorite.
Option Action
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 boom of the screen to display only favorite desktops or
applications.
You can tap All (cloud icon) at the boom 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 congure your desktop to automatically log o when disconnected. In that case, any open programs in your desktop are stopped.
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
1 Tap Servers (cloud icon) at the boom of the screen and tap the server icon.
2 If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3 Touch and hold the desktop name until the context menu appears.
4 Tap Log  in the context menu.
What to do next
Tap the Logout buon 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
a Touch and hold the shortcut.
b Tap the X buon.
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 boom of the Horizon Client screen, tap Touch, and toggle the Peek for the menu seing to on. If you are connected to a remote desktop or application, you can access seings 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 Resolution seing is set to Auto
- Fit. For information about seing the resolution for a remote desktop, see “Changing the Display
Resolution Seing,” on page 46.
N Horizon Client does not support Picture in Picture.
32 VMware, Inc.
Using a Microsoft Windows Desktop
or Application 4
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
“Congure Horizon Client to Support Reversed Mouse Buons,” 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 41. Features Supported on Windows Desktops for iOS Horizon Clients
Windows
Feature
RSA SecurID or RADIUS
Single sign-on X X X Limited Limited X
RDP display protocol
PCoIP display protocol X X X Limited Limited X
VMware Blast display protocol
USB access
Real-Time Audio-Video (audio-in only)
Wyse MMR
Windows 7 MMR
Virtual printing
Location-based printing X X X Limited Limited X
Smart cards X X X Limited Limited X
Multiple monitors
10 Desktop
X X X Limited Limited X
X X X X
X X X X
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 species 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 42. 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 RADIUS X X Horizon Agent 7.0.2 and later
Smart card View Agent 6.1 and later View Agent 6.1 and later Horizon Agent 7.0.2 and later
Single sign-on X X Horizon Agent 7.0.2 and later
RDP display protocol (for desktop clients)
PCoIP display protocol X X Horizon Agent 7.0.2 and later
VMware Blast display protocol
HTML Access View Agent 6.0.2 and later
Virtual printing (for desktop clients)
Location-based printing View 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
X X Horizon Agent 7.0.2 and later
Horizon Agent 7.0 and later Horizon Agent 7.0 and
(virtual machine only)
View Agent 6.0.1 and later (virtual machine only)
(virtual machine only)
X X Horizon Agent 7.0.2 and later
X X Horizon 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
Specic features that are supported on Windows desktops for Horizon Client for iOS have certain restrictions.
Table 43. Requirements for Specific Features
Feature Requirements
Left Handed Mode This feature is iOS specic. If your remote desktop is
congured so that the primary and secondary mouse buons are switched, use the Left Handed Mode feature.
See “Congure Horizon Client to Support Reversed Mouse
Buons,” 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 43. Requirements for Specific Features (Continued)
Feature Requirements
Smart cards for RDS desktops View 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
Seing Up Horizon 6 for Linux Desktops, which is part of the Horizon 6 version 6.1 documentation, or see Seing 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 aempt 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 Keyboard buon 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, Simplied 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 congure 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
1 Use the Horizon Client Tools to display the Options dialog box.
2 Tap to toggle the Japanese 106/109 Keyboard option to on.
This seing is disabled if the keyboard layout on the Windows XP desktop is not set to Japanese. This seing is hidden if the desktop is not running Windows XP.
3 Tap 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 seing up the Real-Time Audio-Video feature on a remote desktop, see the Seing Up Desktop 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 Seings 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 buon 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 boom of the Horizon Client screen, tap Touch, and toggle the Windows Native Touch Gestures seing to o. If you are connected to a remote desktop or application, you can access seings 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 41. 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 44. Unity Touch Sidebar Actions for a Remote Desktop
Action Procedure
Show the sidebar Swipe 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 sidebar Swipe 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 44. Unity Touch Sidebar Actions for a Remote Desktop (Continued)
Action Procedure
Navigate to an application Tap 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 le Tap 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 prole (%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 More buon that appears.
3 Tap Minimize.
1 Touch the application name under Running Applications and swipe from right to
left.
2 Tap the More buon that appears.
3 Tap Maximize.
Touch the application name under Running Applications and swipe from right to left. Tap the Close buon that appears.
1 Touch the application name under Running Applications and swipe from right to
left.
2 Tap the More buon 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 44. Unity Touch Sidebar Actions for a Remote Desktop (Continued)
Action Procedure
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 proles are congured 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 Seing 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 42. 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 45. Unity Touch Sidebar Actions for a Remote Application
Action Procedure
Show the sidebar Swipe the tab to the right to open the sidebar. When the sidebar is open, you cannot
perform actions on the application screen.
Hide the sidebar Swipe 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 application Tap the name of the application under Available Applications in the sidebar. The
Close a running application 1 Touch the application name under Current Connection and swipe from right to
Minimize a running application 1 Touch the application name under Current Connection and swipe from right to
Maximize a running application 1 Touch the application name under Current Connection and swipe from right to
Restore a running application 1 Touch the application name under Current Connection and swipe from right to
Switch to a remote desktop Tap the desktop name under Desktops.
Tap the application under Current Connection.
application starts and the sidebar closes.
left.
2 Tap the Close buon that appears.
left.
2 Tap the More buon that appears.
3 Tap Minimize.
left.
2 Tap the More buon that appears.
3 Tap Maximize.
left.
2 Tap the More buon that appears.
3 Tap Restore.

Horizon Client Tools on a Mobile Device

On a mobile device, the Horizon Client Tools include buons for displaying the onscreen keyboard, virtual touchpad, conguration seings, 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
Icon Description
Horizon Client Tools radial menu
Disconnect
Onscreen keyboard (toggles to show or hide)
VMware, Inc. 41
Using VMware Horizon Client for iOS
Table 46. Radial Menu Icons (Continued)
Icon Description
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.
Seings
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 buer. 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 buons.
n
To simulate holding down the left-click buon 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 buons. Tap to expand the Horizon Client Tools radial menu icon, tap the  (gear) icon, tap Touch, and toggle the Full Screen Touchpad Mode seing 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 Touchpad Sensitivity option.
You can also set the Full Screen Touchpad Mode and Touchpad Sensitivity seings from the Horizon Client Seings screen. Tap  at the boom of the Horizon Client screen and tap Touch to display the touchpad seings.

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 congured for a left-handed user, see “Congure Horizon Client to
Support Reversed Mouse Buons,” 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
buon.
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 buon 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 nger o 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.
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 congure the ability to copy and paste by conguring group policy seings 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 Seing Up Desktop and Application 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 formaed text is pasted. Often the RTF data cannot be truncated, so that if the text and formaing 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 formaed 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 species where documents are saved. This policy is called "Set Remote Desktop Services User Home Directory." For more information, see the "RDS Proles Seings" topic in the Seing 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 buons are switched in your remote desktop.
If you set the mouse properties inside your remote desktop so that the primary mouse buon 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 buons are reversed, a single tap acts as a click of the secondary mouse buon. 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
a Tap to expand the Horizon Client Tools radial menu icon and tap the  (gear) icon to open
the Seings screen.
b Tap Touch on the Seings screen.
c Tap Left Handed Mode to toggle the option to on.
d Tap Done to close the Seings screen.
If you are not connected to the remote desktop, perform these steps.
n
a Tap  at the boom of the Horizon Client screen.
b Tap Touch on the Seings screen.
c Tap Left Handed Mode to toggle the option to on.
A single tap now acts as a click with the primary mouse buon.
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 Seings screen. Tap  at the boom 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 Resolution seing 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 aached monitor, enable the Presentation Mode seing. 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 aached monitor, including the Unity Touch sidebar, by turning o the Presentation mode seing. If you are connected to a remote desktop and the Presentation Mode seing is enabled, you can click Done to switch to mirror mode.
You can use the Keep the screen alive during Presentation seing to keep the display from turning o after a period of inactivity while in presentation mode.
You can congure these seing 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 congure these seing by tapping the  (gear) icon at the boom 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.

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 boom 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 signicant amount of bandwidth. This ecient scrolling has benets both on the LAN and over the WAN.
On the LAN, where bandwidth is relatively unconstrained, using client-side image caching delivers
n
signicant 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 transmied. 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 boom 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, Simplied 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 Client 5

You can solve most Horizon Client problems by reseing 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 congure 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 congured on your device and aaches 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 aects the performance of Horizon Client, enable log collection only if you are experiencing a problem.
Prerequisites
Verify that an email account is congured on your device. Horizon Client uses this email account to send log les.
VMware, Inc.
49
Using VMware Horizon Client for iOS
Procedure
1 If you are already connected to a remote desktop or application, perform these steps:
a Tap to expand the Horizon Client Tools radial menu icon and tap the  (gear) icon to open
the Seings screen.
b Tap Log Collection on the Seings screen.
c Tap to toggle the Logging option to on.
d Tap Done to close the Seings screen.
2 If you are not connected to a remote desktop or application, perform these steps:
a Tap  at the boom of the Horizon Client screen to open the Seings screen.
b Tap Log Collection on the Seings screen.
c Tap 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 aaches the GZ le to an email message.
If you switch from a running desktop to seings, 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 congured 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
1 In Horizon Client, tap the email icon at the top of the screen.
2 Type the address of the email recipient in the To: line and click Send to send the message.
The email account congured on your device appears in the From: line.
The existing GZ log le is aached 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.
Chapter 5 Troubleshooting Horizon Client

Disable Horizon Client Log Collection

Because log collection aects the performance of Horizon Client, disable log collection if you are not troubleshooting a problem.
Procedure
1 If you are already connected to a remote desktop or application, perform these steps.
a Tap to expand the Horizon Client Tools radial menu icon and tap the  (gear) icon to open
the Seings screen.
b Tap Log Collection on the Seings screen.
c Tap to toggle the Logging option to o.
d Tap Done to close the Seings screen.
2 If you are not connected to a remote desktop or application, perform these steps.
a Tap  at the boom of the Horizon Client screen to open the Seings screen.
b Tap Log Collection on the Seings screen.
c Tap to toggle the Logging option to o.

Reset a Remote Desktop or Application

Reseing a remote desktop shuts down and restarts the desktop. Reseing a remote application quits the application. You might need to reset a desktop or application if the desktop operating system or application stops responding.
Reseing a remote desktop is the equivalent of pressing the Reset buon 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.
Reseing 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
1 Tap Servers (cloud icon) at the boom of the screen and tap the server icon to connect to the server.
2 If prompted, supply your RSA user name and passcode, your Active Directory user name and
password, or both.
3 Touch and hold the desktop or application name until the context menu appears.
4 Tap 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.
Using VMware Horizon Client for iOS

Uninstall Horizon Client

You can sometimes resolve problems with Horizon Client by uninstalling and reinstalling Horizon Client.
Procedure
1 If 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.
2 Connect your device to your computer and allow the device to synchronize with iTunes on your Mac or
PC.
3 If 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 reseing 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 congured 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 reseing 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 aempt to connect to the server, you might need to change your
n
proxy seings.

Problem Establishing a Connection When Using a Proxy

Sometimes if you aempt 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 congured 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 seings so that the device no longer uses a proxy.
u
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
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
Using VMware Horizon Client for iOS
P
PCoIP client image cache 47 prerequisites for client devices 11 projectors 46 proxy connections 52
R
Real-Time Audio-Video feature 8, 37 reset a desktop 51 resizing windows 43 resolution, screen 46 reversed mouse buttons 45 RSA SecurID tokens 13 running in the background 44
S
saving documents in a remote application 45 screen resolution 46 scrolling 43 security servers 11 server connections, managing 25
shortcut, desktops 30 sidebar, Unity Touch 38 smart card authentication
on devices 9
requirements 8 software tokens 13 Split View 32 Spotlight search 31 SSL options 14 system requirements, for iPad and iPhone 7
T
tablet gestures 43 tokens, RSA SecurID 13
toolbar, Horizon Client 41 Touch ID authentication 10 touchpad, virtual 41
troubleshooting, connection problems 52
U
Unity Touch feature 38 Unity Touch sidebar 40 URI examples 21 URI syntax for Horizon Clients 19 URIs (uniform resource identifiers) 19
V
VMware Blast 14
W
Windows 8 gestures 37 Windows desktop or application 33
56 VMware, Inc.
Loading...