次の方法で共有


printerShare を更新する

名前空間: microsoft.graph

プリンター共有のプロパティを更新します。 このメソッドは、 プリンターの交換に使用できます。

たとえば、物理プリンター デバイスが切断された場合、管理者は新しい プリンター デバイスを登録し、この プリンターを 更新できますShare ユーザーが何も操作しなくても、新しいプリンターをポイントするように共有します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校のアカウント) PrinterShare.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション サポートされていません。 サポートされていません。

HTTP 要求

PATCH /print/shares/{printerShareId}

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、更新する必要がある関連 する printerShare フィールドの値を指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。 最適なパフォーマンスを得るために、変更されていない既存の値を含めないでください。

次のプロパティを更新できます。

プロパティ 説明
プリンタ microsoft.graph.printer このプリンター共有が関連しているプリンター。 次の printer@odata.bind 例に示すように構文を使用して、このプリンター共有が関連付けられているプリンターを更新します。
displayName String 印刷クライアントが表示するプリンター共有の名前。
allowAllUsers ブール型 true の場合、すべてのユーザーとグループにこのプリンター共有へのアクセス権が付与されます。 これにより、allowedUsers ナビゲーション プロパティと allowedGroups ナビゲーション プロパティによって定義された許可リストが優先されます。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された printerShare オブジェクトを返します。

要求

PATCH https://graph.microsoft.com/v1.0/print/shares/{printerShareId}
Content-Type: application/json

{
  "displayName": "PrinterShare Name",
  "printer@odata.bind": "https://graph.microsoft.com/v1.0/print/printers/{printerId}",
  "allowAllUsers": false
}

応答

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/shares/$entity",
  "id": "d837c17b-3296-4384-a053-828d56e10f50",
  "displayName": "PrinterShare Name",
  "createdDateTime": "2020-02-04T00:00:00.0000000Z",
  "isAcceptingJobs": true,
  "allowAllUsers": false,
  "status": {
    "state": "stopped",
    "details": ["disconnected"],
    "description": ""
  }
}