Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Important
Some information in this article relates to a prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, expressed or implied, with respect to the information provided here.
The advanced hunting schema is updated regularly to add new tables and columns. In some cases, existing columns names are renamed or replaced to improve the user experience. Refer to this article to review naming changes that could impact your queries.
Naming changes are automatically applied to queries that are saved in Microsoft Defender XDR, including queries used by custom detection rules. You don't need to update these queries manually. However, you will need to update the following queries:
- Queries that are run using the API
- Queries that are saved elsewhere outside Microsoft Defender XDR
June 2026
The
AIAgentsInfotable is transitioning to theAgentsInfotable. TheAIAgentsInfotable was originally built for Copilot Studio scenarios, and many of its columns were specific to that platform. The newAgentsInfotable provides a unified schema that supports agent inventory and governance for all agent types, including Copilot Studio, Microsoft Foundry, Microsoft 365 Copilot, third-party agents, and endpoint-discovered agents. Microsoft Agent 365 customers should use theAgentsInfotable today.Key changes in the new table include expanded coverage for agent identity, authentication, permissions, lifecycle, and configuration. The new schema also includes a
RawAgentInfocolumn that stores additional agent data in JSON format, ensuring no data loss as the schema evolves.To prepare for this change:
- Update your advanced hunting queries to use the
AgentsInfotable instead ofAIAgentsInfo. - Review and update any filters, projections, or joins that reference
AIAgentsInfocolumn names, as column names have changed in the new table. - Update any queries run through the API or saved outside Microsoft Defender XDR. Saved queries in Microsoft Defender XDR, including custom detection rules, are updated automatically.
The
AIAgentsInfotable remains accessible until July 1, 2026, to allow time for migration.- Update your advanced hunting queries to use the
November 2025
The Boolean field values in advanced hunting results will change from numeric (
1and0) to textual (TrueandFalse) on February 25, 2026. While your queries and custom detection rules won't be affected by this change, you might want to update your automated processes (for example, scripts, playbooks, or integrations) parsing these values.The
AADSignInEventsBetaandAADSpnSignInEventsBetatables are being replaced byEntraIdSignInEventsandEntraIdSpnSignInEvents, respectively. These changes are being made to remove the former tables' preview status and to align them with the existing product branding.The
EntraIdSignInEventsandEntraIdSpnSignInEventstables are now available. The legacyAADSignInEventsBetaandAADSpnSignInEventsBetatables will remain in the schema for 30 days to allow time for updating your queries. Your custom detections will be updated automatically and won't require any changes. On December 9, 2025,AADSignInEventsBetaandAADSpnSignInEventsBetawill be removed from the schema.
September 2025
In the AADSignInEventsBeta table, the AadDeviceId column is being replaced with a new column, called EntraIdDeviceId, to align with current product branding. The legacy AadDeviceId column will remain in the schema for 30 days to allow time for updating in your queries. After this period of 30 days, AadDeviceId will be removed from the schema.
May 2025
In the IdentityInfo table, the SourceProvider column was replaced by the IdentityEnvironment column. This change was made to streamline the unified IdentityInfo table with a similar table in Microsoft Sentinel log analytics. Note that a new column, SourceProviders (with an s) was added in the unified table. This column refers to the source providers of the accounts for the identity.
May 2021
The AppFileEvents table has been deprecated. The CloudAppEvents table includes information that used to be in the AppFileEvents table, along with other activities in cloud services.
March 2021
The DeviceTvmSoftwareInventoryVulnerabilities table has been deprecated. Replacing it are the DeviceTvmSoftwareInventory and DeviceTvmSoftwareVulnerabilities tables.
February 2021
In the EmailAttachmentInfo and EmailEvents tables, the
MalwareFilterVerdictandPhishFilterVerdictcolumns have been replaced by theThreatTypescolumn. TheMalwareDetectionMethodandPhishDetectionMethodcolumns were also replaced by theDetectionMethodscolumn. This streamlining allows us to provide more information under the new columns. The mapping is provided below.Table name Original column name New column name Reason for change EmailAttachmentInfoMalwareDetectionMethod
PhishDetectionMethodDetectionMethodsInclude more detection methods EmailAttachmentInfoMalwareFilterVerdictPhishFilterVerdictThreatTypesInclude more threat types EmailEventsMalwareDetectionMethod
PhishDetectionMethodDetectionMethodsInclude more detection methods EmailEventsMalwareFilterVerdictPhishFilterVerdictThreatTypesInclude more threat types In the
EmailAttachmentInfoandEmailEventstables, theThreatNamescolumn was added to give more information about the email threat. This column contains values like Spam or Phish.In the DeviceInfo table, the
DeviceObjectIdcolumn was replaced by theAadDeviceIdcolumn based on customer feedback.In the DeviceEvents table, several ActionType names were modified to better reflect the description of the action. Details of the changes can be found below.
Table name Original ActionType name New ActionType name Reason for change DeviceEventsUsbDriveMountUsbDriveMountedCustomer feedback DeviceEventsUsbDriveUnmountUsbDriveUnmountedCustomer feedback DeviceEventsWriteProcessMemoryApiCallWriteToLsassProcessMemoryCustomer feedback
January 2021
| Column name | Original value name | New value name | Reason for change |
|---|---|---|---|
DetectionSource |
Defender for Cloud Apps | Microsoft Defender for Cloud Apps | Rebranding |
DetectionSource |
WindowsDefenderAtp | EDR | Rebranding |
DetectionSource |
WindowsDefenderAv | Antivirus | Rebranding |
DetectionSource |
WindowsDefenderSmartScreen | SmartScreen | Rebranding |
DetectionSource |
CustomerTI | Custom TI | Rebranding |
DetectionSource |
OfficeATP | Microsoft Defender for Office 365 | Rebranding |
DetectionSource |
MTP | Microsoft Defender XDR | Rebranding |
DetectionSource |
AzureATP | Microsoft Defender for Identity | Rebranding |
DetectionSource |
CustomDetection | Custom detection | Rebranding |
DetectionSource |
AutomatedInvestigation | Automated investigation | Rebranding |
DetectionSource |
ThreatExperts | Microsoft Threat Experts | Rebranding |
DetectionSource |
3rd party TI | 3rd Party sensors | Rebranding |
ServiceSource |
Microsoft Defender ATP | Microsoft Defender for Endpoint | Rebranding |
ServiceSource |
Microsoft Threat Protection | Microsoft Defender XDR | Rebranding |
ServiceSource |
Office 365 ATP | Microsoft Defender for Office 365 | Rebranding |
ServiceSource |
Azure ATP | Microsoft Defender for Identity | Rebranding |
DetectionSource is available in the AlertInfo table. ServiceSource is available in the AlertEvidence and AlertInfo tables.
December 2020
| Table name | Original column name | New column name | Reason for change |
|---|---|---|---|
| EmailEvents | FinalEmailAction |
EmailAction |
Customer feedback |
| EmailEvents | FinalEmailActionPolicy |
EmailActionPolicy |
Customer feedback |
| EmailEvents | FinalEmailActionPolicyGuid |
EmailActionPolicyGuid |
Customer feedback |
Related topics
Tip
Do you want to learn more? Engage with the Microsoft Security community in our Tech Community: Microsoft Defender XDR Tech Community.