Crear deviceComplianceSettingStateCreate deviceComplianceSettingState

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Cree un objeto deviceComplianceSettingState.Create a new deviceComplianceSettingState object.

Requisitos previosPrerequisites

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de más a menos privilegiados)Permissions (from most to least privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) DeviceManagementConfiguration.ReadWrite.AllDeviceManagementConfiguration.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication No admitida.Not supported.

Solicitud HTTPHTTP Request

POST /deviceManagement/deviceCompliancePolicySettingStateSummaries/{deviceCompliancePolicySettingStateSummaryId}/deviceComplianceSettingStates

Encabezados de solicitudRequest headers

EncabezadoHeader ValorValue
AuthorizationAuthorization Se requiere <token> de portador.Bearer <token> Required.
AceptarAccept application/jsonapplication/json

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, especifique una representación JSON del objeto deviceComplianceSettingState.In the request body, supply a JSON representation for the deviceComplianceSettingState object.

En la tabla siguiente se muestran las propiedades necesarias para crear el objeto deviceComplianceSettingState.The following table shows the properties that are required when you create the deviceComplianceSettingState.

PropiedadProperty TipoType DescripciónDescription
idid CadenaString Clave de la entidadKey of the entity
ajustessetting CadenaString El nombre de la clase de configuración y el nombre de propiedad.The setting class name and property name.
settingNamesettingName CadenaString El nombre de configuración que se está notificandoThe Setting Name that is being reported
deviceIddeviceId CadenaString El identificador del dispositivo que se está notificandoThe Device Id that is being reported
deviceNamedeviceName CadenaString El nombre del dispositivo que se está notificandoThe Device Name that is being reported
userIduserId CadenaString El identificador del usuario que se está notificandoThe user Id that is being reported
userEmailuserEmail CadenaString La dirección de correo electrónico del usuario que se está notificandoThe User email address that is being reported
userNameuserName CadenaString El nombre de usuario que se está notificandoThe User Name that is being reported
userPrincipalNameuserPrincipalName CadenaString El nombre principal de usuario que se está notificandoThe User PrincipalName that is being reported
deviceModeldeviceModel CadenaString El modelo de dispositivo que se está notificandoThe device model that is being reported
statestate complianceStatuscomplianceStatus El estado de cumplimiento de la configuración.The compliance state of the setting. Los valores posibles son: unknown, notApplicable, compliant, remediated, nonCompliant, error, conflict y notAssigned.Possible values are: unknown, notApplicable, compliant, remediated, nonCompliant, error, conflict, notAssigned.
complianceGracePeriodExpirationDateTimecomplianceGracePeriodExpirationDateTime DateTimeOffsetDateTimeOffset La fecha y hora en que expira el período de gracia de cumplimiento del dispositivoThe DateTime when device compliance grace period expires

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un código de respuesta 201 Created y un objeto deviceComplianceSettingState en el cuerpo de la respuesta.If successful, this method returns a 201 Created response code and a deviceComplianceSettingState object in the response body.

EjemploExample

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

POST https://graph.microsoft.com/v1.0/deviceManagement/deviceCompliancePolicySettingStateSummaries/{deviceCompliancePolicySettingStateSummaryId}/deviceComplianceSettingStates
Content-type: application/json
Content-length: 517

{
  "@odata.type": "#microsoft.graph.deviceComplianceSettingState",
  "setting": "Setting value",
  "settingName": "Setting Name value",
  "deviceId": "Device Id value",
  "deviceName": "Device Name value",
  "userId": "User Id value",
  "userEmail": "User Email value",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "deviceModel": "Device Model value",
  "state": "notApplicable",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00"
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta. Nota: Puede que el objeto de respuesta que aparece aquí se trunque para abreviar. Todas las propiedades se devolverán de una llamada real.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 566

{
  "@odata.type": "#microsoft.graph.deviceComplianceSettingState",
  "id": "9905f955-f955-9905-55f9-059955f90599",
  "setting": "Setting value",
  "settingName": "Setting Name value",
  "deviceId": "Device Id value",
  "deviceName": "Device Name value",
  "userId": "User Id value",
  "userEmail": "User Email value",
  "userName": "User Name value",
  "userPrincipalName": "User Principal Name value",
  "deviceModel": "Device Model value",
  "state": "notApplicable",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00"
}