Criar remoteActionAudit

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.

Crie um novo objeto remoteActionAudit.

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

POST /deviceManagement/remoteActionAudits

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

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

Propriedade	Tipo	Descrição
id	String	ID do relatório.
deviceDisplayName	Cadeia de caracteres	Nome do dispositivo do Intune.
userName	Cadeia de caracteres	[preterido ] Use InitiatedByUserPrincipalName em vez disso.
initiatedByUserPrincipalName	String	Usuário que iniciou a ação do dispositivo, o formato é UPN.
ação	remoteAction	O nome da ação. Os valores possíveis são: unknown , , , , , , , , factoryReset removeCompanyData , resetPasscode , remoteLock enableLostMode disableLostMode locateDevice rebootNow recoverPasscode cleanWindowsDevice logoutSharedAppleDeviceActiveUser quickScan fullScan , windowsDefenderUpdateSignatures factoryResetKeepEnrollmentData updateDeviceAccount automaticRedeployment shutDown rotateBitLockerKeys rotateFileVaultKey getFileVaultKey setDeviceName activateDeviceEsim .
requestDateTime	DateTimeOffset	Hora em que a ação foi emitida, dada em UTC.
deviceOwnerUserPrincipalName	String	Upn do proprietário do dispositivo.
deviceIMEI	String	IMEI do dispositivo.
actionState	actionState	Estado da ação. Os valores possíveis são: none, pending, canceled, active, done, failed, notSupported.
managedDeviceId	String	Destino da ação.

Resposta

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

Exemplo

Solicitação

Este é um exemplo da solicitação.

POST https://graph.microsoft.com/beta/deviceManagement/remoteActionAudits
Content-type: application/json
Content-length: 504

{
  "@odata.type": "#microsoft.graph.remoteActionAudit",
  "deviceDisplayName": "Device Display Name value",
  "userName": "User Name value",
  "initiatedByUserPrincipalName": "Initiated By User Principal Name value",
  "action": "factoryReset",
  "requestDateTime": "2017-01-01T00:03:07.1589002-08:00",
  "deviceOwnerUserPrincipalName": "Device Owner User Principal Name value",
  "deviceIMEI": "Device IMEI value",
  "actionState": "pending",
  "managedDeviceId": "Managed Device Id 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: 553

{
  "@odata.type": "#microsoft.graph.remoteActionAudit",
  "id": "477f8d24-8d24-477f-248d-7f47248d7f47",
  "deviceDisplayName": "Device Display Name value",
  "userName": "User Name value",
  "initiatedByUserPrincipalName": "Initiated By User Principal Name value",
  "action": "factoryReset",
  "requestDateTime": "2017-01-01T00:03:07.1589002-08:00",
  "deviceOwnerUserPrincipalName": "Device Owner User Principal Name value",
  "deviceIMEI": "Device IMEI value",
  "actionState": "pending",
  "managedDeviceId": "Managed Device Id value"
}