Actualizar deviceConfigurationUserStateSummary
Espacio de nombres: microsoft.graph
Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Actualice las propiedades de un objeto deviceConfigurationUserStateSummary .
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/deviceConfigurationUserStateSummaries
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, proporcione una representación JSON para el objeto deviceConfigurationUserStateSummary .
En la tabla siguiente se muestran las propiedades necesarias al crear el deviceConfigurationUserStateSummary.
Propiedad | Tipo | Descripción |
---|---|---|
id | Cadena | Clave de la entidad. |
unknownUserCount | Int32 | Número de usuarios desconocidos |
notApplicableUserCount | Int32 | Número de usuarios no aplicables |
compliantUserCount | Int32 | Número de usuarios compatibles |
remediatedUserCount | Int32 | Número de usuarios corregidos |
nonCompliantUserCount | Int32 | Número de usuarios no conformes |
errorUserCount | Int32 | Número de usuarios de error |
conflictUserCount | Int32 | Número de usuarios en conflicto |
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK
código de respuesta y un objeto deviceConfigurationUserStateSummary actualizado en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceConfigurationUserStateSummaries
Content-type: application/json
Content-length: 275
{
"@odata.type": "#microsoft.graph.deviceConfigurationUserStateSummary",
"unknownUserCount": 0,
"notApplicableUserCount": 6,
"compliantUserCount": 2,
"remediatedUserCount": 3,
"nonCompliantUserCount": 5,
"errorUserCount": 14,
"conflictUserCount": 1
}
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: 324
{
"@odata.type": "#microsoft.graph.deviceConfigurationUserStateSummary",
"id": "e8957887-7887-e895-8778-95e8877895e8",
"unknownUserCount": 0,
"notApplicableUserCount": 6,
"compliantUserCount": 2,
"remediatedUserCount": 3,
"nonCompliantUserCount": 5,
"errorUserCount": 14,
"conflictUserCount": 1
}