Atualizar deviceManagementScriptDeviceStateUpdate deviceManagementScriptDeviceState

Namespace: microsoft.graphNamespace: microsoft.graph

Importante: As APIs do Microsoft Graph na versão/beta estão sujeitas a alterações; Não há suporte para o uso de produção.Important: Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.Note: The Microsoft Graph API for Intune requires an active Intune license for the tenant.

Atualiza as propriedades de um objeto deviceManagementScriptDeviceState .Update the properties of a deviceManagementScriptDeviceState object.

Pré-requisitosPrerequisites

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (de privilégios máximos a mínimos)Permissions (from most to least privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All
Delegada (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication DeviceManagementManagedDevices.ReadWrite.AllDeviceManagementManagedDevices.ReadWrite.All

Solicitação HTTPHTTP Request

PATCH /deviceManagement/deviceShellScripts/{deviceShellScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/userRunStates/{deviceManagementScriptUserStateId}/deviceRunStates/{deviceManagementScriptDeviceStateId}

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization <Token> de portador obrigatório.Bearer <token> Required.
AceitarAccept application/jsonapplication/json

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON do objeto deviceManagementScriptDeviceState .In the request body, supply a JSON representation for the deviceManagementScriptDeviceState object.

A tabela a seguir mostra as propriedades que são necessárias ao criar deviceManagementScriptDeviceState.The following table shows the properties that are required when you create the deviceManagementScriptDeviceState.

PropriedadeProperty TipoType DescriçãoDescription
idid Cadeia de caracteresString Chave da entidade de estado do dispositivo de script de gerenciamento de dispositivos.Key of the device management script device state entity. Essa propriedade é somente leitura.This property is read-only.
runStaterunState runStaterunState Estado da última execução do script de gerenciamento de dispositivos.State of latest run of the device management script. Os possíveis valores são: unknown, success, fail, scriptError, pending, notApplicable.Possible values are: unknown, success, fail, scriptError, pending, notApplicable.
resultMessageresultMessage Cadeia de caracteresString Detalhes da saída de execução.Details of execution output.
lastStateUpdateDateTimelastStateUpdateDateTime DateTimeOffsetDateTimeOffset Última vez em que o script de gerenciamento de dispositivos é executado.Latest time the device management script executes.
errorCodeerrorCode Int32Int32 Código de erro correspondente à execução errada do script de gerenciamento de dispositivos.Error code corresponding to erroneous execution of the device management script.
errorDescriptionerrorDescription Cadeia de caracteresString Descrição do erro correspondente à execução errada do script de gerenciamento de dispositivo.Error description corresponding to erroneous execution of the device management script.

RespostaResponse

Se tiver êxito, este método retornará um 200 OK código de resposta e um objeto deviceManagementScriptDeviceState atualizado no corpo da resposta.If successful, this method returns a 200 OK response code and an updated deviceManagementScriptDeviceState object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceShellScripts/{deviceShellScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}
Content-type: application/json
Content-length: 281

{
  "@odata.type": "#microsoft.graph.deviceManagementScriptDeviceState",
  "runState": "success",
  "resultMessage": "Result Message value",
  "lastStateUpdateDateTime": "2017-01-01T00:02:58.4418045-08:00",
  "errorCode": 9,
  "errorDescription": "Error Description value"
}

RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada 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: 330

{
  "@odata.type": "#microsoft.graph.deviceManagementScriptDeviceState",
  "id": "39440cba-0cba-3944-ba0c-4439ba0c4439",
  "runState": "success",
  "resultMessage": "Result Message value",
  "lastStateUpdateDateTime": "2017-01-01T00:02:58.4418045-08:00",
  "errorCode": 9,
  "errorDescription": "Error Description value"
}