Druckerressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Stellt ein Druckergerät dar, das beim universellen Druckdienst registriert wurde. Druckerressourcen können zum Verwalten von Druckaufträgen, Druckereinstellungen, Druckermetadaten und Registrierungsstatus verwendet werden.

Diese Ressource unterstützt Folgendes:

• Abonnieren von Änderungsbenachrichtigungen.

Methoden

Methode	Rückgabetyp	Beschreibung
Create	printerCreateOperation	Erstellen (registrieren) Sie einen neuen Drucker mit Universal Print.
Get	Drucker	Lesen Sie die Eigenschaften und Beziehungen des Druckerobjekts.
Update	Drucker	Aktualisieren Sie das Druckerobjekt.
Delete	Keine	Aufheben der Registrierung des physischen Druckers vom Universellen Druckdienst.
restoreFactoryDefaults	Keine	Stellen Sie die Standardeinstellungen eines Druckers auf die vom Hersteller angegebenen Werte wieder dar.
Aufträge auflisten	printJob-Auflistung	Hier erhalten Sie eine Liste der Druckaufträge, die für die Verarbeitung durch den Drucker in die Warteschlange eingereiht sind.
Auftrag erstellen	printJob	Erstellen Sie einen neuen Druckauftrag für den Drucker. Verwenden Sie start, um mit dem Drucken des Auftrags zu beginnen.
List connectors	printConnector-Auflistung	Hier erhalten Sie eine Liste der Connectors, die diesem Drucker zugeordnet sind.
List taskTriggers	Keine	Listet printTaskTriggers auf, die diesem Drucker zugeordnet sind.
Create taskTrigger	printTaskTrigger	Erstellen Sie einen printTaskTrigger, der ausgeführt wird, wenn Druckereignisse auftreten.
Delete taskTrigger	Keine	Löschen Sie einen printTaskTrigger, der dem Drucker zugeordnet ist.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	String	Der Bezeichner des Druckers. Schreibgeschützt.
displayName	String	Der Name des Druckers.
Hersteller	String	Der vom Drucker gemeldete Hersteller.
model	String	Der vom Drucker gemeldete Modellname.
registeredDateTime	DateTimeOffset	DateTimeOffset, als der Drucker registriert wurde. Schreibgeschützt.
status	printerStatus	Der Verarbeitungsstatus des Druckers, einschließlich aller Fehler.
isShared	Boolescher Wert	True, wenn der Drucker freigegeben ist. false andernfalls. Schreibgeschützt.
hasPhysicalDevice	Boolesch	True, wenn der Drucker über ein physisches Gerät zum Drucken verfügt. Schreibgeschützt.
isAcceptingJobs	Boolesch	Gibt an, ob der Drucker derzeit neue Druckaufträge akzeptiert.
Speicherort	printerLocation	Der physische und/oder organisatorische Standort des Druckers.
defaults	printerDefaults	Die Standarddruckeinstellungen des Druckers.
Funktionen	printerCapabilities	Die Funktionen des Druckers.
lastSeenDateTime	DateTimeOffset	Die neueste dateTimeOffset-Version, wenn ein Drucker mit Universal Print interagiert hat. Schreibgeschützt.

Beziehungen

Beziehung	Typ	Beschreibung
jobs	printJob-Auflistung	Die Liste der Aufträge, die für das Drucken durch den Drucker in die Warteschlange eingereiht sind.
shares	printerShare-Auflistung	Die Liste der druckerfreigaben, die dem Drucker zugeordnet sind. Derzeit kann dem Drucker nur ein printerShare zugeordnet werden. Schreibgeschützt. Nullwerte zulassend.
Connectors	printConnector	Die Connectors, die dem Drucker zugeordnet sind.
taskTriggers	printTaskTrigger-Auflistung	Eine Liste der Aufgabenauslöser, die dem Drucker zugeordnet sind.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "id": "String (identifier)",
  "displayName": "String",
  "manufacturer": "String",
  "model": "String",
  "isShared": true,
  "registeredDateTime": "String (timestamp)",
  "isAcceptingJobs": true,
  "hasPhysicalDevice": true,
  "location": {"@odata.type": "microsoft.graph.printerLocation"},
  "status": {"@odata.type": "microsoft.graph.printerStatus"},
  "defaults": {"@odata.type": "microsoft.graph.printerDefaults"},
  "capabilities": {"@odata.type": "microsoft.graph.printerCapabilities"},
  "lastSeenDateTime": "String (timestamp)"
}