打印机资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示已注册到通用打印服务的打印机设备。 打印机资源可用于管理打印作业、打印机设置、打印机元数据和注册状态。
该资源支持：
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建 | printerCreateOperation | Create (使用通用打印) 新打印机注册。 |
| Get | 打印机 | 读取打印机对象的属性和关系。 |
| 更新 | 打印机 | 更新打印机对象。 |
| 删除 | 无 | 从通用打印服务中注销物理打印机。 |
| 还原工厂默认值 | 无 | 将打印机的默认设置还原到制造商指定的值。 |
| 列出打印作业 | printJob 集合 | 获取打印机排队等待处理的打印作业的列表。 |
| Create打印作业 | printJob | Create打印机的新打印作业。 若要开始打印作业，请使用 start。 |
| List connectors | printConnector 集合 | 获取与此打印机关联的连接器列表。 |
| 列出任务触发器 | 无 | 列出与此打印机关联的 printTaskTriggers 。 |
| Create任务触发器 | printTaskTrigger | Create打印事件发生时运行的 printTaskTrigger。 |
| 删除任务触发器 | 无 | 删除与打印机关联的 printTaskTrigger 。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 打印机的标识符。 只读。 |
| displayName | String | 打印机的名称。 |
| manufacturer | String | 打印机报告的制造商。 |
| model | String | 打印机报告的型号名称。 |
| registeredDateTime | DateTimeOffset | 注册打印机时的 DateTimeOffset。 此为只读属性。 |
| status | printerStatus | 打印机的处理状态，包括任何错误。 |
| isShared | Boolean | 如果打印机是共享的，则为 True;否则为 false。 此为只读属性。 |
| hasPhysicalDevice | 布尔值 | 如果打印机具有用于打印的物理设备，则该属性值为 True。 此为只读属性。 |
| isAcceptingJobs | 布尔值 | 如果 true为 ，则打印机当前正在接受新的打印作业。 |
| 位置 | 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)"
}