To complete this tutorial you need:
- An Azure AD account with permissions to:
    - add an application to your Azure organization
    - grant permissions to ezeep Blue to read some profile information
    - grant permissions to have users authenticate via your Azure AD
    (This account is usually an administrator in your Azure AD.)
- A Windows Virtual Desktop instance
- An admin account to install software on the Windows Virtual Desktop instance
- A Windows PC/Server with at least one printer installed
- An admin account to install software on the Windows PC/Server


Overview of Steps

1. Sign up to ezeep Blue via the Azure Marketplace

2. Install the ezeep Blue Connector on a Windows PC/Server

3. Configure your ezeep Blue organization via the admin Portal

4. Install the ezeep Blue Print App on the Windows Virtual Desktop instance

5. Test it by printing from the Windows Virtual Desktop

Let's get started

1. Sign up to ezeep Blue via the Azure Marketplace

  1. Log in to your Azure portal, go to the Azure Marketplace and search for “ezeep Blue”
  2. Click on "Set up + subscribe" in the “ezeep Blue” card.
  3. From the dropdown that opens, select the plan "Pay as you go / Free for 30 days"
    Note: The plan "Pay as you go / Free for 30 days" provides 30 days without charges, making it the preferred plan for trying out ezeep Blue.
    screenshot: ezeep Blue in Azure marketplace
  4. Select your Subscription and Resource group and provide a name for the offer and click on "Review + subscribe" at the bottom of the page.
    Note: A name with a space or other special characters in it will lead to a problem in the next step.
    screenshot: ezeep Blue in Azure marketplace
  5. Click on "Subscribe" at the bottom of the page
    screenshot: ezeep Blue in Azure marketplace
  6. After a few seconds, the subscription is completed on the Azure side. Now it is time to sign up with ezeep Blue. Click on "Configure account now"
    screenshot: ezeep Blue in Azure marketplace
  7. You will be directed to the ezeep Blue Sign-up portal. Fill out the required fields and click on Create Account.
    screenshot: ezeep Blue signup via Azure Marketplace
  8. When prompted, log in with your organization’s Azure admin account.  The account used in this step will become your ezeep Blue administrator.
  9. Consent on behalf of your organization and click on "Accept"
    screenshot: Azure permissions for ezeep Blue
  10. Click on "Microsoft" when presented with the ezeep Blue login page and log in with the Azure account you used so far.
    screenshot: sign in to ezeep portal
  11. During login you will be asked to allow ezeep Blue to read certain properties from your Azure AD. Check "Consent on behalf of your organization" and accept the request.
    screenshot: Azure permissions for ezeep Blue
  12. After your ezeep Blue account is created, you will automatically be logged in to your ezeep Blue admin portal.
screenshot: ezeep Blue admin Portal


2. Install the ezeep Blue Connector on a Windows PC/Server

The ezeep Blue Connector connects any printer to your ezeep Blue organization. The ezeep Blue Connector is available as software that can be installed on a Windows PC/Server and as part of the ezeep Hub appliance. In this tutorial, you are going to install the ezeep Blue Connector software on a Windows PC/Server.


  1. Log in to your PC/Server that has at least one printer installed. 
  2. Download the ezeep Blue Connector for Print Servers from here.
  3. Run the setup as an administrator and follow the prompts
    screenshot: ezeep Connector for Print Server installer
  4. After clicking on “Finish” the sign-in page will open in the default web browser. Select "Microsoft" and enter the Azure credentials you used to sign up for ezeep Blue.
    screenshot: Sign in to ezeep Blue from ezeep Connector for Print Server
  5. When you see the message "Login Successful" you can close the browser/tab.
    screenshot: sign in successful message
    The ezeep Blue Connector for Print Server is now installed and reports all installed printers with their printer properties to your ezeep Blue organization. Should you install additional printers or make changes to your printers, it will detect the changes and update your ezeep Blue organization automatically.

Note: If there are many printers installed, wait a couple of minutes before continuing with this tutorial so that the ezeep Blue Connector for Print Server has enough time to report the printers to your ezeep Blue organization. 


3. Configure your ezeep Blue organization via the admin Portal

Next, we want to assign printers to user groups so that the ezeep Blue Print App can create these printers for the users in their Windows Virtual Desktop sessions.

  1. Log In to the ezeep Blue admin portal by going to https://app.ezeep.com, clicking on "Microsoft" and logging in with your Azure credentials.
  2. In the menu on the left, click on "Users & Groups" and select the "Groups" tab.
    screenshot: Users & Groups in ezeep Blue admin portal
  3. Click on "Add Group" and select "Import Azure AD Group"
    screenshot: Add Group in ezeep Blue admin portal
  4. Select the Azure AD group(s) that contain your Windows Virtual Desktop users and click "Import"
    screenshot: add Azure groups in ezeep Blue admin portal
  5. The selected groups will be listed. Click on the pencil icon on the right for the group to which you want to assign printer(s).
  6. Select the "Printers" tab and select the printer(s) members of this group should see in their Windows Virtual Desktop session. Click "Done" to save your selection.
    screenshot: assign printers in ezeep Blue admin portal

4. Install the ezeep Blue Print App on the Windows Virtual Desktop instance

Now that your printers are connected with your ezeep Blue organization via the ezeep Blue Connector for Print Server and assigned to a user group via the ezeep Blue admin portal, it is time to install the ezeep Blue Print App on your Windows Virtual Desktop instance.
Note: For information on automatic deployment of the ezeep Blue Print App, have a look here.

  1. Log in to your Windows Virtual Desktop instance as administrator
  2. Download the ezeep Blue Print App from here.
  3. Run the installer as administrator and follow the prompts.
    screenshot: ezeep Print App installer
  4. During the last step of the installation process, your web browser will start and open the ezeep Blue login page. You can close it if you don't want to have ezeep Blue printers created for your admin account or log in by selecting Microsoft and providing your Azure AD credentials
    screenshot: ezeep Blue Sign in from ezeep Print App
  5. Click on "Finish" to close the installer and allow the the Windows Virtual Desktop instance to reboot when prompted.


5. Test it by printing from the Windows Virtual Desktop

Lastly, verify that printers are being created for your Windows Virtual Desktop users by ezeep Blue and that they can print.

  1. Log in to your Windows Virtual Desktop instance as a user.
  2. Upon first login, the Internet Explorer will open and ask the user to sign in to ezeep Blue. This will only happen once per user. Select "Microsoft" and provide Azure AD credentials for the user account you want to test printing with. Make sure that this user is a member of the group to which you had assigned printers earlier.
  3. Wait a couple of seconds to allow the ezeep Blue Print App to create the printers you had assigned to the group of this user before opening an App like notepad.
  4. Open the Print dialog of the App and look for the assigned printers. You can identify them by "(s#)" at the end of the printer name with # representing the session id.
    screenshot: printing with ezeep Blue from Notepad
  5. Select one of the ezeep Blue printers and click "Print". Within a few seconds your printer should start warming up and printing.