命名空间:microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。
表示已向通用打印服务注册的打印机设备。 打印机资源可用于管理打印作业、打印机设置、打印机元数据和注册状态。 继承自 printerBase。
此资源支持 订阅更改通知。
方法
| 方法 | 返回类型 | 说明 |
|---|---|---|
| 创建 | printerCreateOperation | 使用通用打印) 新打印机创建 (寄存器。 |
| Get | 打印机 | 读取打印机对象的属性和关系。 |
| 更新 | 打印机 | 更新打印机对象。 |
| 删除 | 无 | 从通用打印服务注销物理打印机。 |
| 恢复出厂默认设置 | 无 | 将打印机的默认设置还原为制造商指定的值。 |
| 列出打印作业 | printJob 集合 | 获取打印机排队等待处理的打印作业列表。 |
| 创建打印作业 | printJob | 为打印机创建新的打印作业。 若要开始打印作业,请使用开始。 |
| List connectors | printConnector 集合 | 获取与此打印机关联的连接器列表。 |
| 列出任务触发器 | 无 | 列出与此打印机关联 的 printTaskTriggers 。 |
| 创建任务触发器 | printTaskTrigger | 创建在打印事件发生时运行的 printTaskTrigger 。 |
| 删除任务触发器 | 无 | 删除与打印机关联的 printTaskTrigger 。 |
| 列出拉取打印打印机 | pullPrintPrinter 集合 | 获取打印机所属的 pullPrintPrinter 对象。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| capabilities | printerCapabilities | 打印机的功能。 继承自 printerBase。 |
| defaults | printerDefaults | 打印机的默认打印设置。 继承自 printerBase。 |
| displayName | String | 打印机的名称。 继承自 printerBase。 |
| hasPhysicalDevice | 布尔值 | 如果打印机具有用于打印的物理设备,则为 true。 只读。 |
| id | String | 打印机的标识符。 只读。 |
| isAcceptingJobs | 布尔值 | 如果 ,打印机 true当前正在接受新的打印作业。 继承自 printerBase。 |
| isShared | Boolean | 如果打印机是共享的,则为 true;否则为 false。 只读。 |
| lastSeenDateTime | DateTimeOffset | 打印机与通用打印交互时的最近 dateTimeOffset。 只读。 |
| 位置 | printerLocation | 打印机的物理和/或组织位置。 继承自 printerBase。 |
| manufacturer | String | 打印机报告的制造商。 继承自 printerBase。 |
| model | String | 打印机报告的型号名称。 继承自 printerBase。 |
| printerProvidedReleaseSupport | printerProvidedReleaseSupport | 物理打印机报告为受支持的安全发布功能。 只读。 |
| registeredDateTime | DateTimeOffset | 注册打印机时的 DateTimeOffset。 只读。 |
| status | printerStatus | 打印机的处理状态,包括任何错误。 继承自 printerBase。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| 连接器 | printConnector | 与打印机关联的连接器。 |
| jobs | printJob 集合 | 打印机排队等待打印的作业列表。 |
| pullPrintPrinters | pullPrintPrinter 集合 | 此打印机所属的拉取打印打印机。 |
| shares | printerShare 集合 | 与打印机关联的 printerShare 的列表。 目前,只能有一个 printerShare 与打印机关联。 只读。 可为 Null。 |
| 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)",
"printerProvidedReleaseSupport": {"@odata.type": "microsoft.graph.printerProvidedReleaseSupport"}
}