打印机资源类型
命名空间:microsoft.graph
重要
Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示已在通用打印服务中注册的打印机设备。 打印机资源可用于管理打印作业、打印机设置、打印机元数据和注册状态。
该资源支持:
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| Create | printerCreateOperation | 创建 (通用) 新打印机进行注册。 |
| Get | 打印机 | 读取打印机对象的属性和关系。 |
| 更新 | 打印机 | 更新打印机对象。 |
| 删除 | 无 | 从通用打印服务中注销物理打印机。 |
| restoreFactoryDefaults | 无 | 将打印机的默认设置还原到制造商指定的值。 |
| 列出作业 | printJob 集合 | 获取已排队等待打印机处理的打印作业的列表。 |
| 创建作业 | printJob | 为打印机创建新的打印作业。 若要开始打印作业 ,请使用start 。 |
| List connectors | printConnector 集合 | 获取与此打印机关联的连接器列表。 |
| List taskTriggers | 无 | 列出与此打印机关联的 printTaskTrigger。 |
| Create taskTrigger | printTaskTrigger | 创建在打印事件发生时运行的 printTaskTrigger。 |
| Delete taskTrigger | 无 | 删除与打印机关联的 printTaskTrigger。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 打印机的标识符。 只读。 |
| displayName | String | 打印机的名称。 |
| manufacturer | String | 打印机报告的制造商。 |
| model | String | 打印机报告的型号名称。 |
| registeredDateTime | DateTimeOffset | 注册打印机时的日期时间Offset。 只读。 |
| 状态 | printerStatus | 打印机的处理状态,包括任何错误。 |
| isShared | Boolean | 如果共享打印机,则其为 True;否则为 false。 只读。 |
| hasPhysicalDevice | Boolean | 如此 如果打印机具有用于打印的物理设备。 只读。 |
| isAcceptingJobs | Boolean | 打印机当前是否接受新的打印作业。 |
| 位置 | printerLocation | 打印机的物理和/或组织位置。 |
| defaults | printerDefaults | 打印机的默认打印设置。 |
| capabilities | printerCapabilities | 打印机的功能。 |
| lastSeenDateTime | DateTimeOffset | 打印机与通用打印交互时的最新 dateTimeOffset。 只读。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| jobs | printJob 集合 | 由打印机排入打印队列的作业列表。 |
| shares | printerShare 集合 | printerShares 与打印机关联的列表。 目前,只有一个 printerShare 可以与打印机关联。 只读。 可为 NULL。 |
| 连接器 | printConnector | 与打印机关联的连接器。 |
| taskTriggers | printTaskTrigger 集合 | 与打印机关联的任务触发器列表。 |
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"id": "String (identifier)",
"displayName": "String",
"manufacturer": "String",
"model": "String",
"isShared": true,
"registeredDateTime": "String (timestamp)",
"isAcceptingJobs": true,
"hasPhysicalDevice": true,
"location": {"@odata.type": "microsoft.graph.printerLocation"},
"status": {"@odata.type": "microsoft.graph.printerStatus"},
"defaults": {"@odata.type": "microsoft.graph.printerDefaults"},
"capabilities": {"@odata.type": "microsoft.graph.printerCapabilities"},
"lastSeenDateTime": "String (timestamp)"
}
反馈
提交和查看相关反馈