Tipo de recurso device

Espacio de nombres: microsoft.graph

Representa un dispositivo registrado en la organización. 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. También puede agregar sus propios datos a propiedades personalizadas como extensiones.

Métodos

Método Tipo de valor devuelto Descripción
Obtener dispositivo device Lea las propiedades y relaciones de un objeto device.
Enumerar dispositivos Colección device Recupere una lista de dispositivos registrados en el directorio.
Actualizar dispositivo device Actualice las propiedades de un objeto device.
Eliminar dispositivo Ninguno Elimine un objeto device.
delta Colección device Obtenga cambios incrementales para los dispositivos.
Enumerar memberOf Colección directoryObject Enumere los grupos y las unidades administrativas de los que el dispositivo es miembro directo.
Enumerar memberOf transitivos Colección directoryObject Enumere los grupos y las unidades administrativas de los que es miembro el dispositivo. Esta operación es transitiva.
Enumerar registeredOwners Colección directoryObject Obtenga los usuarios que son propietarios registrados del dispositivo de la propiedad de navegación registeredOwners.
Enumerar registeredUsers Colección directoryObject Obtenga los usuarios registrados del dispositivo de la propiedad de navegación registeredUsers.
checkMemberObjects Colección de cadenas Compruebe si hay pertenencia a una lista de grupos, roles de directorio u objetos de unidad administrativa.
getMemberObjects 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.
Extensiones abiertas
Crear extensión abierta openTypeExtension Crea una extensión abierta y agrega propiedades personalizadas en una instancia nueva o un recurso existente.
Obtener extensión abierta Colección openTypeExtension Obtiene una extensión abierta identificada por el nombre de extensión.
Extensiones de esquema
Agregar valores de extensión de esquema Cree una definición de extensión de esquema y, después, úsela para agregar datos escritos personalizados a un recurso.

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. Obligatorio. El valor predeterminado es true.

Admite $filter (eq, ne, not y in). Solo los autores de llamadas de los roles Administrador global y 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. Admite $filter (eq, ne, not y startsWith).
deviceMetadata String Únicamente para uso interno. Establecer anull.
deviceOwnership Cadena Propiedad del dispositivo. Intune establece esta propiedad. 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.
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. Intune establece esta propiedad.
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).
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. Intune solo puede actualizar esto 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. Intune solo puede actualizar esto 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).
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.
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).
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 La versión del sistema operativo del dispositivo. Obligatorio. Admite $filter (eq, ne, not, ge, le, startsWithy eq en null valores).
physicalIds Colección de cadenas Únicamente para uso interno. No admite valores NULL. Admite $filter (eq, not, ge, le, startsWith, , ,/$count eq 0/$count ne 0 ).
profileType deviceProfileType 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.
systemLabels Colección string 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
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 los que es miembro este dispositivo. Solo lectura. Admite valores 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 valores 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 los que es miembro el dispositivo. Esta operación es transitiva. Admite $expand.

Representación JSON

Esta es una representación JSON del recurso.

{
  "accountEnabled": "Boolean",
  "alternativeSecurityIds": [{"@odata.type": "microsoft.graph.alternativeSecurityId"}],
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceCategory": "String",
  "deviceId": "String",
  "deviceMetadata": "String",
  "deviceOwnership": "String",
  "deviceVersion": "Int32",
  "displayName": "String",
  "enrollmentProfileName": "String",
  "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "id": "String (identifier)",
  "isCompliant": "Boolean",
  "isManaged": "Boolean",
  "manufacturer": "String",
  "mdmAppId": "String",
  "model": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSyncEnabled": "Boolean",
  "operatingSystem": "String",
  "operatingSystemVersion": "String",
  "physicalIds": ["String"],
  "profileType": "String",
  "registrationDateTime": "String (timestamp)",
  "systemLabels": ["String"],
  "trustType": "String"
}