printerShare 资源类型
命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示可供用户和打印应用程序发现的打印机。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | printerShare 集合 | 获取租户中的打印机共享列表。 |
| Get | printerShare | 读取 printerShare 对象的属性和关系。 |
| 更新 | printerShare | 更新 printerShare 对象。 |
| 删除 | None | 取消共享打印机。 |
| 列出作业 | printJob 集合 | 获取由 printerShare 排队等待处理的打印作业的列表。 |
| 为打印机共享创建作业 | printJob | 为 printerShare 创建新的打印作业。 若要开始打印作业，请使用 start。 |
| 列出允许的用户 | user 集合 | 检索有权将打印作业提交到关联的打印机共享的用户的列表。 |
| 创建允许的用户 | None | 向指定的用户授予将打印作业提交到关联的打印机共享的权限。 |
| 删除允许的用户 | None | 从指定用户撤消打印机共享访问权限。 |
| 列出允许的组 | group 集合 | 检索已被授予将打印作业提交到关联的打印机共享的访问权限的组列表。 |
| 创建允许的组 | None | 向指定的组授予将打印作业提交到关联的打印机共享的权限。 |
| 删除允许的组 | None | 从指定组撤消打印机共享访问权限。 |
| 列出最近共享 | printerShare 集合 | 获取已登录用户最近使用的 printerShares 的列表。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| allowAllUsers | 布尔值 | 如果为 true，则向所有用户和组授予对此打印机共享的访问权限。 这将取代 allowedUsers 和 allowedGroups 导航属性定义的允许列表。 |
| capabilities | printerCapabilities | 与此打印机共享关联的打印机的功能。 |
| createdDateTime | DateTimeOffset | 创建打印机共享时的 DateTimeOffset。 此为只读属性。 |
| defaults | printerDefaults | 与此打印机共享关联的打印机的默认打印设置。 |
| displayName | String | 打印客户端应显示的打印机共享的名称。 |
| id | String | printerShare 的标识符。 此为只读属性。 |
| isAcceptingJobs | 布尔值 | 与此打印机共享关联的打印机当前是否接受新的打印作业。 |
| 位置 | printerLocation | 与此打印机关联的打印机的物理和/或组织位置共享。 |
| manufacturer | String | 与此打印机共享关联的打印机报告的制造商。 此为只读属性。 |
| model | String | 与此打印机共享关联的打印机报告的型号名称。 此为只读属性。 |
| status | printerStatus | 与此打印机共享关联的打印机的处理状态，包括任何错误。 此为只读属性。 |
| 观点 | printerShareViewpoint | 已登录用户查看的打印机共享的其他数据。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| allowedGroups | 组 | 用户有权使用打印机进行打印的组。 |
| allowedUsers | user 集合 | 有权使用打印机进行打印的用户。 |
| jobs | printJob 集合 | 由与此打印机共享关联的打印机排队打印的作业列表。 |
| 打印机 | 打印机 | 此打印机共享的相关打印机。 |
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"}
}