Tipo de recurso de impresora

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Representa un dispositivo de impresora que está registrado con el servicio de impresión universal. Los recursos de impresora se pueden usar para administrar trabajos de impresión, la configuración de la impresora, los metadatos de la impresora y el estado del registro. Hereda de printerBase.

Este recurso admite la suscripción a notificaciones de cambios.

Métodos

Método Tipo de valor devuelto Descripción
Crear printerCreateOperation Cree (registre) una nueva impresora con Impresión universal.
Get printer Lea las propiedades y relaciones del objeto impresora.
Actualizar printer Actualizar el objeto de impresora.
Delete Ninguno Anule el registro de la impresora física del servicio de impresión universal.
Restaurar valores de fábrica Ninguno Restaure la configuración predeterminada de una impresora a los valores especificados por el fabricante.
Enumerar trabajos de impresión Colección printJob Obtener una lista de los trabajos de impresión que la impresora pone en cola para su procesamiento.
Crear trabajo de impresión printJob Cree un nuevo trabajo de impresión para la impresora. Para iniciar la impresión del trabajo, use Inicio.
Enumerar conectores colección printConnector Obtén una lista de los conectores a los que está asociada esta impresora.
Enumerar desencadenadores de tareas Ninguno Enumerar printTaskTriggers asociados con esta impresora.
Crear desencadenador de tareas printTaskTrigger Crea un printTaskTrigger que se ejecute cuando se produzcan eventos de impresión.
Eliminar desencadenador de tareas Ninguno Elimine un printTaskTrigger asociado a la impresora.

Propiedades

Propiedad Tipo Descripción
id Cadena Identificador del impresor. Solo lectura.
displayName Cadena El nombre de la impresora. Heredado de printerBase.
manufacturer Cadena El fabricante notificado por la impresora. Heredado de printerBase.
model Cadena El nombre del modelo notificado por la impresora. Heredado de printerBase.
registeredDateTime DateTimeOffset El DateTimeOffset cuando se registró la impresora. Solo lectura.
status printerStatus El estado de procesamiento de la impresora, incluidos los errores. Heredado de printerBase.
isShared Booleano True si la impresora es compartida; False en caso contrario. Solo lectura.
hasPhysicalDevice Booleano True si la impresora tiene un dispositivo físico para imprimir. Solo lectura.
isAcceptingJobs Booleano Si true, la impresora está aceptando nuevos trabajos de impresión. Heredado de printerBase.
ubicación printerLocation La ubicación física u organizativa de la impresora. Heredado de printerBase.
defaults printerDefaults La configuración de impresión predeterminada de la impresora. Heredado de printerBase.
capabilities printerCapabilities Las capacidades de la impresora. Heredado de printerBase.
lastSeenDateTime DateTimeOffset La fecha y hora más reciente cuando una impresora interactuó con la impresión universal. Solo lectura.

Relaciones

Relación Tipo Descripción
jobs Colección printJob La lista de trabajos que la impresora pone en cola para imprimir.
shares Colección printerShare Lista de recursos compartidos de impresora asociados a la impresora. Actualmente, solo se puede asociar un printerShare con la impresora. Solo lectura. Admite valores NULL.
conectores printConnector Los conectores asociados a la impresora.
taskTriggers colección printTaskTrigger Una lista de desencadenadores de tareas asociados con la impresora.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "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)"
}