Tipo de recurso managedDevice
Espacio de nombres: microsoft.graph
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Dispositivos administrados o inscritos previamente a través de Intune
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Enumerar managedDevices | Colección managedDevice | Enumere las propiedades y las relaciones de los objetos managedDevice. |
| Obtener managedDevice | managedDevice | Lea las propiedades y las relaciones del objeto managedDevice. |
| Crear managedDevice | managedDevice | Cree un objeto managedDevice. |
| Eliminar managedDevice | Ninguno | Elimina un managedDevice. |
| Actualizar managedDevice | managedDevice | Actualice las propiedades de un objeto managedDevice. |
| retirar acción|Ninguno|Retirada de un dispositivo | |acción de borrado|Ninguno|Borrado de un dispositivo | |acción resetPasscode |Ninguno|Restablecimiento del código de acceso | |acción remoteLock |Ninguno|Bloqueo remoto | |acción requestRemoteAssistance |Ninguno|Solicitud de asistencia remota | |acción disableLostMode |Ninguno|Deshabilitación del modo perdido | |acción locateDevice |Ninguno|Buscar un dispositivo | |bypassActivationLock action |Ninguno|Omitir el bloqueo de activación | |acción rebootNow |Ninguno|Reinicio del dispositivo | |acción shutDown |Ninguno|Apagar el dispositivo | |acción recoverPasscode |Ninguno|Recuperación del código de acceso | |acción cleanWindowsDevice |Ninguno|Limpieza del dispositivo Windows | |acción logoutSharedAppleDeviceActiveUser |Ninguno|Cierre de sesión del usuario activo del dispositivo Apple compartido | |acción deleteUserFromSharedAppleDevice |Ninguno|Eliminación de un usuario del dispositivo Apple compartido | |acción syncDevice |None|| |acción windowsDefenderScan|None|| |acción windowsDefenderUpdateSignatures |None|| |acción updateWindowsDeviceAccount |None||
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador único del dispositivo. Esta propiedad es de sólo lectura. |
| userId | Cadena | Identificador único del usuario asociado al dispositivo. Esta propiedad es de sólo lectura. |
| deviceName | Cadena | Nombre del dispositivo. Esta propiedad es de sólo lectura. |
| managedDeviceOwnerType | managedDeviceOwnerType | Propiedad del dispositivo. Puede ser "empresa" o "personal". Los valores posibles son: unknown, company y personal. |
| deviceActionResults | Colección deviceActionResult | Lista de objetos deviceActionResult ComplexType. Esta propiedad es de sólo lectura. |
| enrolledDateTime | DateTimeOffset | Hora de inscripción del dispositivo. Admite $filter operador "lt" y "gt". Esta propiedad es de sólo lectura. |
| lastSyncDateTime | DateTimeOffset | Fecha y hora en que el dispositivo completó por última vez una sincronización correcta con Intune. Admite $filter operador "lt" y "gt". Esta propiedad es de sólo lectura. |
| operatingSystem | Cadena | Sistema operativo del dispositivo. Windows, iOS, etcetera. Esta propiedad es de solo lectura. |
| complianceState | complianceState | Estado de cumplimiento del dispositivo. Ejemplos: Compatible, Conflicto, Error, etcetera. El valor predeterminado es desconocido. Admite $filter operador "eq" y "or". Esta propiedad es de sólo lectura. Los valores posibles son: unknown, compliant, noncompliant, conflict, error, inGracePeriod y configManager. |
| jailBroken | Cadena | Si el dispositivo está dañado o enraizado. El valor predeterminado es una cadena vacía. Admite $filter operador "eq" y "or". Esta propiedad es de sólo lectura. |
| managementAgent | managementAgentType | Canal de administración del dispositivo. Ejemplos: Intune, EAS, etcetera. El valor predeterminado es desconocido. Admite $filter operador "eq" y "or". Esta propiedad es de sólo lectura. Los valores posibles son: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf y googleCloudDevicePolicyController. |
| osVersion | Cadena | Versión del sistema operativo del dispositivo. Esta propiedad es de sólo lectura. |
| easActivated | Booleano | Indica si el dispositivo tiene Exchange ActiveSync activado. Esta propiedad es de sólo lectura. |
| easDeviceId | Cadena | Identificador de Exchange ActiveSync del dispositivo. Esta propiedad es de sólo lectura. |
| easActivationDateTime | DateTimeOffset | Hora de activación de Exchange ActivationSync del dispositivo. Esta propiedad es de sólo lectura. |
| azureADRegistered | Booleano | Indica si el dispositivo está registrado en Azure Active Directory. Esta propiedad es de sólo lectura. |
| deviceEnrollmentType | deviceEnrollmentType | Tipo de inscripción del dispositivo. Esta propiedad es de sólo lectura. Valores posibles: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, windowsAzureADJoinUsingDeviceAuth, appleUserEnrollment, appleUserEnrollmentWithServiceAccount. |
| activationLockBypassCode | Cadena | Código que permite omitir el bloqueo de activación en el dispositivo administrado. El valor predeterminado es Null (propiedad no predeterminada) para esta propiedad cuando se devuelve como parte de la entidad managedDevice en la llamada LIST. Para recuperar los valores reales, es necesario realizar una llamada GET, con el identificador de dispositivo y que se incluya en el parámetro select. Admite: $select. no se admite $Search. Solo lectura. Esta propiedad es de sólo lectura. |
| emailAddress | Cadena | Correo electrónico del usuario asociado al dispositivo. Esta propiedad es de sólo lectura. |
| azureADDeviceId | Cadena | Identificador único del dispositivo de Azure Active Directory. Solo lectura. Esta propiedad es de sólo lectura. |
| deviceRegistrationState | deviceRegistrationState | Estado de registro del dispositivo. Esta propiedad es de sólo lectura. Los valores posibles son: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment y unknown. |
| deviceCategoryDisplayName | Cadena | Nombre para mostrar de la categoría de dispositivo. El valor predeterminado es una cadena vacía. Admite $filter operador "eq" y "or". Esta propiedad es de sólo lectura. |
| isSupervised | Booleano | Estado supervisado del dispositivo. Esta propiedad es de sólo lectura. |
| exchangeLastSuccessfulSyncDateTime | DateTimeOffset | Última vez que el dispositivo estableció contacto con Exchange. Esta propiedad es de sólo lectura. |
| exchangeAccessState | deviceManagementExchangeAccessState | Estado de acceso del dispositivo en Exchange. Esta propiedad es de sólo lectura. Los valores posibles son: none, unknown, allowed, blocked y quarantined. |
| exchangeAccessStateReason | deviceManagementExchangeAccessStateReason | Motivo del estado de acceso del dispositivo en Exchange. Esta propiedad es de sólo lectura. Los valores posibles son: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword y deviceNotKnownWithManagedApp. |
| remoteAssistanceSessionUrl | Cadena | Dirección URL que permite que se establezca una sesión remota con el dispositivo. El valor predeterminado es una cadena vacía. Para recuperar los valores reales, es necesario realizar una llamada GET, con el identificador de dispositivo y que se incluya en el parámetro select. Esta propiedad es de sólo lectura. |
| remoteAssistanceSessionErrorDetails | Cadena | Cadena de error que identifica los problemas al crear objetos de la sesión de asistencia remota. Esta propiedad es de sólo lectura. |
| isEncrypted | Booleano | Estado de cifrado del dispositivo. Esta propiedad es de sólo lectura. |
| userPrincipalName | Cadena | Nombre principal de usuario del dispositivo. Esta propiedad es de sólo lectura. |
| model | Cadena | Modelo del dispositivo. Esta propiedad es de sólo lectura. |
| manufacturer | Cadena | Fabricante del dispositivo. Esta propiedad es de sólo lectura. |
| imei | Cadena | IMEI. Esta propiedad es de sólo lectura. |
| complianceGracePeriodExpirationDateTime | DateTimeOffset | Fecha y hora en que expira el período de gracia de cumplimiento del dispositivo. Esta propiedad es de sólo lectura. |
| serialNumber | Cadena | SerialNumber. Esta propiedad es de sólo lectura. |
| phoneNumber | Cadena | Número de teléfono del dispositivo. Esta propiedad es de sólo lectura. |
| androidSecurityPatchLevel | Cadena | Nivel de revisión de seguridad de Android. Esta propiedad es de sólo lectura. |
| userDisplayName | Cadena | Nombre para mostrar del usuario. Esta propiedad es de sólo lectura. |
| configurationManagerClientEnabledFeatures | configurationManagerClientEnabledFeatures | Características habilitadas para el cliente de ConfigrMgr. Esta propiedad es de sólo lectura. |
| wiFiMacAddress | Cadena | Wi-Fi MAC. Esta propiedad es de sólo lectura. |
| deviceHealthAttestationState | deviceHealthAttestationState | Estado de la atestación de estado del dispositivo. Esta propiedad es de sólo lectura. |
| subscriberCarrier | Cadena | Operador de suscriptor. Esta propiedad es de sólo lectura. |
| meid | Cadena | MEID. Esta propiedad es de sólo lectura. |
| totalStorageSpaceInBytes | Int64 | Almacenamiento total en bytes. Esta propiedad es de sólo lectura. |
| freeStorageSpaceInBytes | Int64 | Almacenamiento libre en bytes. El valor predeterminado es 0. Solo lectura. Esta propiedad es de sólo lectura. |
| managedDeviceName | Cadena | Nombre generado automáticamente para identificar un dispositivo. Se puede sobrescribir con un nombre descriptivo del usuario. |
| partnerReportedThreatState | managedDevicePartnerReportedHealthState | Indica el estado de amenazas de un dispositivo cuando la cuenta y el dispositivo usan un partner de Mobile Threat Defense. Solo lectura. Esta propiedad es de sólo lectura. Los valores posibles son: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised y misconfigured. |
| requireUserEnrollmentApproval | Booleano | Notifica si el dispositivo iOS administrado es la inscripción de aprobación del usuario. Esta propiedad es de sólo lectura. |
| managementCertificateExpirationDate | DateTimeOffset | Notifica la fecha de expiración del certificado de administración de dispositivos. Esta propiedad es de sólo lectura. |
| iccid | Cadena | Identificador de tarjeta de circuito integrado, es el número de identificación único de una tarjeta SIM. El valor predeterminado es una cadena vacía. Para recuperar los valores reales, es necesario realizar una llamada GET, con el identificador de dispositivo y que se incluya en el parámetro select. Admite: $select. no se admite $Search. Solo lectura. Esta propiedad es de sólo lectura. |
| udid | Cadena | Identificador de dispositivo único para dispositivos iOS y macOS. El valor predeterminado es una cadena vacía. Para recuperar los valores reales, es necesario realizar una llamada GET, con el identificador de dispositivo y que se incluya en el parámetro select. Admite: $select. no se admite $Search. Solo lectura. Esta propiedad es de sólo lectura. |
| notas | Cadena | Notas sobre el dispositivo creado por el administrador de TI. El valor predeterminado es null. Para recuperar los valores reales, es necesario realizar una llamada GET, con el identificador de dispositivo y que se incluya en el parámetro select. Admite: $select. no se admite $Search. |
| ethernetMacAddress | Cadena | Indica la dirección MAC ethernet del dispositivo. El valor predeterminado es Null (propiedad no predeterminada) para esta propiedad cuando se devuelve como parte de la entidad managedDevice. Se necesita una llamada get individual con opciones de consulta select para recuperar valores reales. Ejemplo: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Supports: $select. no se admite $Search. Solo lectura. Esta propiedad es de sólo lectura. |
| physicalMemoryInBytes | Int64 | Memoria total en bytes. El valor predeterminado es 0. Para recuperar los valores reales, es necesario realizar una llamada GET, con el identificador de dispositivo y que se incluya en el parámetro select. Admite: $select. Solo lectura. Esta propiedad es de sólo lectura. |
| enrollmentProfileName | Cadena | Nombre del perfil de inscripción asignado al dispositivo. El valor predeterminado es una cadena vacía, lo que indica que no se ha diseñado ningún perfil de inscripción. Esta propiedad es de sólo lectura. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| deviceCategory | deviceCategory | Categoría de dispositivo |
| windowsProtectionState | windowsProtectionState | Estado de protección del dispositivo. Esta propiedad es de sólo lectura. |
| users | Colección user | Los usuarios principales asociados al dispositivo administrado. |
| logCollectionRequests | colección deviceLogCollectionResponse | Lista de solicitudes de recopilación de registros |
Representación JSON
Aquí tiene una representación JSON del recurso.
{
"@odata.type": "#microsoft.graph.managedDevice",
"id": "String (identifier)",
"userId": "String",
"deviceName": "String",
"managedDeviceOwnerType": "String",
"deviceActionResults": [
{
"@odata.type": "microsoft.graph.deviceActionResult",
"actionName": "String",
"actionState": "String",
"startDateTime": "String (timestamp)",
"lastUpdatedDateTime": "String (timestamp)"
}
],
"enrolledDateTime": "String (timestamp)",
"lastSyncDateTime": "String (timestamp)",
"operatingSystem": "String",
"complianceState": "String",
"jailBroken": "String",
"managementAgent": "String",
"osVersion": "String",
"easActivated": true,
"easDeviceId": "String",
"easActivationDateTime": "String (timestamp)",
"azureADRegistered": true,
"deviceEnrollmentType": "String",
"activationLockBypassCode": "String",
"emailAddress": "String",
"azureADDeviceId": "String",
"deviceRegistrationState": "String",
"deviceCategoryDisplayName": "String",
"isSupervised": true,
"exchangeLastSuccessfulSyncDateTime": "String (timestamp)",
"exchangeAccessState": "String",
"exchangeAccessStateReason": "String",
"remoteAssistanceSessionUrl": "String",
"remoteAssistanceSessionErrorDetails": "String",
"isEncrypted": true,
"userPrincipalName": "String",
"model": "String",
"manufacturer": "String",
"imei": "String",
"complianceGracePeriodExpirationDateTime": "String (timestamp)",
"serialNumber": "String",
"phoneNumber": "String",
"androidSecurityPatchLevel": "String",
"userDisplayName": "String",
"configurationManagerClientEnabledFeatures": {
"@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
"inventory": true,
"modernApps": true,
"resourceAccess": true,
"deviceConfiguration": true,
"compliancePolicy": true,
"windowsUpdateForBusiness": true
},
"wiFiMacAddress": "String",
"deviceHealthAttestationState": {
"@odata.type": "microsoft.graph.deviceHealthAttestationState",
"lastUpdateDateTime": "String",
"contentNamespaceUrl": "String",
"deviceHealthAttestationStatus": "String",
"contentVersion": "String",
"issuedDateTime": "String (timestamp)",
"attestationIdentityKey": "String",
"resetCount": 1024,
"restartCount": 1024,
"dataExcutionPolicy": "String",
"bitLockerStatus": "String",
"bootManagerVersion": "String",
"codeIntegrityCheckVersion": "String",
"secureBoot": "String",
"bootDebugging": "String",
"operatingSystemKernelDebugging": "String",
"codeIntegrity": "String",
"testSigning": "String",
"safeMode": "String",
"windowsPE": "String",
"earlyLaunchAntiMalwareDriverProtection": "String",
"virtualSecureMode": "String",
"pcrHashAlgorithm": "String",
"bootAppSecurityVersion": "String",
"bootManagerSecurityVersion": "String",
"tpmVersion": "String",
"pcr0": "String",
"secureBootConfigurationPolicyFingerPrint": "String",
"codeIntegrityPolicy": "String",
"bootRevisionListInfo": "String",
"operatingSystemRevListInfo": "String",
"healthStatusMismatchInfo": "String",
"healthAttestationSupportedStatus": "String"
},
"subscriberCarrier": "String",
"meid": "String",
"totalStorageSpaceInBytes": 1024,
"freeStorageSpaceInBytes": 1024,
"managedDeviceName": "String",
"partnerReportedThreatState": "String",
"requireUserEnrollmentApproval": true,
"managementCertificateExpirationDate": "String (timestamp)",
"iccid": "String",
"udid": "String",
"notes": "String",
"ethernetMacAddress": "String",
"physicalMemoryInBytes": 1024,
"enrollmentProfileName": "String"
}