remoteActionAudit erstellen

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Erstellen Sie ein neues remoteActionAudit-Objekt .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Weltweiter Service	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	✅

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

HTTP-Anforderung

POST /deviceManagement/remoteActionAudits

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung für das remoteActionAudit-Objekt an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von remoteActionAudit erforderlich sind.

Eigenschaft	Typ	Beschreibung
id	String	Berichts-ID.
deviceDisplayName	String	Intune Gerätename.
userName	String	[veraltet] Verwenden Sie stattdessen InitiatedByUserPrincipalName.
initiatedByUserPrincipalName	String	Benutzer, der die Geräteaktion initiiert hat, Format ist UPN.
Aktion	remoteAction	Der Aktionsname. Mögliche Werte sind: unknown, factoryReset, removeCompanyData, resetPasscode, remoteLock, , disableLostModerecoverPasscodeinitiateOnDemandProactiveRemediationcleanWindowsDevicedeletequickScanchangeAssignmentsfullScaninitiateDeviceAttestationlogoutSharedAppleDeviceActiveUserpauseConfigurationRefreshwindowsDefenderUpdateSignaturesrebootNowreenablefactoryResetKeepEnrollmentDatamoveDeviceToOrganizationalUnitupdateDeviceAccountinitiateMobileDeviceManagementKeyRecoveryrevokeAppleVppLicensesdisableremoveDeviceFirmwareConfigurationInterfaceManagementlaunchRemoteHelpunknownFutureValuerotateLocalAdminPassworddeprovisionactivateDeviceEsimsetDeviceNamegetFileVaultKeyrotateBitLockerKeysautomaticRedeploymentrotateFileVaultKeyenableLostModelocateDeviceshutDown.
requestDateTime	DateTimeOffset	Zeitpunkt, zu dem die Aktion ausgegeben wurde, angegeben in UTC.
deviceOwnerUserPrincipalName	String	Upn des Gerätebesitzers.
deviceIMEI	String	IMEI des Geräts.
actionState	actionState	Aktionszustand. Mögliche Werte: none, pending, canceled, active, done, failed, notSupported.
managedDeviceId	String	Aktionsziel.
deviceActionDetails	keyValuePair_2OfString_String-Sammlung	DeviceAction-Details
deviceActionCategory	deviceActionCategory	DeviceAction-Kategorie. Mögliche Werte sind: single und bulk.
bulkDeviceActionId	String	BulkAction-ID

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein remoteActionAudit-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

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

{
  "@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",
  "deviceActionDetails": [
    {
      "@odata.type": "microsoft.graph.keyValuePair_2OfString_String"
    }
  ],
  "deviceActionCategory": "bulk",
  "bulkDeviceActionId": "Bulk Device Action Id value"
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 762

{
  "@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",
  "deviceActionDetails": [
    {
      "@odata.type": "microsoft.graph.keyValuePair_2OfString_String"
    }
  ],
  "deviceActionCategory": "bulk",
  "bulkDeviceActionId": "Bulk Device Action Id value"
}