Drucker aktualisieren

Namespace: microsoft.graph

Aktualisieren sie die Eigenschaften eines Druckerobjekts .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	❌

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	Printer.ReadWrite.All	Printer.FullControl.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	Printer.ReadWrite.All	Nicht verfügbar.

Hinweis: Derzeit können nur Drucker, die nicht über physische Geräte verfügen, mithilfe von Anwendungsberechtigungen aktualisiert werden.

HTTP-Anforderung

PATCH /print/printers/{printerId}

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-type	application/json bei Verwendung delegierter Berechtigungen application/ipp oder application/json bei Verwendung von Anwendungsberechtigungen. Erforderlich.

Anforderungstext

Delegierte Berechtigungen und JSON-Nutzlast

Wenn Sie delegierte Berechtigungen verwenden, geben Sie im Anforderungstext die Werte für die relevanten Druckerfelder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.

Die folgenden Eigenschaften können mithilfe delegierter Berechtigungen aktualisiert werden.

Eigenschaft	Typ	Beschreibung
defaults	printerDefaults	Die Standarddruckeinstellungen des Druckers.
Speicherort	printerLocation	Der physische und/oder organisationsbezogene Standort des Druckers.
displayName	String	Der Name des Druckers.

Anwendungsberechtigungen und JSON-Nutzlast

Geben Sie im Anforderungstext die Werte für die relevanten Druckerfelder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.

Die folgenden Eigenschaften können mithilfe von Anwendungsberechtigungen aktualisiert werden.

Eigenschaft	Typ	Beschreibung
defaults	printerDefaults	Die Standarddruckeinstellungen des Druckers.
Funktionen	printerCapabilities	Die Funktionen des Druckers, der dieser Druckerfreigabe zugeordnet ist.
displayName	String	Der Name des Druckers.
Hersteller	String	Der Hersteller des Druckers.
model	String	Der Modellname des Druckers.
status	printerStatus	Die Verarbeitung status des Druckers, einschließlich etwaiger Fehler.
isAcceptingJobs	Boolesch	Gibt an, ob der Drucker derzeit neue Druckaufträge akzeptiert.

Anwendungsberechtigungen und IPP-Nutzlast

Mit Anwendungsberechtigungen kann ein Drucker auch mithilfe einer IPP-Nutzlast (Internet Printing Protocol) aktualisiert werden. In diesem Fall enthält der Anforderungstext einen binären Stream, der die Gruppe Printer Attributes in der IPP-Codierung darstellt.

Der Client MUSS einen Satz von Printer-Attributen mit mindestens einem Wert (einschließlich explizit zulässiger Out-of-Band-Werte) bereitstellen, wie in RFC8011 Abschnitt 5.2 Auftragsvorlagenattribute ("xxx-default", "xxx-supported" und "xxx-ready" Attribute), Abschnitt 5.4 Druckerbeschreibungsattribute definiert. Der Client muss auch alle Attributerweiterungen bereitstellen, die vom Drucker unterstützt werden. Die Werte jedes angegebenen Printer-Attributs ersetzen die Werte des entsprechenden Printer-Attributs für das Printer-Zielobjekt. Bei Attributen, die mehrere Werte (1setOf) aufweisen können, ersetzen alle vom Client bereitgestellten Werte alle Werte des entsprechenden Printer-Objektattributes.

Hinweis: Übergeben Sie keine Vorgangsattribute im Anforderungstext. Der Anforderungstext sollte nur Druckerattribute enthalten.

Hinweis: Damit Drucker mit einer bestimmten Plattform arbeiten können, sollten sie die Anforderungen dieser Plattform erfüllen. Auf dem Windows-Client wird beispielsweise erwartet, dass der Drucker alle Attribute angibt, die gemäß MOPRIA-Spezifikationen als obligatorisch betrachtet werden. Bitte beachten Sie, dass MOPRIA-Spezifikationen nur für kostenpflichtige Mitglieder von MOPRIA verfügbar sind.

Antwort

Delegierte Berechtigungen und JSON-Nutzlast

Wenn delegierte Berechtigungen verwendet werden, gibt diese Methode bei erfolgreicher Ausführung einen 200 OK Antwortcode und ein aktualisiertes Druckerobjekt im Antworttext zurück.

Anwendungsberechtigungen und JSON-Nutzlast

Wenn delegierte Berechtigungen verwendet werden, gibt diese Methode bei erfolgreicher Ausführung einen 200 OK Antwortcode und ein aktualisiertes Druckerobjekt im Antworttext zurück.

Anwendungsberechtigungen und IPP-Nutzlast

Bei Verwendung von Anwendungsberechtigungen gibt diese Methode bei erfolgreicher Ausführung einen 204 No content Antwortcode zurück. Es gibt nichts im Antworttext zurück.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

HTTP

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

{
  "name": "PrinterName",
  "location": {
    "latitude": 1.1,
    "longitude": 2.2,
    "altitudeInMeters": 3
  }
}

C#

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new Printer
{
	Location = new PrinterLocation
	{
		Latitude = 1.1d,
		Longitude = 2.2d,
		AltitudeInMeters = 3,
	},
	AdditionalData = new Dictionary<string, object>
	{
		{
			"name" , "PrinterName"
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Print.Printers["{printer-id}"].PatchAsync(requestBody);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

CLI

mgc print printers patch --printer-id {printer-id} --body '{\
  "name": "PrinterName",\
  "location": {\
    "latitude": 1.1,\
    "longitude": 2.2,\
    "altitudeInMeters": 3\
  }\
}\
'

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Go

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

requestBody := graphmodels.NewPrinter()
location := graphmodels.NewPrinterLocation()
latitude := float64(1.1)
location.SetLatitude(&latitude) 
longitude := float64(2.2)
location.SetLongitude(&longitude) 
altitudeInMeters := int32(3)
location.SetAltitudeInMeters(&altitudeInMeters) 
requestBody.SetLocation(location)
additionalData := map[string]interface{}{
	"name" : "PrinterName", 
}
requestBody.SetAdditionalData(additionalData)

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
printers, err := graphClient.Print().Printers().ByPrinterId("printer-id").Patch(context.Background(), requestBody, nil)

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Java

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Printer printer = new Printer();
PrinterLocation location = new PrinterLocation();
location.setLatitude(1.1d);
location.setLongitude(2.2d);
location.setAltitudeInMeters(3);
printer.setLocation(location);
HashMap<String, Object> additionalData = new HashMap<String, Object>();
additionalData.put("name", "PrinterName");
printer.setAdditionalData(additionalData);
Printer result = graphClient.print().printers().byPrinterId("{printer-id}").patch(printer);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const printer = {
  name: 'PrinterName',
  location: {
    latitude: 1.1,
    longitude: 2.2,
    altitudeInMeters: 3
  }
};

await client.api('/print/printers/{printerId}')
	.update(printer);

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

PHP

<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\Printer;
use Microsoft\Graph\Generated\Models\PrinterLocation;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new Printer();
$location = new PrinterLocation();
$location->setLatitude(1.1);
$location->setLongitude(2.2);
$location->setAltitudeInMeters(3);
$requestBody->setLocation($location);
$additionalData = [
	'name' => 'PrinterName',
];
$requestBody->setAdditionalData($additionalData);

$result = $graphServiceClient->escapedPrint()->printers()->byPrinterId('printer-id')->patch($requestBody)->wait();

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.printer import Printer
from msgraph.generated.models.printer_location import PrinterLocation
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Printer(
	location = PrinterLocation(
		latitude = 1.1,
		longitude = 2.2,
		altitude_in_meters = 3,
	),
	additional_data = {
			"name" : "PrinterName",
	}
)

result = await graph_client.print.printers.by_printer_id('printer-id').patch(request_body)

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die Antwort. Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#print/printers/$entity",
  "id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
  "displayName": "PrinterName",
  "manufacturer": "PrinterManufacturer",
  "model": "PrinterModel",
  "isShared": true,
  "registeredDateTime": "2020-02-04T00:00:00.0000000Z",
  "isAcceptingJobs": true,
  "status": {
    "state": "idle",
    "details": [],
    "description": ""
  },
  "defaults": {
    "copiesPerJob":1,
    "contentType": "application/oxps",
    "finishings": ["none"],
    "mediaType": "stationery"
  },
  "location": {
    "latitude": 1.1,
    "longitude": 2.2,
    "altitudeInMeters": 3,
    "streetAddress": "One Microsoft Way",
    "subUnit": [
        "Main Plaza",
        "Unit 400"
    ],
    "city": "Redmond",
    "postalCode": "98052",
    "countryOrRegion": "USA",
    "site": "Puget Sound",
    "building": "Studio E",
    "floor": "1",
    "floorDescription": "First Floor",
    "roomName": "1234",
    "roomDescription": "First floor copy room",
    "organization": [
        "C+AI",
        "Microsoft Graph"
    ],
    "subdivision": [
        "King County",
        "Red West"
    ],
    "stateOrProvince": "Washington"
  }
}