Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 registrado con el servicio de impresión universal. Los recursos de impresora se pueden usar para administrar trabajos de impresión, configuración de impresora, metadatos de impresora y estado de registro. Hereda de printerBase.
Este recurso admite la suscripción a notificaciones de cambio.
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 de impresora. |
| Actualizar | printer | Actualice el objeto de impresora. |
| Delete | Ninguno | Anule el registro de la impresora física del servicio de impresión universal. |
| Restauración de valores predeterminados 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 | Obtenga una lista de trabajos de impresión que la impresora pone en cola para su procesamiento. |
| Creación de un trabajo de impresión | printJob | Cree un nuevo trabajo de impresión para la impresora. Para empezar a imprimir el trabajo, use iniciar. |
| Enumerar conectores | colección printConnector | Obtenga una lista de los conectores a los que está asociada esta impresora. |
| Enumeración de desencadenadores de tareas | Ninguno | Enumerar printTaskTriggers asociados a esta impresora. |
| Crear desencadenador de tarea | printTaskTrigger | Cree un printTaskTrigger que se ejecute cuando se produzcan eventos de impresión. |
| Eliminación del desencadenador de tareas | Ninguno | Elimine un printTaskTrigger asociado a la impresora. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador de la impresora. Solo lectura. |
| displayName | Cadena | Nombre de la impresora. Se hereda de printerBase. |
| manufacturer | Cadena | Fabricante notificado por la impresora. Se hereda de printerBase. |
| model | Cadena | Nombre del modelo notificado por la impresora. Se hereda de printerBase. |
| registeredDateTime | DateTimeOffset | DateTimeOffset cuando se registró la impresora. Solo lectura. |
| status | printerStatus | Estado de procesamiento de la impresora, incluidos los errores. Se hereda de printerBase. |
| isShared | Booleano | True si la impresora está 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 truees , la impresora acepta actualmente nuevos trabajos de impresión. Se hereda de printerBase. |
| ubicación | printerLocation | Ubicación física o organizativa de la impresora. Se hereda de printerBase. |
| defaults | printerDefaults | La configuración de impresión predeterminada de la impresora. Se hereda de printerBase. |
| capabilities | printerCapabilities | Capacidades de la impresora. Se hereda de printerBase. |
| lastSeenDateTime | DateTimeOffset | Fecha más recienteTimeOffset cuando una impresora interactuó con impresión universal. Solo lectura. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| jobs | colección printJob | Lista de trabajos que la impresora pone en cola para la impresión. |
| shares | printerShare (colección) | Lista de printerShares asociados a la impresora. Actualmente, solo se puede asociar una impresoraShare a la impresora. Solo lectura. Admite valores NULL. |
| conectores | printConnector | Conectores asociados a la impresora. |
| taskTriggers | colección printTaskTrigger | Lista de desencadenadores de tareas asociados a 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)"
}