Drucker: Erstellen

Namespace: microsoft.graph

Erstellen (registrieren) eines Druckers mit dem Dienst für universelles Drucken. Dies ist ein zeitintensiver Vorgang und gibt als solcher einen printerCreateOperation zurück, der zum Nachverfolgen und Überprüfen der Registrierung des Druckers verwendet werden kann.

Hilfe zum Erstellen der erforderlichen Zertifikatsignieranforderung (Certificate Signing Request, CSR) zum Erstellen eines Druckers finden Sie im CSR-Generierungscodebeispiel.

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

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ✅ ✅ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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.Create Printer.FullControl.All, Printer.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Nicht unterstützt Nicht unterstützt

HTTP-Anforderung

POST /print/printers/create

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.

In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Aktion verwendet werden können.

Parameter Typ Beschreibung
displayName Zeichenfolge Erforderlich. Der Anzeigename, der dem Drucker zugewiesen werden soll.
Hersteller Zeichenfolge Erforderlich. Der Hersteller des Druckers.
model Zeichenfolge Erforderlich. Das Modell des Druckers.
physicalDeviceId Zeichenfolge Optional. Die physische Geräte-UUID des Druckers. Erforderlich, wenn die hasPhysicalDevice-Eigenschaft ist true.
hasPhysicalDevice Boolescher Wert Optional. true wenn der Drucker über ein physisches Ausgabegerät verfügt; falseandernfalls . Wenn er ausgelassen wird, lautet trueder Standardwert .
certificateSigningRequest printCertificateSigningRequest Erforderlich. Die X.509-Zertifikatsignieranforderung (Certificate Signing Request, CSR) für das Zertifikat, das vom Drucker erstellt und verwendet wird, um sich selbst zu identifizieren.
connectorId Zeichenfolge Optional. ID des Connectors, der als Proxy für den Drucker fungiert.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 202 Accepted Antwortcode und einen Link zum zugeordneten printerCreateOperation im Operation-Location Header zurück.

Sie stellen eine GET-Anforderung an die verknüpfte URL, um den Status einer laufenden Druckerregistrierung abzurufen. Nachdem die Druckerregistrierung erfolgreich abgeschlossen wurde, enthält eine GET-Anforderung an die verknüpfte URL das erstellte Druckerobjekt und das registrierte Zertifikat.

Beispiele

Anforderung

POST https://graph.microsoft.com/v1.0/print/printers/create
Content-Type: application/json

{
  "displayName": "Test Printer",
  "manufacturer": "Test Printer Manufacturer",
  "model": "Test Printer Model",
  "physicalDeviceId": null,
  "hasPhysicalDevice": false,
  "certificateSigningRequest": { 
    "content": "{content}",
    "transportKey": "{sampleTransportKey}"
  },
  "connectorId": null
}

Antwort

HTTP/1.1 202 Accepted
Operation-Location: https://graph.microsoft.com/v1.0/print/operations/f221760a-52e8-4c11-b8c5-5dfaef3a49db
Retry-After: 5