printerShare 资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

表示可由用户和打印应用程序发现的打印机。

方法

方法 返回类型 Description
List printerShare 集合 获取租户中打印机共享的列表。
Get printerShare 读取 printerShare 对象的属性和关系。
更新 printerShare 更新 printerShare 对象。
删除 无 取消共享打印机。
列出作业 printJob 集合 获取排队等待 printerShare 处理的打印作业列表。
为打印机共享创建作业 printJob 为 printerShare 创建新的打印作业。 若要开始打印作业,请使用开始。
列出允许的用户 user 集合 检索可将打印作业提交到关联打印机共享的用户列表。
创建允许的用户 无 授予指定用户将打印作业提交到关联打印机共享的访问权限。
删除允许的用户 无 撤销指定用户的打印机共享访问权限。
列出允许的组 group 集合 检索组的列表,其成员可以将打印作业提交到关联的打印机共享。
创建允许的组 无 授予指定组将打印作业提交到关联打印机共享的访问权限。
删除允许的组 无 撤销指定组的打印机共享访问权限。
列出最近使用的共享 printerShare 集合 获取登录用户最近使用的 printerShares 的列表。
获取拉取打印打印机 pullPrintPrinter 获取与 printerShare 关联的 pullPrintPrinter。

属性

属性 类型 说明
allowAllUsers 布尔值 如果为 true,则所有用户和组都可以访问此打印机共享。 此属性取代 allowedUsers 和 allowedGroups 导航属性定义的允许用户和组的列表。
capabilities printerCapabilities 与此打印机共享的打印机的功能。 继承自 printerBase。
createdDateTime DateTimeOffset 创建打印机共享时的 DateTimeOffset。 只读。
defaults printerDefaults 与此打印机共享关联的打印机的默认打印设置。 继承自 printerBase。
displayName String 打印客户端应显示的打印机共享的名称。 继承自 printerBase。
holdJobsForSecureRelease 布尔值 指示发送到此打印机共享的打印作业是否保留在云中,直到用户在打印机上释放它们。
id String printerShare 的标识符。 只读。
isAcceptingJobs 布尔值 与此打印机共享关联的打印机当前是否接受新的打印作业。 继承自 printerBase。
位置 printerLocation 与此打印机共享关联的打印机的物理和/或组织位置。 继承自 printerBase。
manufacturer String 与此打印机共享相关联的打印机报告的制造商。 只读。 继承自 printerBase。
model String 与此打印机共享关联的打印机报告的型号名称。 只读。
status printerStatus 与此打印机共享关联的打印机的处理状态,包括任何错误。 只读。 继承自 printerBase。
viewPoint printerShareViewpoint 打印机共享的登录用户查看的更多数据。

关系

关系 类型 说明
allowedGroups group 集合 用户有权使用打印机进行打印的组。
allowedUsers user 集合 有权使用打印机进行打印的用户。
jobs printJob 集合 排队等待打印的作业列表,由与此打印机共享关联的打印机执行打印。
打印机 打印机 与此打印机共享关联的打印机。
pullPrintPrinter pullPrintPrinter 与此打印机共享相关联的拉取打印打印机。

JSON 表示形式

以下 JSON 表示形式显示资源类型。

{
  "allowAllUsers": "Boolean",
  "capabilities": {"@odata.type": "microsoft.graph.printerCapabilities"},
  "createdDateTime": "String (timestamp)",
  "defaults": {"@odata.type": "microsoft.graph.printerDefaults"},
  "displayName": "String",
  "id": "String (identifier)",
  "isAcceptingJobs": "Boolean",
  "location": {"@odata.type": "microsoft.graph.printerLocation"},
  "manufacturer": "String",
  "model": "String",
  "status": {"@odata.type": "microsoft.graph.printerStatus"},
  "viewPoint": {"@odata.type": "microsoft.graph.printerShareViewpoint"},
  "holdJobsForSecureRelease": "Boolean"
}