命名空间:microsoft.graph
更新 pullPrintPrinter 对象的属性。
权限
为此 API 选择标记为最低特权的权限。 只有在应用需要它时,才使用更高的特权权限。 有关委派权限和应用程序权限的详细信息,请参阅权限类型。 要了解有关这些权限的详细信息,请参阅 权限参考。
| 权限类型 | 最小特权权限 | 更高特权权限 |
|---|---|---|
| 委派(工作或学校帐户) | PullPrintPrinter.ReadWrite.All | PullPrintPrinter.FullControl.All |
| 委派(个人 Microsoft 帐户) | 不支持。 | 不支持。 |
| 应用程序 | 不支持。 | 不支持。 |
重要
对于使用工作或学校帐户的委派访问权限,登录用户必须在租户范围内分配到受支持的 Microsoft Entra 角色。 打印机管理员 是此操作支持的最低特权角色。
HTTP 请求
PATCH /print/pullPrintPrinters/{pullPrintPrinterId}
请求标头
| 名称 | 说明 |
|---|---|
| Authorization | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| Content-Type | application/json. 必需。 |
请求正文
在请求正文中, 仅 提供要更新的属性的值。 请求正文中未包含的现有属性会保留其以前的值,或者会根据其他属性值的更改重新计算。
下表指定可更新的属性。
只能更新 默认值、 includeAllPrinters 和 位置 。
| 属性 | 类型 | 说明 |
|---|---|---|
| defaults | printerDefaults | 拉式打印打印机的默认打印设置。 继承自 printerBase。 可选。 |
| includeAllPrinters | 布尔值 | 指示租户中的每个打印机是否自动成为此拉取打印打印机的成员。 如果 true,则不需要显式管理 打印机 集合。 可选。 |
| 位置 | printerLocation | 拉取打印打印机的组织位置。 只能更新 printerLocation 属性的子集: building、 city、 countryOrRegion、 floor、 floorDescription、 organization、 roomDescription、 roomName、 site、 stateOrProvince 和 subdivision。 无法使用此方法更新其他 printerLocation 属性。 可选。 |
响应
如果成功,此方法将在响应正文中返回 200 OK 响应代码和更新的 pullPrintPrinter 对象。
示例
请求
以下示例显示了一个请求。
PATCH https://graph.microsoft.com/v1.0/print/pullPrintPrinters/15037699-acf2-2dbb-b20c-897053051345
Content-Type: application/json
{
"includeAllPrinters": true
}
响应
以下示例显示了相应的响应。
注意:为了提高可读性,可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.pullPrintPrinter",
"id": "15037699-acf2-2dbb-b20c-897053051345",
"displayName": "Contoso Pull Print - Building 5",
"registeredDateTime": "2026-08-03T18:00:05Z",
"includeAllPrinters": true
}