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