Universal Print troubleshooting guide

This article provides steps to troubleshoot and resolve Universal Print issues.

Issues covered in this article

Admin is unable to access Universal Print on the Azure Portal

If you receive a '403' error accessing the Universal Print portal, check the following:

  1. Verify that the Admin's user account is assigned the Global Administrator or the Printer Administrator role in Azure Active Directory.
  2. Verify that the Admin's user account is assigned a license that contains a Universal Print license. See Universal Print license assignment for details. For M365 customers, Universal Print is part of the Windows 10 Enterprise license.

If you receive a '500', '503' or '504' error, check to see that you are not experiencing any network issues accessing the Azure portal. Check here for any notifications of an outage. If you are still seeing the issue, open a Support case via the Azure Support portal.

Configuring and registering printers

A printer on the connector does not show up in the connector app

Only printers that are local to the PC running the Connector will be visible to be registered. Printers that are installed as network Point and Print printers or use a PORTPROMPT: port will be bypassed during enumeration.

  1. Verify that the physical print device is installed locally on the connector PC and is not a printer shared from another PC including a print server.

  2. Check the print connector event log for events indicating why a specific printer was skipped and not made available to register. The event will have the text "Skipping printer" along with the printer name and reason it was skipped.

Admin is unable to register a printer

For Universal Print Native printers:

  1. Verify that you are using an account that has Global Administrator rights if this is the first printer being registered. Most IHVs have an app that is installed into Azure that assists the printers with registering as AAD-joined devices. Installing the app will require the Global Administrator role. Subsequent printers will be able to be registered using the Print Administrator or Print Technician roles.
  2. Verify that the printer can access the Internet and is not blocked by firewall or proxy settings.
  3. Check to see if the printer has been previously registered, and is still seen as Registered in the Universal Print portal or under Azure AD Devices.
  4. If you are still unable to register a printer that supports Universal Print natively, contact the printer IHV for assistance.

For Printers using a Microsoft Universal Print Connector

  1. Verify that you are not trying to register a printer queue for a physical print device that has already been registered.
  2. Go through the connector troubleshooting checklist.
  3. Verify that user account is assigned a Universal Print license and one of the administrator roles - Global Administrator, Print Administrator, or Print Technician. See Universal Print license assignment.
  4. Verify that the Connector PC can access the Internet and is not blocked by firewall or proxy settings.
  5. Verify that the connector PC can access Azure Active Directory. See steps below.

For Printers using a Third Party Connector

  1. Verify that the printer is not listed as Registered in Universal Print or Azure AD Devices.
  2. Check with the ISV for the Connector for additional support.

Troubleshooting 3rd party solutions

Please do the following before contacting Microsoft support:

  1. Please contact the solution provider regarding their solution's support for Universal Print. Some solution providers have updated versions of their offerings that support Universal Print.
  2. Please let the Universal Print team know about this so we could investigate why the 3rd party functionality doesn't work with Universal Print. You can do so by posting in the "Discussions" section at https://aka.ms/UPCommunity.

Registered printer shows as Available in Print Connector App

If the printer is deleted from AAD Devices, it will be unregistered on the Connector. However, it will still show as "Registered" in the Universal Print portal. If you look in the Print Connector Event log, you will see errors for the printer:

  • Printer <printerid> has been deregistered from cloud. Deleting local data.
  • Got DeregisteredDeviceException for printer <printerid>.
  • Token request failed for printer <printerid>: System.Net.WebException: The remote server returned an error: (400) Bad Request.

Attempts to re-register the printer fail with "device already exists" error in the Print Connector Event log.

To address this issue, you will need to unshare and unregister the printer in the Universal Print portal, and then re-register the printer from the Print Connector App.

If you wish to retain the Universal Print share endpoint, use the steps here to retain the printer share endpoint.

Printer brought back online still shows as "Stopped" in Azure Portal and "Attention Required" on clients

Printers sometimes need to be taken offline for maintenance, and when they are brought back online they may still show as Stopped in the Azure Portal, and as Attention Required on users' devices. To resolve this:

  1. Open the printer's queue on the Connector host machine by selecting the printer in the "Printers & scanners" page of the Windows "Settings" app, then click "Open queue".
  2. Go to the "Printer" menu, toggle the "Pause Printing" option on, and then toggle it off again (you many also need to click the "Open As Administrator" option first). This will cause the Connector to recognize that the printer is online again and it will update the Portal and users' devices.

Discover and Install printer on Client

User is unable to discover any Universal Print printer

When the user clicks "Add a printer or scanner" in the "Devices" section in the Windows "Settings" app, no Universal Print printers are discovered.

  1. Verify that the user's PC is connected to Azure Active Directory. See steps below.

  2. Verify that the user has been assigned a Universal Print license: See Universal Print license assignment.

  3. Verify that the user is not still part of a Hybrid Cloud Print (HCP) deployment:

    • Check for and delete the following registry key:

      Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\PolicyManager\current\<SID>\EnterpriseCloudPrint

    Important

    If this key was set using a policy (e.g. using Microsoft Endpoint Manager), it will be recreated automatically the next time the policy is applied.

  4. Verify that the user does not have multiple Work Accounts configured:

    1. In the Windows "Settings" app, click on "Accounts" > "Access work or school".
    2. If the PC is joined to Azure Active Directory, remove all additional Work and School accounts.
    3. If the PC is not joined to Azure Active Directory and there's more than 1 account, remove all except the account for the organization that has the printer the user is trying to discover.
  5. Verify that the user has access rights to the printer share:

    1. Navigate to "Printers" in the Azure Portal.
    2. Click on any printer to which the user should have access.
    3. Verify that the "Printer Share Name" has a value (i.e. the printer is shared).
    4. In the left hand pane, click "Access Control".
    5. Verify that the user is listed as a member of the printer share. If not, add the user by clicking the "Add" button.
  6. Verify that the user can access the Microsoft Graph:

    • Check if access to the Internet in general, and *.print.microsoft.com specifically, are blocked by network firewall settings, or if a winhttp proxy is required. Use the netsh winhttp set proxy ipaddress:port command to configure the proxy settings on the client.
    • Using Fiddler on the user's PC (see running a Fiddler trace ), verify that there are no errors accessing https://graph.print.microsoft.com. The most common error is 403.

User is unable to discover a specific Universal Print printer

When the user clicks "Add a printer or scanner" in the "Devices" section in the Windows "Settings" app, some Universal Print printers are discovered, but a certain printer is not in that list.

  1. Verify that the user has access rights to the printer share for that printer:

    1. Navigate to "Printers" in the Azure Portal.
    2. Click on the printer that the user is trying to discover.
    3. Verify that the "Printer Share Name" has a value (i.e. the printer is shared).
    4. In the left hand pane, click "Access Control".
    5. Verify that the user is listed as a member of the printer share. If not, add the user by clicking the "Add" button.
  2. Verify location settings:

    If the printer is still not in the list of discovered printers, that could be caused by the fact that Windows shows the first 10 printers discovered from Universal Print in the order of their proximity to the user. If the printer location properties are not set, or if the Windows location service on the user's PC is not configured, the printer might not be automatically discovered for the user.

    Please see Manage printer location settings to learn more about Universal Print printer location configuration.

    Please see How to control location settings to learn more about configuring Windows 10 location service.

  3. Search for the printer manually:

    After the printer is not discovered in the automatic search, click Search for printers in my organization or Search Universal Print for printers (depending on your version of Windows, one of these 2 links will be there) and search for the desired printer manually. You could also click the search location link on that page and browse the organization's building hierarchy for the desired printer.

Printer options are not available or selected printer options are not reflected in printed output

  1. Verify that the printer options were set for the printer on the connector PC.

  2. Delete and re-install the printer on the user's PC in case the printer installation did not download the settings when the printer was installed.

  3. See "Diagnosing missing printer options" to determine if some options were dropped because they are not supported by Universal Print.

  4. Check for the latest driver available from your printer's manufacturer. If there are multiple drivers available for your printer model, we recommend using the following in order of preference:

Verifying that a PC is connected to Azure Active Directory

  • Run dsregcmd /status /verbose /debug and verify that one of the following configurations are true:

    Device State - AzureAdJoined : YES
    and
    SSO State - AzureAdPrt : YES

    or

    User State - WorkplaceJoined : YES

Printer shows as Offline on the user PC

  1. Verify that the printer is online on connector PC:

    • Print a test page to the printer from the connector PC.
  2. Go through the connector troubleshooting checklist.

Printer not installed via End Point Management

Check the troubleshooting section of the End Point Management page here.

User is prompted with credential dialog when discovering printers

Windows pops up a user credential dialog prompt after clicking on the "Add a printer or scanner" button to search for printers. After entering user credentials, it errors out with error message

Request Id: <GUID> Correlation Id: <GUID> Timestamp: <Date and Time> Message: AADSTS50020: User account '<account>' from identity provider 'live.com' does not exist in tenant 'Microsoft Services' and cannot access the application '<GUID>'(Universal Print Native Client) in that tenant. The account needs to be added as an external user in the tenant first. Sign out and sign in again with a different Azure Active Directory user account.

Verify the user credentials entered is an account in the Azure AD tenant which is using Universal Print.

A print job does not complete successfully

  1. Verify that the user PC sent the print job to Universal Print:

    • Open the printer queue on the user PC and check if the job is still in the queue with one of the status Sending to Printer or Error-Sending to printer.

      If the user PC is unable to send the job Universal Print, this could be cause by a firewall or network security blocking access to *.print.microsoft.com. Verify that there are no errors accessing "print.print.microsoft.com" by running a Fiddler trace on the user's PC.

  2. Verify that the job appears in the printer jobs on the Azure Portal:

    1. Navigate to Printers in the Azure Portal.
    2. Click on the target printer.
    3. On the left-hand pane, click "Job", and look for the user's job. Successful jobs show their status as "Completed".

    A job status of Stopped, Aborted, or Pending means that the job was not successfully sent to the target printer. Continue with the next steps to troubleshoot issues on the connector and target printer.

  3. Verify that the target printer installed on the connector is a physical print device and not a logical printer that belongs to a 3rd party solution:

    If the target printer is a logical printer that is part of a 3rd party solution, please see Troubleshooting 3rd party solutions.

  4. Verify that the target printer is working by printing a test page to that printer from the connector PC.

  5. Verify that there are no print job failures on the connector:

    1. Verify that you have installed the latest printer driver for the target printer on the connector and try the print job again.

      Important

      To update the printer driver on the connector, follow the steps at "How to change the printer's driver on Universal Print connector?".

    2. Check the print connector event log for job failure errors. Job failure errors have the error code XPS_JOB_FAILED in the event details. You can match the "UP Job Id" from the event details to the "Id" in the printer's "Jobs" section in the Azure Portal.

  6. Verify that the printer name on the connector was not changed:

    If the printer driver was updated, the printer name may have changed.

    1. Rename the printer back to the original name.
    2. Unregister the old printer and register the new printer.

The print job username is 'System'

This is expected behavior when using the Universal Print connector. The connector runs as the local system account on the PC where it is installed. Therefore, a print job submitted to the Windows print spooler by the connector is submitted by the system account.

Some features of 3rd party print management solutions, that don't yet have support for Universal Print, rely on the username of the user who submitted the print job to be reported to the Windows print spooler. These features are intended for Windows Print Server. They don't work as-is with Universal Print.

If you have such a 3rd party solution, please see Troubleshooting 3rd party solutions.

Additionally, if your environment meets the pre-requisites, you can enable support for Hybrid AD/AAD configuration in the Universal Print connector. This will cause the connector to impersonate AD domain identity of the user who submitted the print job and, therefore, the print job username will be that user's username.

Printer status error on user PC or Azure Portal

  1. Verify that the printer is healthy by printing a test page to that printer from the connector PC where it is locally installed.

  2. Verify that the connector is healthy by going through the connector troubleshooting checklist.

  3. Verify that the connector is able to send printer status to Universal Print by ensuring that there is no firewall rule or network security policy blocking the connector from communicating with Azure. Check the print connector event log for errors containing the text "Unable to connect to the remote server".

  4. If the printer status in the Azure Portal is not "Ready" click on the printer and see the "Printer Status Reasons" in the printer's "Overview" section.

"Unsupported document format: application/pdf" error

This error means that the target printer does not support receiving print jobs in the PDF format. This usually occurs when an application is using the Graph API to send a PDF print job to the printer.

If the target printer is connected to Universal Print through a connector, you can follow these steps to enable the connector to convert the PDF document into the XPS format that is supported by connector-attached printers:

Note

This feature is currently in pre-release. We want to hear your feedback. Please report any issues at https://aka.ms/UPCommunity.

  1. Download and install the latest Universal Print connector.

  2. Enable PDF-to-XPS conversion on the connector:

    1. Start an elevated PowerShell prompt on the connector PC.
    2. Run the following command to enable conversion (this will also restart the connector service).
    C:\Windows\PrintConnectorSvc\UpdateConnectorConfigJson.ps1 -Feature Connector -Name enable-pdftoxps -Value true
    
  3. Verify that conversion is enabled for the target printer:

    1. Go to the Universal Print portal.
    2. In the navigation pane, click on Printers.
    3. In the list of printers, click on the target printer.
    4. In the navigation pane, click on Printer properties.
    5. Click on the Printer defaults tab.
    6. In the Content type dropdown list, verify that both application/pdf and application/xps are listed.

Universal Print Connector service

Admin cannot remove a connector from Universal Print on the Azure Portal

See How to remove a Universal Print connector.

Connector troubleshooting checklist

  1. Verify that the connector prerequisites are met.

  2. Verify that the following Windows services are running:

    • Print Connector service (PrintConnectorSvc.exe)
    • Spooler (Spoolsv.exe)
  3. Verify that the latest version of the connector is installed:

    1. Download the latest connector installer.
    2. Compare the version in the file name to the version on title bar (top-left corner) of the connector app when you run it. The first 3 parts of the version (i.e. 1.3.7) must match.
  4. Confirm that the Connector PC has access to the Internet as outlined here.

  5. Check the print connector event log for errors.

Check the print connector event log

  1. Right-click the Start button and click Run.

  2. Run the following to open the event viewer directly to the connector channel.

    eventvwr /c:Microsoft-Windows-PrintConnector/Operational

Events to look for:

Event 22 - Notification that a job is waiting.

Event 25 - Print of job ID started.

Event 10 - Print job sent to Spooler.

Event 26 - AD - Hybrid configuration - Impersonation succeeded.

Event 27 - AD - Hybrid configuration - Impersonation failed. See Troubleshooting AD Hybrid.

Event 9 - Merge Ticket failure. This occurs when there is a mismatch between the options supported by the print driver on the Connector and the IPP Specification as outlined here - Supported Print Options. To view the specifics, follow the troubleshooting steps here. For known issues regarding merge tickets errors, you can find them here.

Connector service crashing or "wcf endpoint is not listening"

When starting the Print Connector app, you see an error that the wcf endpoint is not listening. You may also see that the Print Connector is crashing on startup. This indicates that there may be a conflict accessing port 8091.

To confirm there is a conflict:

  1. Check to see if the Print Connector service is running. If it is, stop the service.

  2. Open a command prompt and run netstat -a.

  3. Check for Active connection using port 8091. Ex. 0.0.0.0:8091.

  4. If another process is using the port, use the following steps to change the port being used by the Connector.

  5. Identify a port that is not being used. (For this example, we will use port 8095).

  6. In an elevated Powershell window, run the following commands to change the port:

net stop "print connector service"
net stop printconnectorupdatersvc
reg add HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\UniversalPrint\Connector /v ServicePort /d 8095 /F
net start "print connector service"
net start printconnectorupdatersvc
  1. To verify port is listening on the new port, open a browser and go to the following URL: http://localhost:8095/WindowsServiceHostedService/PrinterConnectorService.

You should see a web page with a title: ProxyWCF Service

License Management

Universal Print license assignment

From the Microsoft 365 admin center

  1. Sign in to the "Licenses" section in the Microsoft 365 Admin Center.
  2. Click on the license that includes Universal Print as outlined here.
  3. Verify that the user's name is in the list of users assigned a license. If not, assign the user a license by clicking on the "Assign licenses" button.

From the Azure Portal

  1. Verify that the usage location is set for the user:
    1. Navigate to "Users | All users".
    2. Click on the user to whom you want to assign a license.
    3. In the the user Profile, find the Settings section and ensure that the Usage location property is assigned a value. If it is empty, click Edit, choose a usage location, and then click Save.
  2. Navigate to the "Licenses | All products" in the Azure Portal.
  3. Click on the license that includes Universal Print as outlined here.
  4. Verify that the user's name is in the list of users assigned a Universal Print license. If not, assign the user a license by clicking on the "Assign" button.

Useful troubleshooting tasks

Verifying PC is connected to Azure Active Directory

  • Run dsregcmd /status /verbose /debug and verify that one of the following configurations are true:

    Device State - AzureAdJoined : YES
    and
    SSO State - AzureAdPrt : YES

    or

    User State - WorkplaceJoined : YES

Running a Fiddler trace

  1. Download and open Fiddler.

  2. Verify that Fiddler isn't capturing traffic. Select File and make sure Capture Traffic isn't checked.

  3. Select WinConfig button, then select Exempt All, and then select Save Changes.

  4. Select Tools, and then select Options.

  5. Select the HTTPS tab.

  6. Select Decrypt HTTPS traffic and select yes for the certification prompts.

  7. Open elevated command prompt and run the following command:

    netsh winhttp set proxy 127.0.0.1:8888

  8. Enable capturing traffic. Select File, then select Capture Traffic.

  9. Reproduce the problem.

  10. Save and review the trace file.

  11. Once you have finished with Fiddler, open elevated command prompt and do the following command:

    netsh winhttp reset proxy

Running a Browser Trace

Investigating any Portal issue, it is probably a good idea to capture:

  1. Name and version of the web browser.
  2. Web logs (from the browser) for the page that reported the issue.

To collect web logs, we recommend using the web browsers' developer tools. Dev tools can be found under "More Tools" in the browser menu or using a short-cut Ctrl+Shift+I or F12.

Here are the steps to collect the log:

  1. Launch the browser and open dev tools (using Ctrl+Shift+I or F12).
  2. In developer tools, click on "Network" tab.
  3. If issue is across multiple pages, click on the "Preserve log" checkbox.
  4. Open or refresh the web page which was having issue. You can also reproduce the portal operation at this point (e.g. sharing a printer).
  5. Once the page has loaded and you can notice the problem, click on "Export HAR file".
  6. Save the file locally on your device.

Re-register a printer while retaining the printer share endpoint

  1. On the Connector system, create a new Dummy printer.
    1. Create "test" folder in the C:\ drive.
    2. Control Panel – Devices and Printers.
    3. Add Printer.
    4. Click "The printer I want isn't listed".
    5. Select "Add a local printer or network printer with manual settings." Click Next.
      1. Select "Create a new port:".
      2. Type of port: "Local Port".
      3. Click Next.
      4. Enter a port name: "C:\test\dummyprint.prn".
      5. Click OK.
      6. Select a driver (this printer won't be used, so any driver will work). Click Next.
      7. Printer Name: "Dummy Printer". Click Next.
      8. Select "Do not share this printer". Click Next.
      9. Click Finish.
    6. Open the Print queue for the "Dummy Printer" and set it to "Paused". (This will prevent jobs that are sent to the printer from being printed until we have completed the operation. Note that the first job pending in the portal for the printer may be lost and need to be re-sent.)
  2. Open Print Connector App and register the new "Dummy Printer" with Universal Print.
  3. Go to the Universal Print Portal.
  4. Go to the Printer Shares blade.
  5. Go to the Printer Share for the printer that needs to be re-registered.
  6. Click "Swap printer".
  7. The new "Dummy Printer" should be listed as an option. Select the "Dummy Printer" and click "Swap".
  8. Go back to the Printer's properties in the Portal and select "Unregister".
  9. On the Connector, open the Print Connector App and select the printer from the "Available" list and register the printer.
  10. Once it is registered, go back to the Printer Share in the Universal Print portal and select "Swap printer". Select the newly re-registered printer and click "Swap".

The print share should now be pointed to the newly re-registered printer.

See also