Tipo de recurso device
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 registrado en el directorio. Los dispositivos se crean en la nube con el servicio de registro de dispositivos o Intune. Las directivas de acceso condicional los usan para la autenticación multifactor. Estos dispositivos pueden ir desde equipos portátiles y de escritorio hasta teléfonos y tabletas. Se hereda de directoryObject.
Este recurso es de tipo abierto y permite que pasen otras propiedades.
Este recurso admite:
- que agregue sus propios datos a las propiedades personalizadas como extensiones.
- El uso de una consulta delta para realizar un seguimiento de adiciones, eliminaciones y actualizaciones incrementales al proporcionar una función delta.
-
Funcionalidades de consulta de OData , como
$select,$filter,$searchy$top. Los usos específicos solo se admiten con funcionalidades de consulta avanzadas.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| List | Colección device | Recupere una lista de dispositivos registrados en el directorio. |
| Crear | dispositivo | Registre un nuevo dispositivo en el directorio. |
| Obtener | dispositivo | Lee las propiedades y las relaciones del objeto de dispositivo. |
| Actualizar | dispositivo | Actualice las propiedades del objeto de dispositivo. |
| Delete | Ninguno | Elimine el objeto de dispositivo. |
| Obtener delta | Colección device | Obtenga cambios incrementales para los dispositivos. |
| Enumerar miembro de | Colección directoryObject | Enumere los grupos y las unidades administrativas de los que el dispositivo es miembro directo. |
| Enumeración de miembros transitivos de | Colección directoryObject | Enumere los grupos y las unidades administrativas de los que es miembro el dispositivo. Esta operación es transitiva. |
| Enumerar propietarios registrados | Colección directoryObject | Obtenga los usuarios que son propietarios registrados del dispositivo de la propiedad de navegación registeredOwners. |
| Agregar propietarios registrados | Colección directoryObject | Agregue propietarios registrados del dispositivo. |
| Eliminación de propietarios registrados | Colección directoryObject | Elimine los propietarios registrados del dispositivo. |
| Enumerar usuarios registrados | Colección directoryObject | Obtenga los usuarios registrados del dispositivo de la propiedad de navegación registeredUsers. |
| Incorporación de usuarios registrados | Colección directoryObject | Agregue usuarios registrados del dispositivo . |
| Eliminación de usuarios registrados | Colección directoryObject | Quite los usuarios registrados del dispositivo . |
| Enumerar derechos de uso | Colección usageRight | Obtenga una colección de derechos de uso concedidos al dispositivo. |
| Comprobar grupos de miembro | Colección string | Comprueba la pertenencia a una lista de grupos. La comprobación es transitiva. |
| Obtener grupos de miembro | Colección de cadenas | Devuelve todos los grupos de los que es miembro el dispositivo. La comprobación es transitiva. |
| Comprobación de objetos miembro | Colección de cadenas | Compruebe si hay pertenencia a una lista de grupos, roles de directorio u objetos de unidad administrativa. |
| Obtener objetos de miembro | Colección de cadenas | Devuelve todos los grupos, unidades administrativas y roles de directorio de los que es miembro el dispositivo. La comprobación es transitiva. |
Propiedades
Importante
El uso específico de $filter y el parámetro de consulta $search solo se admite cuando se usa el encabezado ConsistencyLevel establecido en eventual y $count. Para obtener más información, vea Funcionalidades avanzadas de consulta en objetos de directorio.
| Propiedad | Tipo | Descripción |
|---|---|---|
| accountEnabled | Boolean |
true si la cuenta está habilitada; en caso contrario, false. El valor predeterminado es true. Admite $filter (eq, ne, not y in). Solo los autores de llamadas con al menos el rol Administrador de dispositivos en la nube pueden establecer esta propiedad. |
| alternativeSecurityIds | Colección alternativeSecurityId | Únicamente para uso interno. No admite valores NULL. Admite $filter (eq, not, ge, le). |
| approximateLastSignInDateTime | DateTimeOffset | El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Solo lectura. Admite $filter (eq, ne, not, ge, ley eq en null valores) y $orderby. |
| complianceExpirationDateTime | DateTimeOffset | Marca de tiempo cuando el dispositivo ya no se considera compatible. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Solo lectura. |
| deviceCategory | Cadena | Propiedad definida por el usuario establecida por Intune para agregar automáticamente dispositivos a grupos y simplificar la administración de dispositivos. |
| deviceId | Cadena | Identificador único establecido por el servicio de registro de dispositivos de Azure en el momento del registro. Se trata de una clave alternativa que se puede usar para hacer referencia al objeto de dispositivo. También admite $filter (eq, ne, not, startsWith). |
| deviceMetadata | String | Únicamente para uso interno. Establecer anull. |
| deviceOwnership | Cadena | Propiedad del dispositivo. Esta propiedad se establece mediante Intune. Los valores posibles son: unknown, company y personal. |
| deviceVersion | Int32 | Únicamente para uso interno. |
| displayName | String | El nombre para mostrar del dispositivo. Obligatorio. Admite $filter (eq, ne, not, ge, le, in, startsWith y eq en valores null), $search y $orderby. |
| domainName | Cadena | Nombre de dominio local de Microsoft Entra dispositivos unidos a híbridos. Esta propiedad se establece mediante Intune. |
| enrollmentProfileName | Cadena | Perfil de inscripción aplicado al dispositivo. Por ejemplo, Apple Device Enrollment Profile, Device enrollment - Corporate device identifiers o Windows Autopilot profile name. Esta propiedad se establece mediante Intune. |
| enrollmentType | String | Tipo de inscripción del dispositivo. Esta propiedad se establece mediante Intune. Los valores posibles son: , , , , appleBulkWithUserappleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, windowsAzureADJoinUsingDeviceAuth, , , appleUserEnrollmentWithServiceAccountappleUserEnrollment. deviceEnrollmentManageruserEnrollmentunknown NOTA: Esta propiedad podría devolver otros valores aparte de los enumerados. |
| extensionAttributes | OnPremisesExtensionAttributes | Contiene los atributos de extensión 1-15 para el dispositivo. Los atributos de extensión individuales no se pueden seleccionar. Estas propiedades se dominan en la nube y se pueden establecer durante la creación o actualización de un objeto de dispositivo en Microsoft Entra ID. Admite $filter (eq, not, startsWith y eq en valores null). |
| nombres de host | Colección de cadenas | Lista de nombres de host para el dispositivo. |
| id | String | El identificador único del dispositivo. Hereda de directoryObject. Clave, no admite valores NULL. Solo lectura. Admite $filter (eq, ne, not, in). |
| isCompliant | Booleano |
truesi el dispositivo cumple con las directivas de Mobile Administración de dispositivos (MDM); de lo contrario, false. Solo lectura. Esto solo se puede actualizar mediante Intune para cualquier tipo de sistema operativo de dispositivo o mediante una aplicación MDM aprobada para dispositivos del sistema operativo Windows. Admite $filter (eq, ne y not). |
| isManaged | Booleano |
truesi el dispositivo se administra mediante una aplicación de mobile Administración de dispositivos (MDM); en caso contrario, false. Esto solo se puede actualizar mediante Intune para cualquier tipo de sistema operativo de dispositivo o mediante una aplicación MDM aprobada para dispositivos del sistema operativo Windows. Admite $filter (eq, ne y not). |
| isManagementRestricted | Booleano | Indica si el dispositivo es miembro de una unidad administrativa de administración restringida. El valor predeterminado es false. Solo lectura. Para administrar un dispositivo que sea miembro de una unidad administrativa de administración restringida, al administrador o a la aplicación de llamada se le debe asignar un rol de Microsoft Entra en el ámbito de la unidad administrativa de administración restringida. |
| isRooted | Booleano |
true si el dispositivo está enraizado o con jail-broken. Esta propiedad solo se puede actualizar por Intune. |
| kind | Cadena | Factor de forma del dispositivo. Solo se devuelve si el usuario inicia sesión con una cuenta microsoft como parte de Project Rome. |
| managementType | Cadena | Canal de administración del dispositivo. Esta propiedad se establece mediante Intune. Los valores posibles son: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf y googleCloudDevicePolicyController. |
| manufacturer | Cadena | Fabricante del dispositivo. Solo lectura. |
| mdmAppId | Cadena | Identificador de aplicación que se usa para registrar el dispositivo en MDM. Solo lectura. Admite $filter (eq, ne, not, startsWith). |
| model | Cadena | Modelo del dispositivo. Solo lectura. |
| name | Cadena | Nombre descriptivo del dispositivo. Solo se devuelve si el usuario inicia sesión con una cuenta microsoft como parte de Project Rome. |
| onPremisesLastSyncDateTime | DateTimeOffset | La última vez que se sincronizó el objeto con el directorio local. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y está siempre en hora UTC. Por ejemplo, medianoche UTC del 1 de enero de 2014 es 2014-01-01T00:00:00Z de solo lectura. Admite $filter (eq, ne, not, ge, le y in). |
| onPremisesSecurityIdentifier | Cadena | Identificador de seguridad local (SID) para el usuario que se sincronizó del entorno local a la nube. Solo lectura. Solo se devuelve en $select. Admite $filter (eq). |
| onPremisesSyncEnabled | Boolean |
true si este objeto está sincronizado desde un directorio local; false si este objeto se ha sincronizado originalmente desde un directorio local, pero ya no está sincronizado; null si este objeto no se ha sincronizado nunca desde un directorio local (valor predeterminado). Solo lectura. Admite $filter (eq, ne, not, in y eq en valores null). |
| operatingSystem | String | El tipo de sistema operativo del dispositivo. Obligatorio. Admite $filter (eq, ne, not, ge, le, startsWithy eq en null valores). |
| operatingSystemVersion | String | Versión del sistema operativo del dispositivo. Obligatorio. Admite $filter (eq, ne, not, ge, le, startsWithy eq en null valores). |
| physicalIds | Colección string | Únicamente para uso interno. No admite valores NULL. Admite $filter (eq, not, ge, le, startsWith, , /$count eq 0, /$count ne 0. |
| plataforma | Cadena | Plataforma del dispositivo. Solo se devuelve si el usuario inicia sesión con una cuenta microsoft como parte de Project Rome. |
| profileType | Cadena | Tipo de perfil del dispositivo. Valores posibles: RegisteredDevice (valor predeterminado), SecureVM, Printer, Shared, IoT. |
| registrationDateTime | DateTimeOffset | Fecha y hora de cuándo se registró el dispositivo. El tipo de marca de tiempo representa la información de fecha y hora con el formato ISO 8601 y siempre está en hora UTC. Por ejemplo, la medianoche en la zona horaria UTC del 1 de enero de 2014 sería 2014-01-01T00:00:00Z. Solo lectura. |
| status | Cadena | El dispositivo es online o offline. Solo se devuelve si el usuario inicia sesión con una cuenta microsoft como parte de Project Rome. |
| systemLabels | Colección de cadenas | Lista de etiquetas aplicadas al dispositivo por el sistema. Admite $filter (/$count eq 0, /$count ne 0). |
| trustType | String | Tipo de confianza del dispositivo que se ha unido. Solo lectura. Valores posibles: Workplace (indica traer sus propios dispositivos personales), AzureAd (solo dispositivos unidos a la nube) ServerAd (dispositivos unidos a un dominio local unidos a Microsoft Entra ID). Para obtener más información, consulte Introducción a la administración de dispositivos en Microsoft Entra ID. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| Comandos | colección de comandos | Conjunto de comandos enviados a este dispositivo. |
| extensions | Colección Extension | Colección de extensiones abiertas definidas para el dispositivo. Solo lectura. Admite valores NULL. |
| memberOf | Colección directoryObject | Grupos y unidades administrativas de las que es miembro este dispositivo. Solo lectura. Admite un valor NULL. Admite $expand. |
| registeredOwners | Colección directoryObject | Usuario que ha unido el dispositivo a la nube o que ha registrado su dispositivo personal. El propietario registrado se establece en el momento del registro. Solo lectura. Admite un valor NULL. Admite $expand. |
| registeredUsers | Colección directoryObject | Colección de usuarios registrados del dispositivo. En el caso de los dispositivos unidos a la nube y los dispositivos personales registrados, los usuarios registrados se establecen en el mismo valor que los propietarios registrados en el momento del registro. Solo lectura. Admite valores NULL. Admite $expand. |
| transitiveMemberOf | Colección directoryObject | Grupos y unidades administrativas de las que es miembro este dispositivo. Esta operación es transitiva. Admite $expand. |
| usageRights | Colección usageRight | Representa los derechos de uso que se han concedido a un dispositivo. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"accountEnabled": "Boolean",
"approximateLastSignInDateTime": "String (timestamp)",
"complianceExpirationDateTime": "String (timestamp)",
"deviceCategory": "String",
"deviceId": "String",
"deviceMetadata": "String",
"deviceOwnership": "String",
"deviceVersion": "Int32",
"displayName": "String",
"domainName": "String",
"enrollmentProfileName": "String",
"enrollmentType": "String",
"extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
"hostnames" : ["String"],
"id": "String (identifier)",
"isCompliant": "Boolean",
"isManaged": "Boolean",
"isRooted": "Boolean",
"kind": "String",
"managementType": "String",
"manufacturer": "String",
"mdmAppId": "String",
"model": "String",
"name": "String",
"onPremisesLastSyncDateTime": "String (timestamp)",
"onPremisesSecurityIdentifier": "String",
"onPremisesSyncEnabled": "Boolean",
"operatingSystem": "String",
"operatingSystemVersion": "String",
"physicalIds": ["String"],
"platform": "String",
"profileType": "String",
"registrationDateTime": "String (timestamp)",
"status": "String",
"systemLabels": ["String"],
"trustType": "String"
}