Compartilhar via

Criar deviceComplianceScriptDeviceState

  • Artigo

Namespace: microsoft.graph

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

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

Crie um novo objeto deviceComplianceScriptDeviceState .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Uma das seguintes permissões é necessá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
Delegado (conta pessoal da Microsoft) Sem suporte.
Application DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

Solicitação HTTP

POST /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Aceitar application/json

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON para o objeto deviceComplianceScriptDeviceState.

A tabela seguinte mostra as propriedades necessárias quando cria o deviceComplianceScriptDeviceState.

Propriedade Tipo Descrição
id Cadeia de caracteres Chave da entidade de estado do dispositivo do script de conformidade do dispositivo. Essa propriedade é somente leitura.
detectionState runState Estado de deteção da última execução do script de conformidade do dispositivo. Os possíveis valores são: unknown, success, fail, scriptError, pending, notApplicable.
lastStateUpdateDateTime DateTimeOffset O último carimbo de data/hora de quando o script de conformidade do dispositivo foi executado
expectedStateUpdateDateTime DateTimeOffset O próximo carimbo de data/hora de quando se espera que o script de conformidade do dispositivo seja executado
lastSyncDateTime DateTimeOffset A última vez que Intune Extensão de Gestão foi sincronizada com Intune
scriptOutput Cadeia de caracteres Saída do script de deteção
scriptError Cadeia de caracteres Erro do script de deteção

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto deviceComplianceScriptDeviceState no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates
Content-type: application/json
Content-length: 387

{
  "@odata.type": "#microsoft.graph.deviceComplianceScriptDeviceState",
  "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",
  "scriptOutput": "Script Output value",
  "scriptError": "Script Error 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: 436

{
  "@odata.type": "#microsoft.graph.deviceComplianceScriptDeviceState",
  "id": "7bd39c86-9c86-7bd3-869c-d37b869cd37b",
  "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",
  "scriptOutput": "Script Output value",
  "scriptError": "Script Error value"
}