Atualizar malwareStateForWindowsDevice

Namespace: microsoft.graph

Importante: As GRAPH da 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.

Atualize as propriedades de um objeto malwareStateForWindowsDevice.

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
Delegado (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

Solicitação HTTP

PATCH /deviceManagement/windowsMalwareInformation/{windowsMalwareInformationId}/deviceMalwareStates/{malwareStateForWindowsDeviceId}

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 malwareStateForWindowsDevice.

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

Propriedade	Tipo	Descrição
id	String	O Identificador exclusivo. Esta é a ID do dispositivo.
deviceName	String	Nome do dispositivo
executionState	windowsMalwareExecutionState	Status de execução do malware como bloqueado/executando etc. Os valores possíveis são: unknown , , , , blocked allowed running notRunning .
threatState	windowsMalwareThreatState	Status de ameaça do malware como limpo/colocado em quarentena/permitido etc. Os valores possíveis active são: actionFailed , , , , , , , , , manualStepsRequired , , fullScanRequired rebootRequired remediatedWithNonCriticalFailures quarantined removed cleaned allowed noStatusCleared .
initialDetectionDateTime	DateTimeOffset	Tempo de data de detecção inicial do malware
lastStateChangeDateTime	DateTimeOffset	A última vez que essa ameaça específica foi alterada
detectionCount	Int32	Número de vezes que o malware é detectado

Resposta

Se tiver êxito, este método retornará um código de resposta e um 200 OK objeto malwareStateForWindowsDevice atualizado no corpo da resposta.

Exemplo

Solicitação

Este é um exemplo da solicitação.

PATCH https://graph.microsoft.com/beta/deviceManagement/windowsMalwareInformation/{windowsMalwareInformationId}/deviceMalwareStates/{malwareStateForWindowsDeviceId}
Content-type: application/json
Content-length: 334

{
  "@odata.type": "#microsoft.graph.malwareStateForWindowsDevice",
  "deviceName": "Device Name value",
  "executionState": "blocked",
  "threatState": "actionFailed",
  "initialDetectionDateTime": "2016-12-31T23:57:05.3889692-08:00",
  "lastStateChangeDateTime": "2016-12-31T23:59:51.0767794-08:00",
  "detectionCount": 14
}

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

{
  "@odata.type": "#microsoft.graph.malwareStateForWindowsDevice",
  "id": "ce06da73-da73-ce06-73da-06ce73da06ce",
  "deviceName": "Device Name value",
  "executionState": "blocked",
  "threatState": "actionFailed",
  "initialDetectionDateTime": "2016-12-31T23:57:05.3889692-08:00",
  "lastStateChangeDateTime": "2016-12-31T23:59:51.0767794-08:00",
  "detectionCount": 14
}