Printer.Create
Allows the application to create (register) printers on behalf of the signed-in user.
Permission Details
Register printers
Allows the application to create (register) printers on behalf of the signed-in user.
90c30bed-6fd1-4279-bf39-714069619721
Properties
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 |
BooleanNullable |
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 |
DateTimeOffsetNullable |
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 |
StringNullable |
The manufacturer reported by the printer. Inherited from printerBase. |
model |
StringNullable |
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
JSON representation is shown from stable Microsoft Graph v1.0 metadata.
{
"@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
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
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
| Methods |
|---|
GET
/print/operations/{id}
|
GET
/print/services
|
GET
/print/services/{id}
|
GET
/print/services/{id}/endpoints
|
GET
/print/services/{id}/endpoints/{name}
|
POST
/print/printers/create
|
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
// 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.Operations["{printOperation-id}"].GetAsync();
const options = {
authProvider,
};
const client = Client.init(options);
let printOperation = await client.api('/print/operations/{printOperationId}')
.get();
Import-Module Microsoft.Graph.Devices.CloudPrint
Get-MgPrintOperation -PrintOperationId $printOperationId
# 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.operations.by_print_operation_id('printOperation-id').get()
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Delegated permissions and search for Printer.Create
Grant Admin Consent
This delegated permission requires admin consent.