Criar deviceManagementScriptDeviceState

Namespace: microsoft.graph

Importante: As APIs Graph Microsoft na versão /beta estão sujeitas a alterações; o uso de produção não é suportado.

Observação: A API do Microsoft Graph para Intune requer uma licença ativa do Intune para o locatário.

Crie um novo objeto deviceManagementScriptDeviceState .

Pré-requisitos

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All
Delegada (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/deviceShellScripts/{deviceShellScriptId}/deviceRunStates
POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates
POST /deviceManagement/deviceCustomAttributeShellScripts/{deviceCustomAttributeShellScriptId}/deviceRunStates
POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/userRunStates/{deviceManagementScriptUserStateId}/deviceRunStates

Cabeçalhos de solicitação

Cabeçalho	Valor
Autorização	<Token> de portador obrigatório.
Aceitar	application/json

Corpo da solicitação

No corpo da solicitação, fornece uma representação JSON para o objeto deviceManagementScriptDeviceState.

A tabela a seguir mostra as propriedades que são necessárias ao criar deviceManagementScriptDeviceState.

Propriedade	Tipo	Descrição
id	String	Chave da entidade de estado do dispositivo de script de gerenciamento de dispositivo. Essa propriedade é somente leitura.
runState	runState	Estado da última versão do script de gerenciamento de dispositivos. Os possíveis valores são: unknown, success, fail, scriptError, pending, notApplicable.
resultMessage	String	Detalhes da saída de execução.
lastStateUpdateDateTime	DateTimeOffset	Última hora em que o script de gerenciamento de dispositivos é executado.
errorCode	Int32	Código de erro correspondente à execução errônea do script de gerenciamento de dispositivo.
errorDescription	Cadeia de caracteres	Descrição de erro correspondente à execução errônea do script de gerenciamento de dispositivo.

Resposta

Se tiver êxito, este método retornará 201 Created um código de resposta e um objeto deviceManagementScriptDeviceState no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/deviceShellScripts/{deviceShellScriptId}/deviceRunStates
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"
}

Resposta

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.

HTTP/1.1 201 Created
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"
}