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