Skip to content

Commit b706d83

Browse files
committed
Learn Editor: Update isolate-machine.md
1 parent bb4941c commit b706d83

File tree

1 file changed

+16
-18
lines changed

1 file changed

+16
-18
lines changed

defender-endpoint/api/isolate-machine.md

Lines changed: 16 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -36,17 +36,16 @@ Isolates a device from accessing external network.
3636

3737
## Limitations
3838

39-
1. Rate limitations for this API are 100 calls per minute and 1500 calls per hour.
39+
1. Rate limitations for this API are 100 calls per minute and 1,500 calls per hour.
4040

4141
[!include[Device actions note](../../includes/machineactionsnote.md)]
4242

4343
> [!IMPORTANT]
44-
> - Full isolation is available for devices on Windows 10, version 1703, and on Windows 11.
45-
> - Full isolation is available for all supported Linux devices. See [Microsoft Defender for Endpoint on Linux](/defender-endpoint/microsoft-defender-endpoint-linux).
46-
> - Selective isolation is available for devices on Windows 10, version 1709 or later, and on Windows 11.
47-
> - When isolating a device, only certain processes and destinations are allowed. Therefore, devices that are behind a full VPN tunnel won't be able to reach the Microsoft Defender for Endpoint cloud service after the device is isolated. We recommend using a split-tunneling VPN for Microsoft Defender for Endpoint and Microsoft Defender Antivirus cloud-based protection-related traffic.
48-
> - Calling this API on unmanaged devices triggers the [contain device from the network](../respond-machine-alerts.md#contain-devices-from-the-network) action.The IsolationType value should be set to 'Unmanaged'.
49-
44+
- Full isolation is available for devices on Windows 10, version 1703, and on Windows 11.
45+
- Full isolation is available for all supported Linux devices. See [Microsoft Defender for Endpoint on Linux](/defender-endpoint/microsoft-defender-endpoint-linux).
46+
- Selective isolation is available for devices on Windows 10, version 1709 or later, and on Windows 11.
47+
- When isolating a device, only certain processes and destinations are allowed. Therefore, devices that are behind a full VPN tunnel won't be able to reach the Microsoft Defender for Endpoint cloud service after the device is isolated. We recommend using a split-tunneling VPN for Microsoft Defender for Endpoint and Microsoft Defender Antivirus cloud-based protection-related traffic.
48+
> - Calling this API on unmanaged devices triggers the [contain device from the network](../respond-machine-alerts.md#contain-devices-from-the-network) action. The IsolationType value should be set to 'Unmanaged.'
5049
5150
## Permissions
5251

@@ -59,12 +58,11 @@ Delegated (work or school account)|Machine.Isolate|'Isolate machine'
5958

6059
> [!NOTE]
6160
> When obtaining a token using user credentials:
62-
>
63-
> - The user needs to have at least the following role permission: 'Active remediation actions' (See [Create and manage roles](../user-roles.md) for more information)
64-
> - The user needs to have access to the device, based on device group settings (See [Create and manage device groups](../machine-groups.md) for more information)
65-
>
61+
> > - The user needs to have at least the following role permission: 'Active remediation actions.' For more information, see [Create and manage roles](../user-roles.md).
62+
> - The user needs to have access to the device, based on device group settings. See [Create and manage device groups](../machine-groups.md) for more information.
63+
>
6664
> Device group creation is supported in Defender for Endpoint Plan 1 and Plan 2.
67-
65+
>
6866
## HTTP request
6967

7068
```http
@@ -82,15 +80,15 @@ Content-Type|string|application/json. **Required**.
8280

8381
In the request body, supply a JSON object with the following parameters:
8482

85-
Parameter|Type|Description
86-
:---|:---|:---
87-
Comment|String|Comment to associate with the action. **Required**.
88-
IsolationType|String|Type of the isolation. Allowed values are: 'Full', 'Selective', or 'Unmanaged'.
83+
|Parameter|Type|Description|
84+
|:---|:---|:---|
85+
|Comment|String|Comment to associate with the action. **Required**.|
86+
|IsolationType|String|Type of the isolation. Allowed values are: **Full**, **Selective**, or **Unmanaged**.|
8987

9088
**IsolationType** controls the type of isolation to perform and can be one of the following:
9189

9290
- Full: Full isolation. Works for managed devices.
93-
- Selective: Restrict only limited set of applications from accessing the network on managed devices. See [Isolate devices from the network](../respond-machine-alerts.md#isolate-devices-from-the-network) for more details.
91+
- Selective: Restrict only limited set of applications from accessing the network on managed devices. For more information, see [Isolate devices from the network](../respond-machine-alerts.md#isolate-devices-from-the-network).
9492
- Unmanaged: The isolation targets unmanaged devices only.
9593

9694
## Response
@@ -101,7 +99,7 @@ If successful, this method returns 201 - Created response code and [Machine Acti
10199

102100
### Request
103101

104-
Here is an example of the request.
102+
Here's an example of the request.
105103

106104
```http
107105
POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/isolate

0 commit comments

Comments
 (0)