Copy and paste to a Windows virtual machine: Azure Bastion

This article helps you copy and paste text to and from virtual machines when using Azure Bastion.

Prerequisites

Before you proceed, make sure you have the following items.

  • A VNet with Azure Bastion deployed.
  • A Windows VM deployed to your VNet.

Configure the bastion host

By default, Azure Bastion is automatically enabled to allow copy and paste for all sessions connected through the bastion resource. You don't need to configure anything additional. This applies to both the Basic and the Standard SKU tier. If you want to disable this feature, you can disable it for web-based clients on the configuration page of your Bastion resource.

  1. To view or change your configuration, in the portal, go to your Bastion resource.

  2. Go to the Configuration page.

    • To enable, select the Copy and paste checkbox if it isn't already selected.
    • To disable, clear the checkbox. Disable is only available with the Standard SKU. You can upgrade the SKU if necessary.
  3. Apply changes. The bastion host will update.

    Screenshot that shows the configuration page.

Copy and paste

For browsers that support the advanced Clipboard API access, you can copy and paste text between your local device and the remote session in the same way you copy and paste between applications on your local device. For other browsers, you can use the Bastion clipboard access tool palette.

Note

Only text copy/paste is currently supported.

Advanced Clipboard API browsers

  1. Connect to your VM.

  2. For direct copy and paste, your browser may prompt you for clipboard access when the Bastion session is being initialized. Allow the web page to access the clipboard.

    Screenshot that shows allow clipboard access.

  3. You can now use keyboard shortcuts as usual to copy and paste. If you're working from a Mac, the keyboard shortcut to paste is SHIFT-CTRL-V.

Non-advanced Clipboard API browsers

To copy text from your local computer to a VM, use the following steps.

  1. Connect to your VM.

  2. Copy the text/content from the local device into your local clipboard.

  3. On the VM, launch the Bastion clipboard access tool palette by selecting the two arrows. The arrows are located on the left center of the session.

    Screenshot that shows the launch arrows for the clipboard access tool palette.

  4. Copy the text from your local computer. Typically, the copied text automatically shows on the Bastion clipboard access tool palette. If doesn't show up on the tool palette, then paste the text in the text area on the tool palette. Once the text is in the text area, you can paste it to the remote session. In this example, we copied text to the Bastion clipboard tool palette, then pasted it to the VM Notepad app.

    Screenshot shows a clipboard for text copied in Bastion.

  5. If you want to copy the text from the VM to your local computer, copy the text to the clipboard access tool. Once your text is in the text area on the palette, paste it to your local computer.

Next steps

For more VM features, see About VM connections and features.