Printer.Read.All | Graph Permissions

Permission Details

Application Permission

Read printers

Allows the application to read printers without a signed-in user.

Permission ID: 9709bb33-4549-49d4-8ed9-a8f65e45bb0f

Delegated Permission

Read printers

Allows the application to read printers on behalf of the signed-in user.

Permission ID: 3a736c8a-018e-460a-b60c-863b2683e8bf

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`capabilities`	`printerCapabilities`	The capabilities of the printer associated with this printer share. Inherited from printerBase.
`defaults`	`printerDefaults`	The printer's default print settings. Inherited from printerBase.
`displayName`	`String`	The name of the printer. Inherited from printerBase.
`hasPhysicalDevice`	`Boolean`	True if the printer has a physical device for printing. Read-only.
`id`	`String`	The document's identifier. Inherited from printerBase. Read-only.
`isAcceptingJobs`	`Boolean`Nullable	True if the printer is currently accepting new print jobs. Inherited from printerBase.
`isShared`	`Boolean`	True if the printer is shared; false otherwise. Read-only.
`lastSeenDateTime`	`DateTimeOffset`Nullable	The most recent dateTimeOffset when a printer interacted with Universal Print. Read-only.
`location`	`printerLocation`	The physical and/or organizational location of the printer. Inherited from printerBase.
`manufacturer`	`String`Nullable	The manufacturer reported by the printer. Inherited from printerBase.
`model`	`String`Nullable	The model name reported by the printer. Inherited from printerBase.
`registeredDateTime`	`DateTimeOffset`	The DateTimeOffset when the printer was registered. Read-only.
`status`	`printerStatus`	The processing status of the printer, including any errors. Inherited from printerBase.
`connectors`	`printConnector collection`	The connectors that are associated with the printer.
`jobs`	`printJob collection`	The list of jobs that are queued for printing by the printer/printerShare.

Showing 15 of 17 properties.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "@odata.type": "#microsoft.graph.printer",
  "id": "String (identifier)",
  "displayName": "String",
  "manufacturer": "String",
  "model": "String",
  "isAcceptingJobs": "Boolean",
  "defaults": {
    "@odata.type": "microsoft.graph.printerDefaults"
  },
  "location": {
    "@odata.type": "microsoft.graph.printerLocation"
  },
  "capabilities": {
    "@odata.type": "microsoft.graph.printerCapabilities"
  },
  "status": {
    "@odata.type": "microsoft.graph.printerStatus"
  },
  "registeredDateTime": "String (timestamp)",
  "isShared": "Boolean",
  "hasPhysicalDevice": "Boolean",
  "lastSeenDateTime": "String (timestamp)"
}

Relationships

Microsoft Graph v1.0 exact-category-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`connectors`	`printConnector`	The connectors that are associated with the printer.
`jobs`	`printJob collection`	The list of jobs that the printer queues for printing. Inherited from printerBase.
`shares`	`printerShare collection`	The list of printerShares that are associated with the printer. Currently, only one printerShare can be associated with the printer. Read-only. Nullable.
`taskTriggers`	`printTaskTrigger collection`	A list of task triggers that are associated with the printer.
`status`	`printerStatus`	Related status data exposed by this resource.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/print/printers`
GET `/print/printers/{id}`
GET `/print/printers/{printerId}/taskTriggers`
GET `/print/printers/{printerId}/taskTriggers/{printTaskTriggerId}`
GET `/print/services`
GET `/print/services/{printServiceId}`
GET `/print/services/{printServiceId}/endpoints`
GET `/print/services/{printServiceId}/endpoints/{printServiceEndpointId}`
GET `/print/shares/{id}/printer`

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
GET `/print/printers`
GET `/print/printers/{id}`
GET `/print/printers/{id}/getCapabilities`
GET `/print/printers/{id}/taskTriggers`
GET `/print/printers/{id}/taskTriggers/{id}`
GET `/print/services`
GET `/print/services/{id}`
GET `/print/services/{id}/endpoints`
GET `/print/services/{id}/endpoints/{name}`
GET `/print/shares/{id}/printer`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgPrintPrinter` /print/printers List printers
`Get-MgPrintPrinter` /print/printers/{id} Get printer
`Get-MgPrintPrinterTaskTrigger` /print/printers/{printerId}/taskTriggers List taskTriggers
`Get-MgPrintPrinterTaskTrigger` /print/printers/{printerId}/taskTriggers/{printTaskTriggerId} Get printTaskTrigger
`Get-MgPrintService` /print/services List printServices
`Get-MgPrintService` /print/services/{printServiceId} Get printService
`Get-MgPrintServiceEndpoint` /print/services/{printServiceId}/endpoints List endpoints
`Get-MgPrintServiceEndpoint` /print/services/{printServiceId}/endpoints/{printServiceEndpointId} Get printServiceEndpoint

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`Get-MgBetaPrintPrinter` /print/printers List printers
`Get-MgBetaPrintPrinter` /print/printers/{id} Get printer
`Get-MgBetaPrintPrinterCapability` /print/printers/{id}/getCapabilities printer: getCapabilities
`Get-MgBetaPrintPrinterTaskTrigger` /print/printers/{id}/taskTriggers List taskTriggers
`Get-MgBetaPrintPrinterTaskTrigger` /print/printers/{id}/taskTriggers/{id} Get taskTrigger
`Get-MgBetaPrintService` /print/services List printServices
`Get-MgBetaPrintService` /print/services/{id} Get printService
`Get-MgBetaPrintServiceEndpoint` /print/services/{id}/endpoints List printServiceEndpoints
`Get-MgBetaPrintServiceEndpoint` /print/services/{id}/endpoints/{name} Get printServiceEndpoint

Code Examples

C# / .NET SDK

Get printer

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Print.Printers["{printer-id}"].GetAsync();

JavaScript

Get printer

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

let printer = await client.api('/print/printers/{printerId}')
	.get();

PowerShell

Get printer

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Devices.CloudPrint

Get-MgPrintPrinter -PrinterId $printerId

Python

Get printer

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.print.printers.by_printer_id('printer-id').get()

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for Printer.Read.All

4

Grant Admin Consent

Application permissions always require admin consent.