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: Microsoft admite Intune API /beta, pero están sujetas a cambios más frecuentes. Microsoft recomienda usar la versión v1.0 siempre que sea posible. Compruebe la disponibilidad de una API en la versión v1.0 mediante el selector de versiones.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto deviceConfigurationDeviceOverview.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | DeviceManagementConfiguration.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All |
Solicitud HTTP
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/rootCertificate/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.iosScepCertificateProfile/rootCertificate/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.macOSScepCertificateProfile/rootCertificate/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsPhone81SCEPCertificateProfile/rootCertificate/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsWifiEnterpriseEAPConfiguration/identityCertificateForClientAuthentication/deviceStatusOverview
PATCH /deviceManagement/deviceConfigurations/{deviceConfigurationId}/microsoft.graph.windowsWifiEnterpriseEAPConfiguration/rootCertificatesForServerValidation/{windows81TrustedRootCertificateId}/deviceStatusOverview
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, especifique una representación JSON del objeto deviceConfigurationDeviceOverview.
En la tabla siguiente se muestran las propiedades necesarias para crear el objeto deviceConfigurationDeviceOverview.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Clave de la entidad. |
| pendingCount | Int32 | Número de dispositivos pendientes |
| notApplicableCount | Int32 | Número de dispositivos no aplicables |
| notApplicablePlatformCount | Int32 | Número de dispositivos no aplicables debido a una plataforma y directiva no coincidentes |
| successCount | Int32 | Número de dispositivos correctos |
| errorCount | Int32 | Número de dispositivos con error |
| failedCount | Int32 | Número de dispositivos erróneos |
| conflictCount | Int32 | Número de dispositivos en conflicto |
| lastUpdateDateTime | DateTimeOffset | Última hora de actualización |
| configurationVersion | Int32 | Versión de la directiva para esa información general |
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y un objeto deviceConfigurationDeviceOverview actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurations/{deviceConfigurationId}/deviceStatusOverview
Content-type: application/json
Content-length: 345
{
"@odata.type": "#microsoft.graph.deviceConfigurationDeviceOverview",
"pendingCount": 12,
"notApplicableCount": 2,
"notApplicablePlatformCount": 10,
"successCount": 12,
"errorCount": 10,
"failedCount": 11,
"conflictCount": 13,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
"configurationVersion": 4
}
Respuesta
Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 394
{
"@odata.type": "#microsoft.graph.deviceConfigurationDeviceOverview",
"id": "62d48e3a-8e3a-62d4-3a8e-d4623a8ed462",
"pendingCount": 12,
"notApplicableCount": 2,
"notApplicablePlatformCount": 10,
"successCount": 12,
"errorCount": 10,
"failedCount": 11,
"conflictCount": 13,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
"configurationVersion": 4
}