PrintJob.ReadWriteBasic

Allows the application to read and update the metadata of print jobs that the signed-in user created. Does not allow access to print job document content.

In this to PrintJob.ReadWriteBasic, the app requires at least the Printer.Read.All (or a more prviliged permission) because print jobs are stored within printers.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the PrintJob.ReadWriteBasic permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	-	6f2d22f2-1cb6-412c-a17c-3336817eaa82
DisplayText	-	Read and write basic information of user's print jobs
Description	-	Allows the application to read and update the metadata of print jobs that the signed-in user created. Does not allow access to print job document content.
AdminConsentRequired	Yes	No

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /print/printers/{id}/jobs/{id}
	GET /print/printers/{printerId}/jobs
	GET /print/services
	GET /print/services/{printServiceId}
	GET /print/services/{printServiceId}/endpoints
	GET /print/services/{printServiceId}/endpoints/{printServiceEndpointId}
	GET /print/shares/{printerShareId}/jobs
	POST /print/printers/{printerId}/jobs
	POST /print/printers/{printerId}/jobs/{printJobId}/cancel
	POST /print/shares/{printerShareId}/jobs
	POST /print/shares/{printerShareId}/jobs/{printJobId}/start

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /print/printers/{id}/jobs
	GET /print/printers/{id}/jobs/{id}
	GET /print/services
	GET /print/services/{id}
	GET /print/services/{id}/endpoints
	GET /print/services/{id}/endpoints/{name}
	GET /print/shares/{id}/jobs
	POST /print/printers/{id}/jobs/{id}/cancel
	POST /print/shares/{id}/jobs/{id}/start
	POST print/printers/{id}/jobs
	POST print/shares/{id}/jobs

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgPrintPrinterJob
	Get-MgPrintService
	Get-MgPrintServiceEndpoint
	Get-MgPrintShareJob
	New-MgPrintPrinterJob
	New-MgPrintShareJob
	Start-MgPrintShareJob
	Stop-MgPrintPrinterJob

→ Command supports delegated access (access on behalf of a user)
→ Command supports app-only access (access without a user)

	Commands
	Get-MgBetaPrintPrinterJob
	Get-MgBetaPrintService
	Get-MgBetaPrintServiceEndpoint
	Get-MgBetaPrintShareJob
	New-MgBetaPrintPrinterJob
	New-MgBetaPrintShareJob
	Start-MgBetaPrintShareJob
	Stop-MgBetaPrintPrinterJob

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: printDocument

Property	Type	Description
contentType	String	The document's content (MIME) type. Read-only.
displayName	String	The document's name. Read-only.
id	String	The document's identifier. Read-only.
size	Int64	The document's size in bytes. Read-only.
uploadedDateTime	DateTimeOffset	The time the document was uploaded. Read-only
downloadedDateTime	DateTimeOffset	The time the document was downloaded. Read-only

Graph reference: printer

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	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	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	The manufacturer reported by the printer. Inherited from printerBase.
model	String	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.

Graph reference: printerShare

Property	Type	Description
allowAllUsers	Boolean	If true, all users and groups will be granted access to this printer share. This supersedes the allow lists defined by the allowedUsers and allowedGroups navigation properties.
capabilities	printerCapabilities	The capabilities of the printer associated with this printer share. Inherited from printerBase.
createdDateTime	DateTimeOffset	The DateTimeOffset when the printer share was created. Read-only.
defaults	printerDefaults	The default print settings of the printer associated with this printer share. Inherited from printerBase.
displayName	String	The name of the printer share that print clients should display. Inherited from printerBase.
id	String	The printerShare's identifier. Inherited from printerBase. Read-only.
isAcceptingJobs	Boolean	Whether the printer associated with this printer share is currently accepting new print jobs. Inherited from printerBase.
location	printerLocation	The physical and/or organizational location of the printer associated with this printer share. Inherited from printerBase.
manufacturer	String	The manufacturer reported by the printer associated with this printer share. Inherited from printerBase. Read-only.
model	String	The model name reported by the printer associated with this printer share. Inherited from printerBase. Read-only.
status	printerStatus	The processing status, including any errors, of the printer associated with this printer share.Inherited from printerBase. Read-only.
viewPoint	printerShareViewpoint	Additional data for a printer share as viewed by the signed-in user.

Graph reference: printJob

Property	Type	Description
configuration	printJobConfiguration	A group of settings that a printer should use to print a job.
createdBy	userIdentity	Read-only. Nullable.
createdDateTime	DateTimeOffset	The DateTimeOffset when the job was created. Read-only.
id	String	The ID of the print job. Read-only.
isFetchable	Edm.Boolean	If true, document can be fetched by printer.
redirectedFrom	Edm.String	Contains the source job URL, if the job has been redirected from another printer.
redirectedTo	Edm.String	Contains the destination job URL, if the job has been redirected to another printer.
status	printJobStatus	The status of the print job. Read-only.
errorCode	Int32	The error code of the print job. Read-only.
acknowledgedDateTime	DateTimeOffset	The dateTimeOffset when the job was acknowledged. Read-only.

Graph reference: printJobStatus

Property	Type	Description
description	String	A human-readable description of the print job's current processing state. Read-only.
details	printJobProcessingDetail collection	Additional details for print job state. Valid values are described in the following table. Read-only.
isAcquiredByPrinter	Boolean	True if the job was acknowledged by a printer; false otherwise. Read-only.
state	printJobProcessingState	The print job's current processing state. Valid values are described in the following table. Read-only.

Property	Type	Description
id	String	The identifier of the service. Read-only.

Graph reference: printServiceEndpoint

Property	Type	Description
displayName	String	A human-readable display name for the endpoint.
id	String	A unique name that identifies the service that the endpoint provides. Possible values are: `discovery` (Discovery Service), `notification` (Notification Service), `ipp` (IPP Service), and `registration` (Registration Service). Read-only.
uri	String	The URI that can be used to access the service.

Graph reference: printTask

Property	Type	Description
id	String	The printTask's identifier. Read-only.
status	printTaskStatus	The current execution status of this printTask. The calling application is responsible for updating this status when processing is finished, unless the related printJob has been redirected to another printer. Failure to report completion will result in the related print job being blocked from printing and eventually deleted.
parentUrl	String	The URL for the print entity that triggered this task. For example, `https://graph.microsoft.com/v1.0/print/printers/{printerId}/jobs/{jobId}`. Read-only.

Table of Contents

PrintJob.ReadWriteBasic

Graph Methods

Resources