Skip to content

Commit d21f625

Browse files
Merge branch 'main' into automatic-windows-auditing
2 parents a005597 + d972674 commit d21f625

13 files changed

+85
-55
lines changed

defender-endpoint/enable-attack-surface-reduction.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -345,6 +345,10 @@ Example:
345345
> Don't use quotes as they aren't supported for either the **Value name** column or the **Value** column.
346346
> The rule ID shouldn't have any leading or trailing spaces.
347347
348+
> [!NOTE]
349+
> Microsoft rebranded Windows Defender Antivirus to Microsoft Defender Antivirus beginning with Windows 10 version 20H1.
350+
> Group Policy paths on earlier Windows versions may still reference Windows Defender Antivirus, while newer builds show Microsoft Defender Antivirus. Both names refer to the same policy location.
351+
348352
### PowerShell
349353

350354
> [!WARNING]
-4.86 KB
Binary file not shown.
-851 Bytes
Binary file not shown.

defender-endpoint/time-settings.md

Lines changed: 7 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
title: Microsoft Defender XDR time zone settings
3-
description: Use the info contained here to configure the Microsoft Defender XDR time zone settings and view license information.
3+
description: Use the info contained here to configure the Microsoft Defender XDR time zone settings.
44
ms.service: defender-endpoint
5-
ms.author: bagol
6-
author: batamig
5+
ms.author: painbar
6+
author: paulinbar
77
ms.localizationpriority: medium
88
manager: bagol
99
audience: ITPro
@@ -13,7 +13,7 @@ ms.collection:
1313
ms.topic: article
1414
ms.subservice: reference
1515
search.appverid: met150
16-
ms.date: 05/05/2025
16+
ms.date: 11/30/2025
1717
appliesto:
1818
- Microsoft Defender for Endpoint Plan 1
1919
- Microsoft Defender for Endpoint Plan 2
@@ -22,9 +22,7 @@ appliesto:
2222
# Microsoft Defender XDR time zone settings
2323

2424

25-
This article describes time zone settings and options. You can use **Time zone** menu to configure the time zone and view license information.
26-
27-
:::image type="content" source="media/atp-time-zone.png" alt-text="The Time zone settings-1" lightbox="media/atp-time-zone.png":::
25+
This article describes how to configure time zone settings and options.
2826

2927
> [!NOTE]
3028
> Changing the time zone setting in the [Microsoft Defender portal](https://security.microsoft.com) only affects how times are displayed. It doesn't affect the actual scheduling of operations, such as antivirus scans, which continue to follow the local system time or UTC settings, depending on how they're configured.
@@ -33,10 +31,6 @@ This article describes time zone settings and options. You can use **Time zone**
3331

3432
The aspect of time is important in the assessment and analysis of perceived and actual cyberattacks. Cyberforensic investigations often rely on time stamps to piece together the sequence of events. It's important that your system reflects the correct time zone settings. Defender for Endpoint can display either Coordinated Universal Time (UTC) or local time.
3533

36-
Your current time zone setting is shown in the **Timezone** menu in the Microsoft Defender portal.
37-
38-
:::image type="content" source="media/atp-time-zone-menu.png" alt-text="The Time zone settings-2" lightbox="media/atp-time-zone-menu.png":::
39-
4034
### UTC time zone
4135

4236
Defender for Endpoint uses UTC time by default. Keeping this time zone displays all system timestamps (alerts, events, and others) in UTC for all users. This configuration can help security analysts working in different locations across the globe to use the same time stamps while investigating events.
@@ -55,13 +49,9 @@ The Defender for Endpoint time zone is set by default to UTC. Setting the time z
5549

5650
To set the time zone:
5751

58-
1. Select the **Time zone** menu.
59-
60-
:::image type="content" source="media/atp-time-zone.png" alt-text="The Time zone settings-3" lightbox="media/atp-time-zone.png":::
61-
62-
2. Select the **Timezone UTC** indicator.
52+
1. In the Microsoft Defender portal, go to **System** > **Settings** > **Microsoft Defender portal** > **Time zone**.
6353

64-
3. Select **Timezone UTC** or your local time zone, for example `-7:00`.
54+
1. In the **Time zone** drop down menu, select either UTC or your local time zone.
6555

6656
### Regional settings
6757

defender-for-cloud-apps/protect-salesforce.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,13 @@ Connecting Salesforce to Defender for Cloud Apps gives you improved insights int
2626
- Ransomware
2727
- Unmanaged bring your own device (BYOD)
2828

29+
30+
### Prerequisites
31+
32+
- Install and authorize the Salesforce Connected App in the target Salesforce org before you start the connection process. Salesforce enforces usage restrictions on Connected Apps. For more information, see:[Prepare for Connected App Usage Restrictions Change](https://help.salesforce.com/s/articleView?id=005132365&type=1)
33+
34+
- Assign the **Approve Uninstalled Connected Apps** permission to the Salesforce service account used to connect Microsoft Defender for Cloud Apps. Salesforce requires this permission to connect third-party apps via OAuth.
35+
2936
## How Defender for Cloud Apps helps to protect your environment
3037

3138
- [Detect cloud threats, compromised accounts, and malicious insiders](best-practices.md#detect-cloud-threats-compromised-accounts-malicious-insiders-and-ransomware)

defender-xdr/advanced-hunting-custom-functions.md

Lines changed: 45 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -36,39 +36,63 @@ ms.date: 03/28/2025
3636
> Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
3737
3838
## Types of functions
39-
A function is a type of query in advanced hunting that can be used in other queries as if it's a command. You can create your own custom functions so you can reuse any query logic when you hunt in your environment.
39+
A function is a type of query in advanced hunting that you can use in other queries as if it's a command. You can create your own custom functions so you can reuse any query logic when you hunt in your environment.
4040

4141
There are three different types of functions in advanced hunting:
4242

4343
![Function types](/defender/media/advanced-hunting-custom-fxns/function-types.png)
4444

45-
- **Built-in functions** – Prebuilt functions included with Microsoft Defender XDR advanced hunting. These are available in all advanced hunting instances and can't be modified.
46-
- **Shared functions** – Custom functions created by users, which are available for all users in a specific tenant and can be modified and controlled by users.
47-
- **My functions** – Custom functions created by a user, which can be viewed and modified only by the user who created it.
45+
- **Built-in functions** – Prebuilt functions included with Microsoft Defender XDR advanced hunting. These functions are available in all advanced hunting instances and can't be modified.
46+
- **Shared functions** – Custom functions that users create. All users in a specific tenant can access these functions. Users can modify and control these functions.
47+
- **My functions** – Custom functions that a user creates. Only the user who created these functions can view and modify them.
4848

4949
## Write your own custom function
5050

51-
To create a function from the current query in the editor, select **Save** and then **Save as function**.
51+
To create a function from the current query in the editor:
5252

53-
![Save as function](/defender/media/advanced-hunting-custom-fxns/save-as-function.png)
53+
1. Select **Save** and then **Save as function**.
54+
![Save as function](/defender/media/advanced-hunting-custom-fxns/save-as-function.png)
5455

55-
Next, provide the following information:
56+
1. In the **Save as function** flyout panel, provide the following information:
5657

57-
- **Name** - Name of the function. Can contain only numbers, English letters, and underscores. To avoid accidentally using Kusto keywords, begin or end function names with an underscore or begin with a capital letter.
58-
- **Location** - The folder in which you would like to save the function, either shared or private.
59-
- **Description** - A description that can help other users understand the purpose of the function and how it works.
60-
- **Parameters** - Add a parameter for each variable in the function that requires a value when it's used.
61-
Add parameters to a function so that you can provide the arguments or values for certain variables when calling the function. This allows the same function to be used in different queries, each allowing for different values for the parameters. Parameters are defined by the following properties:
58+
- **Name** - Name of the function. Can contain only numbers, English letters, and underscores. To avoid accidentally using Kusto keywords, begin or end function names with an underscore or begin with a capital letter.
59+
- **Location** - The folder in which you want to save the function, either shared or private.
60+
- **Description** - A description that helps other users understand the purpose of the function and how it works.
61+
- **Parameters** - Add a parameter for each variable in the function that requires a value when it's used. For more information, see [Add parameters to your custom function](#add-parameters-to-your-custom-function).
62+
63+
![Save as function dialog box](/defender/media/advanced-hunting-custom-fxns/save-as-function-dialog-box.png)
64+
65+
1. Select **Save**.
66+
67+
### Add parameters to your custom function
68+
69+
You can add parameters to a function so that you can provide the arguments or values for certain variables when calling the function. This feature allows the same function to be used in different queries, each with different values for the parameters.
70+
71+
To add parameters when saving your custom function, select **Add parameter**, then enter the following properties:
6272
- **Type** - Data type for the value
6373
- **Name** - The name that must be used in the query to replace the parameter value
64-
- **Default value** - Value to be used for the parameter if a value isn't provided
74+
- **Default value** - Value to use for the parameter if you don't provide a value
6575

66-
Parameters are listed in the order they were created, with parameters that have no default value listed above those that have a default value.
76+
Parameters are listed in the order you create them, with parameters that have no default value listed before those that have a default value.
6777

68-
![Save as function dialog box](/defender/media/advanced-hunting-custom-fxns/save-as-function-dialog-box.png)
78+
### Create custom functions with tabular parameters
6979

80+
Create custom functions that use tabular parameters. With tabular parameters, you can pass entire tables as inputs. This approach lets you build more modular, reusable, and expressive logic across your hunting queries. This capability is especially useful for complex hunting scenarios that require structured data inputs.
81+
82+
To create tabular parameters for your custom function:
83+
1. Select **Add parameter** and then choose **table** as its **Type**.
84+
1. Enter a **Name** and **Default value** for the table.
85+
1. Map each column that your query references to the table. Select **Add column**, then enter the column's properties.
86+
87+
![Table parameter in custom functions](/defender/media/advanced-hunting-custom-fxns/save-as-function-table.png)
88+
89+
> [!NOTE]
90+
>- You can save a function with more than one table.
91+
>- If your query doesn't reference any columns in the table parameter, you can still save and run the function without mapping any columns.
92+
>- You can set tabular and scalar parameters in the same function.
93+
7094
## Use a custom function
71-
Use a function in a query by typing its name along with values for any parameter just as you would type in a command. The output of the function can either be returned as results or piped to another command.
95+
Use a function in a query by typing its name along with values for any parameter, just as you would type in a command. The output of the function can either be returned as results or piped to another command.
7296

7397
Add a function to the current query by double-clicking on its name or selecting the three dots to the right of the function and selecting **Open in query editor**.
7498

@@ -77,27 +101,27 @@ If a query requires arguments, provide them using the following syntax: *functio
77101
![Open in query editor](/defender/media/advanced-hunting-custom-fxns/open-in-query-editor.png)
78102

79103
> [!NOTE]
80-
> Functions can't be used inside another function.
104+
> You can't use functions inside another function.
81105
82106
## Work with function codes
83-
You can view the code of a function either to gain insight into how it works or to modify its code. Select the three dots to the right of the function and select **Load function code** to open a new tab with the function code.
107+
You can view the code of a function to understand how it works or to modify its code. Select the three dots to the right of the function and select **Load function code** to open a new tab with the function code.
84108

85109
![Load function code](/defender/media/advanced-hunting-custom-fxns/load-function-code.png)
86110

87111
## Edit a custom function
88112

89-
Edit the properties of a function by selecting the three dots to the right of the function and selecting **Edit details**. Make any modifications that you want to the properties and parameters of the function then select **Save**.
113+
Edit the properties of a function by selecting the three dots to the right of the function and selecting **Edit details**. Make any modifications that you want to the properties and parameters of the function, then select **Save**.
90114

91115
![Edit function code](/defender/media/advanced-hunting-custom-fxns/edit-function.png)
92116

93-
If the function code is already loaded to the editor, you can also select **Save** to apply any changes to the code or properties of the function.
117+
If the function code is already loaded in the editor, you can also select **Save** to apply any changes to the code or properties of the function.
94118

95119
> [!NOTE]
96120
> Once a function is in use in a saved query or a detection rule, you can't edit the function to expand its scope. For example, if you saved a function that queries identity tables, and this function is used in a detection rule, you can't edit the function to include a device table after the fact. To do that, you can save a new function. Product scoping can be narrowed for the same function but not extended.
97121
98122
## Delete a custom function
99123

100-
You can delete functions from **My functions** and functions you created in **Shared functions**. You cannot delete functions that you have not created, unless you have security data manage permissions.
124+
You can delete functions from **My functions** and functions you created in **Shared functions**. You can't delete functions that you didn't create, unless you have security data manage permissions.
101125

102126
To delete a function, select the three dots to the right of the function and select **Delete**.
103127

0 commit comments

Comments
 (0)