xj3.netlify.com

Known issues in build. We are continuing to make changes to our extension datastore schema in Microsoft Edge. As a result, after updating to this build any.

• Microsoft Remote Desktop Mac Changelog 10
• Relative To Changelog File
• Jenkins Changelog

-->

Use Microsoft Remote Desktop for Mac to connect to a remote PC or virtual apps and desktops made available by your admin. With Microsoft Remote Desktop, you can be productive no matter where you are. GET STARTED Configure your PC for remote access using the information at https://aka.ms/rdsetup. A beta attribute can be overridden to install the beta of Microsoft Remote Desktop from HockeyApp instead of the normal one from the Mac App Store. A wrapper for the other resources. Syntax: microsoftremotedesktop 'default' do beta false action:install end Actions.

Applies to: Windows 10

You can use the Remote Desktop client for Windows to work with Windows apps and desktops remotely from a different Windows device.

Use the following information to get started. Be sure to check out the FAQ if you have any questions.

Note

• Curious about the new releases for the Windows Store client? Check out What's new in the Windows Store client
• You can run the client on any supported version of Windows 10.

Get the RD client and start using it

Follow these steps to get started with Remote Desktop on your Windows 10 device:

1. Download the Remote Desktop client from Microsoft Store.
2. Set up your PC to accept remote connections.
3. Add a Remote Desktop connection or a remote resource. You use a connection to connect directly to a Windows PC and a remote resource to use a RemoteApp program, session-based desktop, or virtual desktop published by your admin.
4. Pin items so you can get to Remote Desktop quickly.

Add a Remote Desktop connection

To create a Remote Desktop connection:

1. In the Connection Center tap + Add, and then tap Desktop.
2. Enter the following information for the computer you want to connect to:
   • PC name – the name of the computer. This can be a Windows computer name, an Internet domain name, or an IP address. You can also append port information to the PC name (for example, MyDesktop:3389 or 10.0.0.1:3389).
   • User account – The user account to use to access the remote PC. Tap + to add a new account or select an existing account. You can use the following formats for the username: user_name, domainuser_name, or user_name@domain.com. You can also specify whether to prompt for a user name and password during the connection by selecting Ask me every time.
3. You can also set additional options by tapping on Show more:
   • Display name – An easy-to-remember name for the PC you are connecting to. You can use any string, but if you do not specify a friendly name, the PC name is displayed.
   • Group – Specify a group to make it easier to find your connections later. You can add a new group by tapping + or select one from the list.
   • Gateway – The Remote Desktop gateway that you want to use to connect to virtual desktops, RemoteApp programs, and session-based desktops on an internal corporate network. Get the information about the gateway from your system administrator.
   • Connect to admin session - Use this option to connect to a console session to administrate a Windows server.
   • Swap mouse buttons – Use this option to swap the left mouse button functions for the right mouse button. (This is especially useful if the remote PC is configured for a left-handed user but you use a right-handed mouse.)
   • Set my remote session resolution to: – Select the resolution you want to use in the session. Choose for me will set the resolution based on the size of the client.
   • Change the size of the display: – When selecting a high static resolution for the session, you have the option to make items on the screen appear larger to improve readability. Note: This only applies when connecting to Windows 8.1 or above.
   • Update the remote session resolution on resize – When enabled, the client will dynamically update the session resolution based on the size of the client. Note: This only applies when connecting to Windows 8.1 or above.
   • Clipboard – When enabled, allows you to copy text and images to/from the remote PC.
   • Audio Playback – Select the device to use for audio during your remote session. You can choose to play sound on the local devices, the remote PC, or not at all.
   • Audio Recording – When enabled, allows you to use a local microphone with applications on the remote PC.
4. Tap Save.

Need to edit these settings? Tap the overflow menu (..) next to the name of the desktop, and then tap Edit.

Want to delete the connection? Again, tap the overflow menu (..), and then tap Remove.

Add a remote resource

Remote resources are RemoteApp programs, session-based desktops, and virtual desktops published by your admin using Remote Desktop Services.

To add a remote resource:

1. On the Connection Center screen, tap + Add, and then tap Remote resources.
2. Enter the Feed URL provided by your admin and tap Find feeds.
3. When prompted, provide the credentials to use to subscribe to the feed.

The remote resources will be displayed in the Connection Center.

To delete remote resources:

1. In the Connection Center, tap the overflow menu (..) next to the remote resource.
2. Tap Remove.

Pin a saved desktop to your Start menu

To pin a connection to your Start menu, tap the overflow menu (..) next to the name of the desktop, and then tap Pin to Start.

Now you can start the remote desktop connection directly from your Start menu by tapping it.

Connect to an RD Gateway to access internal assets

A Remote Desktop Gateway (RD Gateway) lets you connect to a remote computer on a corporate network from anywhere on the Internet. You can create and manage your gateways using the Remote Desktop client.

To set up a new gateway:

Microsoft Remote Desktop Mac Changelog 10

1. In the Connection Center, tap Settings.
2. Next to Gateway, tap + to add a new gateway. Note: A gateway can also be added when adding a new connection.
3. Enter the following information:
   • Server name – The name of the computer you want to use as a gateway. This can be a Windows computer name, an Internet domain name, or an IP address. You can also add port information to the server name (for example: RDGateway:443 or 10.0.0.1:443).
   • User account - Select or add a user account to use with the Remote Desktop Gateway you are connecting to. You can also select Use desktop user account to use the same credentials as those used for the remote desktop connection.
4. Tap Save.

Global app settings

You can set the following global settings in your client by tapping Settings:

MANAGED ITEMS

• User account - Allows you to Add, edit and delete user accounts saved in the client. This is a good way to update the password for an account after it has changed.
• Gateway - Allows you to Add, edit and delete gateway servers saved in the client.
• Group - Allows you to Add, edit and delete groups saved in the client. These allow you to easily group connections.

SESSION SETTINGS

• Start connections in full screen - When enabled, anytime a connection is launched, the client will use the entire screen of the current monitor.
• Start each connection in a new window - When enabled, each connection is launched in a separate window, allowing you to place them on different monitors and switch between them using the taskbar.
• When resizing the app: - Allows you control over what happens when the client window is resized. Defaults to Stretch the content, preserving aspect ratio.
• Use keyboard commands with: - Let's you specify where keyboard commands like WIN or ALT+TAB are used. The default is to only send them to the session when the connection is in full screen.
• Prevent the screen from timing out - Allows you to keep the screen from timing out when a session is active. This is helpful when the connection does not require any interaction for long periods of time.

APP SETTINGS

• Show Desktop Previews - Lets you see a preview of a desktop in the Connection Center before you connect to it. By default, this is set to on.
• Help improve Remote Desktop - Sends anonymous data to Microsoft. We use this data to improve the client. To learn more about how we treat this anonymous, private data, see the Microsoft Privacy Statement. By default, this setting is on.

Manage your user accounts

When you connect to a desktop or remote resources, you can save the user accounts to select from again. You can also define user accounts in the client itself, as opposed to saving the user data when you connect to a desktop.

To create a new user account:

1. In the Connection Center, tap Settings.
2. Next to User account, tap + to add a new user account.
3. Enter the following information:
   • Username - The name of the user to save for use with a remote connection. You can enter the user name in any of the following formats: user_name, domainuser_name, or user_name@domain.com.
   • Password - The password for the user you specified. This can be left blank to be prompted for a password during the connection.
4. Tap Save.

To delete a user account:

Microsoft office professional 2013 for mac. The apps can be installed on multiple devices, including PCs, Macs, iPads, iPhones, Android tablets, and Android phones.

1. In the Connection Center, tap Settings.
2. Select the account to delete from the list under User account.
3. Next to User account, tap the edit icon.
4. Tap Remove this account at the bottom to delete the user account.
5. You can also edit the user account and tap Save.

Navigate the Remote Desktop session

When you start a remote desktop connection, there are tools available that you can use to navigate the session.

Start a Remote Desktop connection

1. Tap the Remote Desktop connection to start the session.
2. If you haven't saved credentials for the connection, you will be prompted to provide a Username and Password.
3. If you are asked to verify the certificate for the remote desktop, review the information and ensure this is a PC you trust before tapping Connect. You can also select Don't ask about this certificate again to always accept this certificate.

Connection Bar

The connection bar gives you access to additional navigation controls. By default, the connection bar is placed in the middle at the top of the screen. Tap and drag the bar to the left or right to move it.

• Pan Control - The pan control enables the screen to be enlarged and moved around. Note that pan control is only available on touch-enabled devices and using the direct touch mode.
  • Enable / Disable the pan control: Tap the pan icon in the connection bar to display the pan control and zoom the screen. Tap the pan icon in the connection bar again to hide the control and return the screen to its original resolution.
  • Use the pan control - Tap and hold the pan control and then drag in the direction you want to move the screen.
  • Move the pan control - Double tap and hold the pan control to move the control on the screen.
• Additional options - Tap the additional options icon to display the session selection bar and command bar (see below).
• Keyboard - Tap the keyboard icon to display or hide the on-screen keyboard. The pan control is displayed automatically when the keyboard is displayed.

Command bar

Tap the .. on the connection bar to display the command bar on the right-hand side of the screen.

• Home - Use the Home button to return to the connection center from the command bar.
  • Alternatively you can use the back button for the same action.
  • Your active session will not be disconnected.
  • This allows you to launch additional connections.
• Disconnect - Use the Disconnect button to terminate the connection.
  • Your apps will remain active as long as the session is not terminated on the remote PC.
• Full-screen - Enters or exits full screen mode.
• Touch / Mouse - You can switch between the mouse modes (Direct Touch and Mouse Pointer).

Use direct touch gestures and mouse modes in a remote session

Two mouse modes are available to interact with the session.

• Direct touch: Passes all of the touch contacts to the session to be interpreted remotely.
  • Used in the same way you would use Windows with a touch screen.
• Mouse pointer: Transforms your local touch screen into a large touchpad allowing to move a mouse pointer in the session.
  • Used in the same way you would use Windows with a touchpad.

Relative To Changelog File

Note

Interacting with Windows 8 or newer the native touch gestures are supported in Direct Touch mode.

Mouse mode	Mouse operation	Gesture
Direct touch	Left click	1 finger tap
Direct touch	Right click	1 finger tap and hold
Mouse pointer	Left click	1 finger tap
Mouse pointer	Left click and drag	1 finger double tap and hold, then drag
Mouse pointer	Right click	2 finger tap
Mouse pointer	Right click and drag	2 finger double tap and hold, then drag
Mouse pointer	Mouse wheel	2 finger tap and hold, then drag up or down
Mouse pointer	Zoom	Use 2 fingers and pinch to zoom in or move fingers apart to zoom out.

Tip

Questions and comments are always welcome. However, please do NOT post a request for troubleshooting help by using the comment feature at the end of this article. Instead, go to the Remote Desktop client forum and start a new thread. Have a feature suggestion? Tell us using the Feedback Hub.

-->

Applies To: Windows 10, Windows 8.1, Windows Server 2012 R2, Windows Server 2016

You can use the Remote Desktop client for Mac to work with Windows apps, resources, and desktops from your Mac computer. Use the following information to get started - and check out the FAQ if you have questions.

Note

• Curious about the new releases for the macOS client? Check out What's new for Remote Desktop on Mac?
• The Mac client runs on computers running macOS 10.10 and newer.
• The information in this article applies primarily to the full version of the Mac client - the version available in the Mac AppStore. Test-drive new features by downloading our preview app here: beta client release notes.

Get the Remote Desktop client

Follow these steps to get started with Remote Desktop on your Mac: Make microsoft outlook default email.

1. Download the Microsoft Remote Desktop client from the Mac App Store.
2. Set up your PC to accept remote connections. (If you skip this step, you can't connect to your PC.)
3. Add a Remote Desktop connection or a remote resource. You use a connection to connect directly to a Windows PC and a remote resource to use a RemoteApp program, session-based desktop, or a virtual desktop published on-premises using RemoteApp and Desktop Connections. This feature is typically available in corporate environments.

What about the Mac beta client?

We're testing new features on our preview channel on AppCenter. Want to check it out? Go to Microsoft Remote Desktop for Mac and click Download. You don't need to create an account or sign into AppCenter to download the beta client.

If you already have the client, you can check for updates to ensure you have the latest version. In the beta client, click Microsoft Remote Desktop Beta at the top, and then click Check for updates.

Add a Remote Desktop connection

To create a remote desktop connection:

1. In the Connection Center, click +, and then click Desktop.

2. Enter the following information:

   • PC name - the name of the computer.
     • This can be a Windows computer name (found in the System settings), a domain name, or an IP address.
     • You can also add port information to the end of this name, like MyDesktop:3389.
   • User Account - Add the user account you use to access the remote PC.
     • For Active Directory (AD) joined computers or local accounts, use one of these formats: user_name, domainuser_name, or user_name@domain.com.
     • For Azure Active Directory (AAD) joined computers, use one of these formats: AzureADuser_name or AzureADuser_name@domain.com.
     • You can also choose whether to require a password.
     • When managing multiple user accounts with the same user name, set a friendly name to differentiate the accounts.
     • Manage your saved user accounts in the preferences of the app.

3. You can also set these optional settings for the connection:

   • Set a friendly name
   • Add a Gateway
   • Set the sound output
   • Swap mouse buttons
   • Enable Admin Mode
   • Redirect local folders into a remote session
   • Forward local printers
   • Forward Smart Cards

4. Click Save.

Jenkins Changelog

To start the connection, just double-click it. The same is true for remote resources.

Export and import connections

You can export a remote desktop connection definition and use it on a different device. Remote desktops are saved in separate .RDP files.

1. In the Connection Center, right-click the remote desktop.
2. Click Export.
3. Browse to the location where you want to save the remote desktop .RDP file.
4. Click OK.

Use the following steps to import a remote desktop .RDP file.

1. In the menu bar, click File > Import.
2. Browse to the .RDP file.
3. Click Open.

Add a remote resource

Remote resources are RemoteApp programs, session-based desktops, and virtual desktops published using RemoteApp and Desktop Connections.

• The URL displays the link to the RD Web Access server that gives you access to RemoteApp and Desktop Connections.
• The configured RemoteApp and Desktop Connections are listed.

To add a remote resource:

1. In the Connection Center click +, and then click Add Remote Resources.
2. Enter information for the remote resource:
   • Feed URL - The URL of the RD Web Access server. You can also enter your corporate email account in this field – this tells the client to search for the RD Web Access Server associated with your email address.
   • User name - The user name to use for the RD Web Access server you are connecting to.
   • Password - The password to use for the RD Web Access server you are connecting to.
3. Click Save.

The remote resources will be displayed in the Connection Center.

Connect to an RD Gateway to access internal assets

A Remote Desktop Gateway (RD Gateway) lets you connect to a remote computer on a corporate network from anywhere on the Internet. You can create and manage your gateways in the preferences of the app or while setting up a new desktop connection.

To set up a new gateway in preferences:

1. In the Connection Center, click Preferences > Gateways.
2. Click the + button at the bottom of the table Enter the following information:
   • Server name – The name of the computer you want to use as a gateway. This can be a Windows computer name, an Internet domain name, or an IP address. You can also add port information to the server name (for example: RDGateway:443 or 10.0.0.1:443).
   • User name - The user name and password to be used for the Remote Desktop gateway you are connecting to. You can also select Use connection credentials to use the same user name and password as those used for the remote desktop connection.

Manage your user accounts

When you connect to a desktop or remote resources, you can save the user accounts to select from again. You can manage your user accounts by using the Remote Desktop client.

To create a new user account:

1. In the Connection Center, click Settings > Accounts.
2. Click Add User Account.
3. Enter the following information:
   • User Name - The name of the user to save for use with a remote connection. You can enter the user name in any of the following formats: user_name, domainuser_name, or user_name@domain.com.
   • Password - The password for the user you specified. Every user account that you want to save to use for remote connections needs to have a password associated with it.
   • Friendly Name - If you are using the same user account with different passwords, set a friendly name to distinguish those user accounts.
4. Tap Save, and then tap Settings.

Customize your display resolution

You can specify the display resolution for the remote desktop session.

1. In the Connection Center, click Preferences.
2. Click Resolution.
3. Click +.
4. Enter a resolution height and width, and then click OK.

To delete the resolution, select it, and then click -.

Displays have separate spacesIf you are running Mac OS X 10.9 and disabled Displays have separate spaces in Mavericks (System Preferences > Mission Control), you need to configure this setting in the remote desktop client using the same option.

Drive redirection for remote resources

Drive redirection is supported for remote resources, so that you can save files created with a remote application locally to your Mac. The redirected folder is always your home directory displayed as a network drive in the remote session.

Note

In order to use this feature, the administrator needs to set the appropriate settings on the server.

Use a keyboard in a remote session

Mac keyboard layouts differ from the Windows keyboard layouts.

• The Command key on the Mac keyboard equals the Windows key.
• To perform actions that use the Command button on the Mac, you will need to use the control button in Windows (e.g.: Copy = Ctrl + C).
• The function keys can be activated in the session by pressing additionally the FN key (e.g.: FN + F1).
• The Alt key to the right of the space bar on the Mac keyboard equals the Alt Gr/right Alt key in Windows.

By default, the remote session will use the same keyboard locale as the OS you're running the client on. (If your Mac is running an en-us OS, that will be used for the remote sessions as well.) If the OS keyboard locale is not used, check the keyboard setting on the remote PC and change it manually. See the Remote Desktop Client FAQ for more information about keyboards and locales.

Support for Remote Desktop gateway pluggable authentication and authorization

Windows Server 2012 R2 introduced support for a new authentication method, Remote Desktop Gateway pluggable authentication and authorization, which provides more flexibility for custom authentication routines. You can now try this authentication model with the Mac client.

Important

Custom authentication and authorization models before Windows 8.1 are not supported, although the article above discusses them.

To learn more about this feature, check out https://aka.ms/paa-sample.

Tip

Questions and comments are always welcome. However, please do NOT post a request for troubleshooting help by using the comment feature at the end of this article. Instead, go to the Remote Desktop client forum and start a new thread. Have a feature suggestion? Tell us in the client user voice forum.