Actualizar deviceHealthScriptDeviceStateUpdate deviceHealthScriptDeviceState

Espacio de nombres: microsoft.graphNamespace: 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.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

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.

Actualice las propiedades de un objeto deviceHealthScriptDeviceState .Update the properties of a deviceHealthScriptDeviceState 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.All, DeviceManagementConfiguration.Read.AllDeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication DeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.AllDeviceManagementConfiguration.ReadWrite.All, DeviceManagementConfiguration.Read.All

Solicitud HTTPHTTP Request

PATCH /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}

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 deviceHealthScriptDeviceState .In the request body, supply a JSON representation for the deviceHealthScriptDeviceState object.

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

PropiedadProperty TipoType DescripciónDescription
idid CadenaString Clave de la entidad de estado del dispositivo de script de mantenimiento de dispositivos.Key of the device health script device state entity. Esta propiedad es de sólo lectura.This property is read-only.
detectionStatedetectionState runStaterunState Estado de detección de la ejecución más reciente del script de mantenimiento de dispositivos.Detection state from the lastest device health script execution. Los valores posibles son: unknown, success, fail, scriptError, pending, notApplicable.Possible values are: unknown, success, fail, scriptError, pending, notApplicable.
lastStateUpdateDateTimelastStateUpdateDateTime DateTimeOffsetDateTimeOffset La última marca de hora del momento en que se ejecutó el script de estado del dispositivoThe last timestamp of when the device health script executed
expectedStateUpdateDateTimeexpectedStateUpdateDateTime DateTimeOffsetDateTimeOffset La siguiente marca de hora de Cuándo se espera que se ejecute el script de mantenimiento del dispositivoThe next timestamp of when the device health script is expected to execute
lastSyncDateTimelastSyncDateTime DateTimeOffsetDateTimeOffset La última vez que la extensión de administración de Intune se sincronizó con IntuneThe last time that Intune Managment Extension synced with Intune
preRemediationDetectionScriptOutputpreRemediationDetectionScriptOutput CadenaString Salida del script de detección antes de la correcciónOutput of the detection script before remediation
preRemediationDetectionScriptErrorpreRemediationDetectionScriptError CadenaString Error del script de detección antes de la correcciónError from the detection script before remediation
remediationScriptErrorremediationScriptError CadenaString Salida de error del script de correcciónError output of the remediation script
postRemediationDetectionScriptOutputpostRemediationDetectionScriptOutput CadenaString Salida de script de detección tras correcciónDetection script output after remediation
postRemediationDetectionScriptErrorpostRemediationDetectionScriptError CadenaString Error del script de detección tras la correcciónError from the detection script after remediation
remediationStateremediationState remediationStateremediationState Estado de corrección de la ejecución más reciente del script de mantenimiento de dispositivos.Remediation state from the lastest device health script execution. Los valores posibles son: unknown, skipped, success, remediationFailed y scriptError.Possible values are: unknown, skipped, success, remediationFailed, scriptError.

RespuestaResponse

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

EjemploExample

SolicitudRequest

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

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}
Content-type: application/json
Content-length: 762

{
  "@odata.type": "#microsoft.graph.deviceHealthScriptDeviceState",
  "detectionState": "success",
  "lastStateUpdateDateTime": "2017-01-01T00:02:58.4418045-08:00",
  "expectedStateUpdateDateTime": "2016-12-31T23:58:26.9294641-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "preRemediationDetectionScriptOutput": "Pre Remediation Detection Script Output value",
  "preRemediationDetectionScriptError": "Pre Remediation Detection Script Error value",
  "remediationScriptError": "Remediation Script Error value",
  "postRemediationDetectionScriptOutput": "Post Remediation Detection Script Output value",
  "postRemediationDetectionScriptError": "Post Remediation Detection Script Error value",
  "remediationState": "skipped"
}

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 200 OK
Content-Type: application/json
Content-Length: 811

{
  "@odata.type": "#microsoft.graph.deviceHealthScriptDeviceState",
  "id": "fd2e4505-4505-fd2e-0545-2efd05452efd",
  "detectionState": "success",
  "lastStateUpdateDateTime": "2017-01-01T00:02:58.4418045-08:00",
  "expectedStateUpdateDateTime": "2016-12-31T23:58:26.9294641-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "preRemediationDetectionScriptOutput": "Pre Remediation Detection Script Output value",
  "preRemediationDetectionScriptError": "Pre Remediation Detection Script Error value",
  "remediationScriptError": "Remediation Script Error value",
  "postRemediationDetectionScriptOutput": "Post Remediation Detection Script Output value",
  "postRemediationDetectionScriptError": "Post Remediation Detection Script Error value",
  "remediationState": "skipped"
}