名前空間: microsoft.graph
pullPrintPrinter オブジェクトのプロパティを更新します。
アクセス許可
この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。
| アクセス許可の種類 | 最小特権アクセス許可 | より高い特権のアクセス許可 |
|---|---|---|
| 委任 (職場または学校のアカウント) | PullPrintPrinter.ReadWrite.All | PullPrintPrinter.FullControl.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 | サポートされていません。 |
| アプリケーション | サポートされていません。 | サポートされていません。 |
重要
職場または学校アカウントを使用してアクセスを委任するには、サインインしたユーザーに、サポートされている Microsoft Entra ロールへのテナント全体の割り当てが必要です。 プリンター管理者 は、この操作でサポートされる最小特権ロールです。
HTTP 要求
PATCH /print/pullPrintPrinters/{pullPrintPrinterId}
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
| Content-Type | application/json. 必須です。 |
要求本文
リクエストの本文には、更新するプロパティの値 のみ を指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。
次の表に、更新できるプロパティを示します。
更新できるのは、 defaults、 includeAllPrinters、 場所 のみです。
| プロパティ | 型 | 説明 |
|---|---|---|
| 既定 | 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
}