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.). Yosemite UX Pack will give you all new OS X Yosemite user experiences combined with iOS 8 graphics such as theme, wallpapers, and new OS X features combined altogether in single package working on Windows 7/8/8.1/10 without touching system files at all so it won't have such risk to harm your system at all. But Mac OS X and Linux are far less susceptible to malware than Windows. OS X in particular includes code-signing to prevent most types of malware. Because Windows is the dominant desktop OS.
-->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:
- Download the Microsoft Remote Desktop client from the Mac App Store.
- Set up your PC to accept remote connections. (If you skip this step, you can't connect to your PC.)
- 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 select 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, select Microsoft Remote Desktop Beta at the top, and then select Check for updates.
Add a workspace
Subscribe to the feed your admin gave you to get the list of managed resources available to you on your macOS device.
To subscribe to a feed:
- Select Add feed on the main page to connect to the service and retrieve your resources.
- Enter the feed URL. This can be a URL or email address:
- This URL is usually a Windows Virtual Desktop URL. Which one you use depends on which version of Windows Virtual Desktop you're using.
- For Windows Virtual Desktop (classic), use
https://rdweb.wvd.microsoft.com/api/feeddiscovery/webfeeddiscovery.aspx. - For Windows Virtual Desktop, use
https://rdweb.wvd.microsoft.com/api/arm/feeddiscovery.
- For Windows Virtual Desktop (classic), use
- To use email, enter your email address. This tells the client to search for a URL associated with your email address if your admin configured the server that way.
- This URL is usually a Windows Virtual Desktop URL. Which one you use depends on which version of Windows Virtual Desktop you're using.
- Select Subscribe.
- Sign in with your user account when prompted.
After you've signed in, you should see a list of available resources.
Once you've subscribed to a feed, the feed's content will update automatically on a regular basis. Resources may be added, changed, or removed based on changes made by your administrator.
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.
To export an RDP file:
- In the Connection Center, right-click the remote desktop.
- Select Export.
- Browse to the location where you want to save the remote desktop RDP file.
- Select OK.
To import an RDP file:
- In the menu bar, select File > Import.
- Browse to the RDP file.
- Select 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:
- In the Connection Center select +, and then select Add Remote Resources.
- 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.
- Select 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:
- In the Connection Center, select Preferences > Gateways.
- Select 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:
- In the Connection Center, select Settings > Accounts.
- Select Add User Account.
- 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.
- Select Save, then select Settings.
Customize your display resolution
You can specify the display resolution for the remote desktop session.
- In the Connection Center, select Preferences.
- Select Resolution.
- Select +.
- Enter a resolution height and width, and then select OK.
To delete the resolution, select it, and then select -.
Displays have separate spaces
If you're running Mac OS X 10.9 and have 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 (for example Copy = Ctrl+C).
- The function keys can be activated in the session by pressing additionally the FN key (for example, 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 aren't 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.
Mac OS 9 for Windows
Run classic Mac OS apps in Windows | A similar app that runs System 7 | How to use MacOS9 | What the MacOS9 app contains | Acknowledgments | Support
An easy way to run 'classic' Mac OS applications under Windows
Under Windows, software written for the 'classic' Mac OS (i.e. versions 6 through 9) can only be run through software that emulates Macintosh hardware from 1980s and 1990s. The most advanced of these emulator programs is SheepShaver. SheepShaver is no longer supported by its original author, Gwenolé Beauchesne, but minor updates are available from an active support forum at E-Maculation.
This page provides a fully functional SheepShaver system that runs Mac OS 9.0.4 (US English version). Unlike other SheepShaver-based systems, it makes it relatively easy to exchange files between SheepShaver and Windows, and makes it easy to print from Mac OS applications to Windows printers, or to create PDF files on the Windows desktop. The system runs under Windows 7, 8.x and 10; it may work under earlier Windows versions, but I haven't tested it under earlier versions.
To install this system, download and run the MacOS9AppInstaller. (The file is around 400MB in size; it contains a 4GB hard disk image file.) Then launch the MacOS9.exe application, either from its folder or from the desktop shortcut that the installer offers to create.
Note: Updated 10 February 2021 with a new version of SheepShaver.
The program comes with an uninstaller. Every file installed or used by the program is inside the program's folder. After uninstalling, any files that may be left over will be in that same folder; those files and the folder itself may be safely deleted.
For a similar system that runs Mac OS 9 under OS X/macOS, see another page.
A similar system that runs System 7.6.1 in BasiliskII
I have created a similar system that runs Mac System 7.6.1 under BasiliskII. You may download its MacSys761Installer here. Run the installer and then launch the MacSys761.exe application, either from its folder or from a desktop shortcut that the installer offers to create.
The System 7 app works mostly in the same way that the MacOS9App works. You may copy files to System 7 desktop by dropping them on to the MacSys761.exe icon. And you may copy files to the Windows desktop by selecting them with the Copy to Host application or dropping them in to Send to Windows folder (both on the System 7 desktop).
Note: Updated 23 January 2021 with QuickTime Player added to the system.
How to use the MacOS9 app
I assume that you know something about Mac OS and don't need any advice from me. A few points are worth mentioning:
Depending on your Windows version, a Computer or This PC icon appears on the MacOS9 desktop. This icon leads to the drives on your host computer.
Mac Os Download For Windows
The File Transfer folder on the desktop is a convenience, to remind you that files found in the Computer or This PC folder should be copied into that folder (or any other folder in the MacOS9 disk image) before being used. They should not be copied merely to the desktop, because they almost certainly won't work until they are actually copied into the MacOS9 virtual disk. (When you copy a file from Windows to the MacOS9 desktop, the file itself is not copied to MacOS9 disk image; that is why you must copy it to a folder inside the disk image itself.)
Install Mac Os In Windows
The MacOS9 system includes a startup script named MacOS9StartUp. This script creates the necessary file-transfer folders for printing and exchanging files, and tests whether they are correct if they already exist. Please let it run without interference.
If you are confident that the file-transfer folders are working correctly, you can move the MacOS9StartUp script from the Startup Items folder in the System Folder to the Startup Items (Disabled) folder. Then move BackgroundScript from the Scripts folder in the System Folder to the Startup Items folder; shut down the MacOS9 app and start it again. If the file-transfer folders stop working, move the BackgroundScript out of the Startup Items folder and restore the MacOS9StartUp script to the Startup Items folder.
To transfer a file from Windows to MacOS9, drop it (in Windows) on MacOS9.exe or on the MacOS9 desktop shortcut. After a long pause, perhaps even longer than 30 seconds, a copy of the file should appear on the desktop of the MacOS9 disk. The original file remains in your Windows system.
To transfer a file to Windows from MacOS9, drop it on the 'Send to Windows' applet on the MacOS9 desktop. The file should be copied almost immediately to the Windows desktop. Or you may double-click on the 'Sent to Windows' applet and select a file to send to the Windows desktop.
To print from MacOS9 to your default Windows printer, simply use the File/Print menu in your MacOS9 application, and print with the default desktop printer, 'Print to Windows.' After a pause, the document should print to your default Windows printer.
To print from MacOS9 and select a Windows printer for the current print job, use the File/Print menu in your MacOS9 application, choose the desktop printer named 'Select Windows Printer', and print. After a pause, a popup list of Windows printers should appear; choose the one you want.
To create a PDF file in Windows when printing from MacOS9, use the File/Print menu in your MacOS9 application, choose the desktop printer named 'PDF to Windows Desktop', and print. The resulting PDF file on the Windows desktop will have an arbitrary name based on the current date and time.
To create a PDF file on the OS 9 desktop, use the File/Print menu in your MacOS9 application, choose the desktop printer named 'PDF to OS9 Desktop', and print. You will be prompted to enter a filename for the resulting PDF; an arbitrary filename will be offered based on the current date and time, but you can type over it to change it.
To print 'raw' PostScript data from MacOS9 to a PostScript-compatible Windows default printer, follow the printing instructions above, but choose the desktop printer named 'Raw PS to Win PS Printer. How to save a pic on mac. ' The raw PostScript data will be sent to your Windows default printer; if that printer is not PostScript-compatible, you may waste a lot of paper, so be careful with this option.
If SheepShaver locks up: While the MacOS9 app is running, a small Mac-like icon appears in your Windows system tray. You may click on this to open a menu that includes 'Force Quit.' You may click on this to shut down SheepShaver forcibly; you will be asked to confirm that you intend to do this. (SheepShaver is notably unstable, and liable to crash without warning, so this feature may be useful.)
You may use the supplied SheepShaverGUI app (in the Programs folder inside the MacOS9 folder) to modify the system, but the file transfer and printing features will only work if you launch the MacOS9 app from the MacOS9 desktop icon or the MacOS9.exe program inside the MacOS9 folder! If you launch SheepShaver from the SheepShaverGUI, you may get error messages about the file transfer system; if this occurs, shut down SheepShaver and relaunch the MacOS9 icon or MacOS9.exe program.
Troubleshooting: How to get adobe premiere pro from another mac. If the SheepShaverGUI app produces an error message when you first run it, double-click on GTKLocalInstaller.exe in the same folder. You will not see any feeback from the GTKLocalInstaller.exe program, but the SheepShaverGUI should now run. (Or you may need to logout and login again.)
To transfer files from a real Mac to SheepShaver, follow the instructions in this post on emaculation.com.
To add additional disk space to MacOS9: This system includes a 4GB disk image. If you need additional disk space, then visit this page at Macintosh Garden and download one of the provided disk images (I recommend the third download, with a 10GB disk image). Then follow these steps:
- Use something like the 7z file manager app to extract the downloaded disk image.
- Rename the extracted disk image to something like Second.dsk (for convenience, use the .dsk extension, whatever the original extension might be).
- Move the renamed disk image into the MacOS9Programs folder.
- Use Notepad or any text editor to edit the SheepShaver_prefs file in the same folder and add this line after the first line: disk Second.dsk (using whatever name you gave the to the disk image file).
- Save the SheepShaver_prefs file and restart MacOS9.
'Cannot map second Kernel Data' error: If, on your system, SheepShaver starts up with the error message 'Cannot map second Kernel Data area: 487', then go to the Programs folder inside the MacOS9 folder, rename SheepShaver.exe to SheepShaver-old.exe and rename SheepShaver-noJIT.exe to SheepShaver.exe. This alternate version will probably be slower, but should at least run. (This error message occurs unpredictably on some systems but not on others.)
Further details may be available later if you ask for them.
What the MacOS9 app contains
The MacOS9 application contains a standard US-English Mac OS 9 installation, without features that can't be used in this system, such as file-sharing. It also includes a large number of standard Mac OS applications, plus some Control Panels, Extensions, Scripting Additions, and a gray desktop image that you can easily change if you prefer.
The file transfer system uses two AppleScripts: either the MacOS9StartUp script or the BackgroundScript script described above. The MacOS9AppData folder uses an OS9Action folder action script found in the Scripts:Folder Action Scripts folder.
In the MacOS9 disk image, the Transfer folder alias and From Windows folder are required by the file-transfer system, as are the MacOS9AppData folder and the WinPath.txt file found in the System Folder.
The Transfer folder is an alias of the Windows folder named Transfer (inside the MacOS9 folder, typically in your user folder). In contrast, the File Transfer folder on the MacOS9 desktop is a mere convenience for use when copying files from the Computer or This PC folder.
Acknowledgments
This system is built on software provided by many people who are more expert than I am. The included build of SheepShaver was built by Ronald P. Regensburg and posted at the E-Maculation support forum for SheepShaver. The AppleScripts used in this application could not have been written without the help of many experts at Macscripter.net, and the AutoIt script that provides the launcher application could not have been written without the help of many experts in the forum at AutoItScript.com.
Support
Because part of this system is written in the AutoIt scripting language, some anti-virus programs will flag it as malware. Absolutely do not waste your extremely valuable time alerting me to this; do not waste your extremely valuable time writing me an e-mail asking if the software is safe. Do not take my word for it that this is all the result of a false positive. Upload the software to a site like VirusTotal.com for testing. If you do not trust my software, do not use my software.
To create a PDF file in Windows when printing from MacOS9, use the File/Print menu in your MacOS9 application, choose the desktop printer named 'PDF to Windows Desktop', and print. The resulting PDF file on the Windows desktop will have an arbitrary name based on the current date and time.
To create a PDF file on the OS 9 desktop, use the File/Print menu in your MacOS9 application, choose the desktop printer named 'PDF to OS9 Desktop', and print. You will be prompted to enter a filename for the resulting PDF; an arbitrary filename will be offered based on the current date and time, but you can type over it to change it.
To print 'raw' PostScript data from MacOS9 to a PostScript-compatible Windows default printer, follow the printing instructions above, but choose the desktop printer named 'Raw PS to Win PS Printer. How to save a pic on mac. ' The raw PostScript data will be sent to your Windows default printer; if that printer is not PostScript-compatible, you may waste a lot of paper, so be careful with this option.
If SheepShaver locks up: While the MacOS9 app is running, a small Mac-like icon appears in your Windows system tray. You may click on this to open a menu that includes 'Force Quit.' You may click on this to shut down SheepShaver forcibly; you will be asked to confirm that you intend to do this. (SheepShaver is notably unstable, and liable to crash without warning, so this feature may be useful.)
You may use the supplied SheepShaverGUI app (in the Programs folder inside the MacOS9 folder) to modify the system, but the file transfer and printing features will only work if you launch the MacOS9 app from the MacOS9 desktop icon or the MacOS9.exe program inside the MacOS9 folder! If you launch SheepShaver from the SheepShaverGUI, you may get error messages about the file transfer system; if this occurs, shut down SheepShaver and relaunch the MacOS9 icon or MacOS9.exe program.
Troubleshooting: How to get adobe premiere pro from another mac. If the SheepShaverGUI app produces an error message when you first run it, double-click on GTKLocalInstaller.exe in the same folder. You will not see any feeback from the GTKLocalInstaller.exe program, but the SheepShaverGUI should now run. (Or you may need to logout and login again.)
To transfer files from a real Mac to SheepShaver, follow the instructions in this post on emaculation.com.
To add additional disk space to MacOS9: This system includes a 4GB disk image. If you need additional disk space, then visit this page at Macintosh Garden and download one of the provided disk images (I recommend the third download, with a 10GB disk image). Then follow these steps:
- Use something like the 7z file manager app to extract the downloaded disk image.
- Rename the extracted disk image to something like Second.dsk (for convenience, use the .dsk extension, whatever the original extension might be).
- Move the renamed disk image into the MacOS9Programs folder.
- Use Notepad or any text editor to edit the SheepShaver_prefs file in the same folder and add this line after the first line: disk Second.dsk (using whatever name you gave the to the disk image file).
- Save the SheepShaver_prefs file and restart MacOS9.
'Cannot map second Kernel Data' error: If, on your system, SheepShaver starts up with the error message 'Cannot map second Kernel Data area: 487', then go to the Programs folder inside the MacOS9 folder, rename SheepShaver.exe to SheepShaver-old.exe and rename SheepShaver-noJIT.exe to SheepShaver.exe. This alternate version will probably be slower, but should at least run. (This error message occurs unpredictably on some systems but not on others.)
Further details may be available later if you ask for them.
What the MacOS9 app contains
The MacOS9 application contains a standard US-English Mac OS 9 installation, without features that can't be used in this system, such as file-sharing. It also includes a large number of standard Mac OS applications, plus some Control Panels, Extensions, Scripting Additions, and a gray desktop image that you can easily change if you prefer.
The file transfer system uses two AppleScripts: either the MacOS9StartUp script or the BackgroundScript script described above. The MacOS9AppData folder uses an OS9Action folder action script found in the Scripts:Folder Action Scripts folder.
In the MacOS9 disk image, the Transfer folder alias and From Windows folder are required by the file-transfer system, as are the MacOS9AppData folder and the WinPath.txt file found in the System Folder.
The Transfer folder is an alias of the Windows folder named Transfer (inside the MacOS9 folder, typically in your user folder). In contrast, the File Transfer folder on the MacOS9 desktop is a mere convenience for use when copying files from the Computer or This PC folder.
Acknowledgments
This system is built on software provided by many people who are more expert than I am. The included build of SheepShaver was built by Ronald P. Regensburg and posted at the E-Maculation support forum for SheepShaver. The AppleScripts used in this application could not have been written without the help of many experts at Macscripter.net, and the AutoIt script that provides the launcher application could not have been written without the help of many experts in the forum at AutoItScript.com.
Support
Because part of this system is written in the AutoIt scripting language, some anti-virus programs will flag it as malware. Absolutely do not waste your extremely valuable time alerting me to this; do not waste your extremely valuable time writing me an e-mail asking if the software is safe. Do not take my word for it that this is all the result of a false positive. Upload the software to a site like VirusTotal.com for testing. If you do not trust my software, do not use my software.
Please do not ask me to help you customize the 'classic' Mac OS or advise you about any applications. Please ask for support in the E-Maculation support forum for SheepShaver. If you want to get in touch with me about the AppleScript and AutoIt used in this system, then please visit this page.
Edward Mendelson (em thirty-six [at] columbia [dot] edu, but with two initials and two numerals before the [at] sign, not spelled out as shown here).
