Remote Control enables you to connect to any monitored macOS devices without locally logged-in users and to all your monitored Windows devices. Remote Control allows you to control any console or remote session. This article describes the process to do so.
BEFORE YOU BEGIN For this feature to be available, the managed device must be powered on and checking in to your Pulseway platform.
Overview
Pulseway supports two different methods by which you can connect to a target device. Console sessions allow you to take control of the computer as if you were sitting in front of it. Remote Desktop sessions permit you to collaborate with users currently active on the machine. While connected to the remote device, you can also transfer files to and from it.
Remote Control on Demand
Remote Control on Demand (RCoD) enables Pulseway technicians to gain temporary remote desktop access to a computer without an agent installed, even if the user does not have Administrator-level permissions.
For full details on how technicians and end users can leverage RCoD, refer to Remote Control on Demand.
Prerequisites
Before you can remotely control an endpoint, both the managed device and the computer you'll be using to control it must meet the following requirements:
On your local computer: You'll need to download and install the Remote Desktop Client application on the computer you'll be using for your remote control sessions. Installers for supported devices are available via Onboarding > Downloads in Pulseway.
On the managed device: The device to which you're connecting must have remote control enabled.
NOTE: When the Remote Control Client is used for the first time (whether RCoD or standard Remote Control), the client will automatically detect an available update. A message will appear stating that a new update is available and the update process has begun. The app will then update automatically, and the session will continue without interruption
How to...
1. Enable Remote Control on a managed device
You can enable remove access to a device at the agent or policy level. Policy settings will always take precedence over individual agent settings and are more convenient, as you can apply them to multiple machines at once.
To learn how to permit Pulseway remote control access to an endpoint, choose a workflow to continue.
Policy Level
From the left navigation menu in Pulseway, navigate to Configuration > Policies.
Select the policy and profile of the device you'd like to manage.
Scroll to the Details section of the profile's Configuration pane.
In the Remote Desktop row, select the Enable option.
Click Save.
Proceed to the Remote Control section of this article to continue.
Agent Level
On the device you'd like to control, launch the Pulseway Manager application.
Navigate to System > Remote Control.
Select the Enable Remote Control option.
In the Remote Control Settings section, configure the actions that the Pulseway agent should take upon receiving a remote control request.
Click Apply.
Proceed to the Remote Control section of this article to continue.
2. Connect to a device via Remote Control
Establishing the connection
You can launch a remote control session for a managed device from the Device List page. To do so, perform the following steps.
From the left navigation menu in Pulseway, navigate to Devices > Device List.
You'll see a list of all of your managed endpoints, grouped by organization.
Enter a partial or whole device name in the search bar at the top of the page. As you type, you'll notice the list of devices begins to filter to only those endpoints with attributes matching your search criteria. You can apply additional criteria to your search by selecting options from the Filter by list.
Click any search result to populate the endpoint's extended details and management options in the device details pane.
Scroll down to the Manage section and click the Remote Control option.
The device details pane will pivot to the Remote Control launchpad for the selected device. Select the connection method you'd like to use.
Remote Control Connection Options
You can use the following connection methods to reach a managed device via Remote Control.
NOTE Availability of connection options may vary depending on your Pulseway permissions and current remote activity on the target endpoint.
Feature | Definition |
Share the Console Session | Connects to a console session already established by another system administrator. |
Launch a new Pulseway RDP Session | Initiates a Remote Desktop session via the Pulseway Agent using local or stored 1-Click credentials. |
Launch a new Session using the Microsoft RDP Client | Launches Microsoft's Remote Desktop Connection app to connect to the selected device; requires local credentials and the local or external IP address of the target endpoint. |
Share Other Active Sessions | Join a remote session already underway; connection protocols vary depending on the type of session in progress. |
View Recorded Sessions Folder | Opens a folder of any Remote Desktop sessions that were automatically or manually recorded on the device. |
IMPORTANT If you do not receive any prompts from your browser or remote control window does not appear after selecting a connection method, ensure that both the managed device and your local computer meet the requirements described in the Prerequisites section of this article.
7. Pulseway will launch the remote control session and connect to the managed device via the selected method.
If you connected to the endpoint via a Pulseway protocol, a remote control window will open on your computer, providing access to management tools and a condensed view of the target device's desktop.
If you connected via Microsoft RDP, you'll have access to the Remote Desktop user experience. Refer to Microsoft's How to use Remote Desktop article.
Remote session tools
When you connect to a session established via a Pulseway protocol, you'll notice a toolbar that appears at the top of the remote control window. This toolbar provides you with quick access to the following session management features:
Menu | Option | Definition |
Record Session | Records any supported Remote Control session if session recordings have been enabled for the device via a Device Configuration: Remote Desktop Profile. This feature is available for Windows agents, and both shared and private sessions are supported.
NOTE A protection mechanism will ensure that recordings do not result in the total consumption of disk space on the local device. Recordings will not start if less than 10% of free disk space is available on the target agent. If a recording has started, and the target agent available disk space falls below 10%, the recording will immediately stop. |
|
Commands | Ctrl+Alt+Del | Inject the Windows Ctrl+Alt+Del keyboard command into supported operating systems. |
Paste as Keystrokes | Injects the current contents of the local clipboard into the remote session as keystrokes. |
|
Input as Keystrokes | Opens a modal on your local machine that enables you to construct a custom string to be sent to the remote session as keystrokes. |
|
File Transfer | Opens an FTP modal enabling background transfer of files to and from the remote device. |
|
Chat | Launches a chat window on your local computer and the remote machine to facilitate communication with other active users. |
|
Settings | Smart Sizing | Automatically scales the viewport to an optimal resolution for viewing the remote content. |
Disable Wallpaper | Hides the wallpaper on the target device for the duration of the session. |
|
Input Restrictions | Provides options for blocking the remote user's keyboard and mouse input and blanking the remote display. |
|
Session health | Displays real-time information about the session's round-trip time (RTT). |
|
Use hardware acceleration | Leverage hardware acceleration, if available, to render the content in the remote control window. |
|
Screen options | Enables you to throttle the remote control window's rendering engine between Best quality, Balanced, and Best speed. |
|
Screen Scaling | Provides management options for upscaling the view of the remote computer's desktop in the remote control window. |
|
1-Click | Injects saved 1-Click credentials into the current session. |
|
Feedback | Opens a feedback survey enabling you to rate the quality of the session connection and provide comments for the Pulseway product management team. |
|
 | Collapses the management toolbar. |
|
 | Expands the viewport to the dimensions of the current display. |
|
 | Closes the management toolbar. |
|