打印机资源类型

命名空间: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)"
}