Microsoft Sentinel
Cloud and workloads

Watchlists Queries

In brief

The documentation now includes Microsoft Defender ISOC menu paths for accessing Watchlists and Analytics, alongside the existing Sentinel portal paths.

What Defender admins need to know

Admins using ISOC can follow the documented paths to find these settings; no action is required.

Summaries are generated from the documentation change itself.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

To use a watchlist in a search query, write a Kusto Query Language (KQL) query that uses the _GetWatchlist('watchlist-name') function and uses SearchKey as the key for your join.

  1. For Microsoft Sentinel in the Defender portal, select Microsoft Sentinel > Configuration > Watchlist. For ISOC in Microsoft Defender, select Setup & configuration > Data management > Watchlist. For Microsoft Sentinel in the Azure portal, under Configuration, select Watchlist.
  2. Select the watchlist you want to use.
  3. Select View in Logs.

The _GetWatchlist('watchlist-name') function returns the contents of a specified watchlist so you can reference watchlist data directly in a query. To use watchlists in analytics rules, create a rule that includes this function in the rule query.

  1. UnderFor Microsoft Sentinel in the Defender portal, select Microsoft Sentinel > Configuration > Analytics. For ISOC in Microsoft Defender, select Investigation & response > Detection > Analytics. For Microsoft Sentinel in the Azure portal, under Configuration, select Analytics.
  2. Select Create and the type of rule you want to create.
  3. On the General tab, enter the appropriate information.
  4. On the Set rule logic tab, under Rule query use the _GetWatchlist('<watchlist>') function in the query.