Printer.FullControl.All

Allows the application to create (register), read, update, and delete (unregister) printers on behalf of the signed-in user.

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 Printer.FullControl.All 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	-	93dae4bd-43a1-4a23-9a1a-92957e1d9121
DisplayText	-	Register, read, update, and unregister printers
Description	-	Allows the application to create (register), read, update, and delete (unregister) printers on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

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

	Methods
	DELETE /print/printers/{printerId}
	DELETE /print/printers/{printerId}/taskTriggers/{printTaskTriggerId}
	GET /print/operations/{printOperationId}
	GET /print/printers
	GET /print/printers/{id}
	GET /print/printers/{printerId}/taskTriggers
	GET /print/printers/{printerId}/taskTriggers/{printTaskTriggerId}
	GET /print/shares/{id}/printer
	PATCH /print/printers/{printerId}
	POST /print/printers/{printerId}/restoreFactoryDefaults
	POST /print/printers/{printerId}/taskTriggers
	POST /print/printers/create

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

	Methods
	DELETE /print/printers/{id}
	DELETE /print/printers/{id}/taskTriggers/{id}
	GET /print/operations/{id}
	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/shares/{id}/printer
	PATCH /print/printers/{id}
	POST /print/printers/{id}/restoreFactoryDefaults
	POST /print/printers/{id}/taskTriggers
	POST /print/printers/create

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

	Commands
	Get-MgPrintOperation
	Get-MgPrintPrinter
	Get-MgPrintPrinterTaskTrigger
	New-MgPrintPrinter
	New-MgPrintPrinterTaskTrigger
	Remove-MgPrintPrinter
	Remove-MgPrintPrinterTaskTrigger
	Restore-MgPrintPrinterFactoryDefault
	Update-MgPrintPrinter

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

	Commands
	Get-MgBetaPrintOperation
	Get-MgBetaPrintPrinter
	Get-MgBetaPrintPrinterCapability
	Get-MgBetaPrintPrinterTaskTrigger
	New-MgBetaPrintPrinter
	New-MgBetaPrintPrinterTaskTrigger
	Remove-MgBetaPrintPrinter
	Remove-MgBetaPrintPrinterTaskTrigger
	Restore-MgBetaPrintPrinterFactoryDefault
	Update-MgBetaPrintPrinter

Resources

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

Graph reference: printCertificateSigningRequest

Property	Type	Description
content	String	A base64-encoded pkcs10 certificate request. Read-only.
transportKey	String	The base64-encoded public portion of an asymmetric key that is generated by the client. 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: printerCapabilities

Property	Type	Description
bottomMargins	Int32 collection	A list of supported bottom margins(in microns) for the printer.
collation	Boolean	True if the printer supports collating when printing muliple copies of a multi-page document; false otherwise.
colorModes	printColorMode collection	The color modes supported by the printer. Valid values are described in the following table.
contentTypes	String collection	A list of supported content (MIME) types that the printer supports. It is not guaranteed that the Universal Print service supports printing all of these MIME types.
copiesPerJob	integerRange	The range of copies per job supported by the printer.
dpis	Int32 collection	The list of print resolutions in DPI that are supported by the printer.
duplexModes	printDuplexMode collection	The list of duplex modes that are supported by the printer. Valid values are described in the following table.
feedOrientations	printerFeedOrientation collection	The list of feed orientations that are supported by the printer.
finishings	printFinishing collection	Finishing processes the printer supports for a printed document.
inputBins	String collection	Supported input bins for the printer.
isColorPrintingSupported	Boolean	True if color printing is supported by the printer; false otherwise. Read-only.
isPageRangeSupported	Boolean	True if the printer supports printing by page ranges; false otherwise.
leftMargins	Int32 collection	A list of supported left margins(in microns) for the printer.
mediaColors	String collection	The media (i.e., paper) colors supported by the printer.
mediaSizes	String collection	The media sizes supported by the printer. Supports standard size names for ISO and ANSI media sizes. Valid values are in the following table.
mediaTypes	String collection	The media types supported by the printer.
multipageLayouts	printMultipageLayout collection	The presentation directions supported by the printer. Supported values are described in the following table.
orientations	printOrientation collection	The print orientations supported by the printer. Valid values are described in the following table.
outputBins	String collection	The printer's supported output bins (trays).
pagesPerSheet	Int32 collection	Supported number of Input Pages to impose upon a single Impression.
qualities	printQuality collection	The print qualities supported by the printer.
queueBufferSizeInBytes	Int32	The maximum print job queue size that can be stored by the printer.
rightMargins	Int32 collection	A list of supported right margins(in microns) for the printer.
scalings	printScaling collection	Supported print scalings.
supportsFitPdfToPage	Boolean	True if the printer supports scaling PDF pages to match the print media size; false otherwise.
topMargins	Int32 collection	A list of supported top margins(in microns) for the printer.

Graph reference: printerCreateOperation

Property	Type	Description
certificate	String	The signed certificate created during the registration process. Read-only.
createdDateTime	DateTimeOffset	The DateTimeOffset when the operation was created. Read-only.
id	String	The operation's identifier. Read-only.
status	printOperationStatus	The status of the registration operation. Contains the operation's progress and whether it completed successfully. Read-only.

Graph reference: printerDefaults

Property	Type	Description
colorMode	printColorMode	The default color mode to use when printing the document. Valid values are described in the following table.
contentType	String	The default content (MIME) type to use when processing documents.
copiesPerJob	Int32	The default number of copies printed per job.
dpi	Int32	The default resolution in DPI to use when printing the job.
duplexMode	printDuplexMode	The default duplex (double-sided) configuration to use when printing a document. Valid values are described in the following table.
finishings	printFinishing collection	The default set of finishings to apply to print jobs. Valid values are described in the following table.
fitPdfToPage	Boolean	The default fitPdfToPage setting. True to fit each page of a PDF document to a physical sheet of media; false to let the printer decide how to lay out impressions.
inputBin	String	The default input bin that serves as the paper source.
mediaColor	String	The default media (such as paper) color to print the document on.
mediaSize	String	The default media size to use. Supports standard size names for ISO and ANSI media sizes. Valid values are listed in the printerCapabilities topic.
mediaType	String	The default media (such as paper) type to print the document on.
multipageLayout	printMultipageLayout	The default direction to lay out pages when multiple pages are being printed per sheet. Valid values are described in the following table.
orientation	printOrientation	The default orientation to use when printing the document. Valid values are described in the following table.
outputBin	String	The default output bin to place completed prints into. See the printer's capabilities for a list of supported output bins.
pagesPerSheet	Int32	The default number of document pages to print on each sheet.
quality	printQuality	The default quality to use when printing the document. Valid values are described in the following table.
scaling	printScaling	Specifies how the printer scales the document data to fit the requested media. Valid values are described in the following table.

Graph reference: printerLocation

Property	Type	Description
altitudeInMeters	Int32	The altitude, in meters, that the printer is located at.
building	String	The building that the printer is located in.
city	String	The city that the printer is located in.
countryOrRegion	String	The country or region that the printer is located in.
floor	String	The floor that the printer is located on. Only numerical values are supported right now.
floorDescription	String	The description of the floor that the printer is located on.
latitude	Double	The latitude that the printer is located at.
longitude	Double	The longitude that the printer is located at.
organization	String collection	The organizational hierarchy that the printer belongs to. The elements should be in hierarchical order.
postalCode	String	The postal code that the printer is located in.
roomDescription	String	The description of the room that the printer is located in.
roomName	String	The room that the printer is located in. Only numerical values are supported right now.
site	String	The site that the printer is located in.
stateOrProvince	String	The state or province that the printer is located in.
streetAddress	String	The street address where the printer is located.
subdivision	String collection	The subdivision that the printer is located in. The elements should be in hierarchical order.
subUnit	String collection	The subunit hierarchy where the printer is located. The elements should be in hierarchical order. For example, if a campus is divided into different sections, the hierarchy might look like this: `["East Wing", "Block A"]`

Graph reference: printerStatus

Property	Type	Description
description	String	A human-readable description of the printer's current processing state. Read-only.
details	printerProcessingStateDetail collection	The list of details describing why the printer is in the current state. Valid values are described in the following table. Read-only.
state	printerProcessingState	The current processing state. Valid values are described in the following table. Read-only.

Graph reference: printOperation

Property	Type	Description
createdDateTime	DateTimeOffset	The DateTimeOffset when the operation was created. Read-only.
id	String	The operation's identifier. Read-only.
status	printOperationStatus	The status of the operation. Read-only.

Graph reference: printTaskDefinition

Property	Type	Description
createdBy	appIdentity	The application that created the printTaskDefinition. Read-only.
displayName	String	The name of the printTaskDefinition.
id	String	The printTaskDefinition's identifier. Read-only.

Graph reference: printTaskTrigger

Property	Type	Description
event	printEvent	The Universal Print event that causes a new printTask to be triggered. Valid values are described in the following table.
id	String	The printTaskTrigger's identifier. Read-only.

Table of Contents

Printer.FullControl.All

Graph Methods

Resources