Merge pull request #223757 from yoninalmsft/manual-config-caution

caution manual configurations

Author: v-dirichards

articles/defender-for-iot/organizations/cli-ot-sensor.md

@@ -9,6 +9,8 @@ ms.topic: reference
 
 This article lists the CLI commands available from Defender for IoT OT network sensors.
 
+[!INCLUDE [caution do not use manual configurations](includes/caution-manual-configurations.md)]
+
 ## Prerequisites
 
 Before you can run any of the following CLI commands, you'll need access to the CLI on your OT network sensor as a privileged user.

articles/defender-for-iot/organizations/how-to-manage-individual-sensors.md

@@ -11,6 +11,8 @@ This article describes how to manage individual sensors, such as managing activa
 
 You can also perform some management tasks for multiple sensors simultaneously from the Azure portal or an on-premises management console. For more information, see [Next steps](#next-steps).
 
+[!INCLUDE [caution do not use manual configurations](includes/caution-manual-configurations.md)]
+
 ## View overall sensor status
 
 When you sign into your sensor, the first page shown is the **Overview** page.
@@ -454,7 +456,7 @@ This feature is supported for the following sensor versions:
 
 ## Retrieve forensics data stored on the sensor
 
-Use Defender for IoT data mining reports on an OT network sensor to retrieve forensic data from that sensor’s storage. The following types of forensic data is stored locally on OT sensors, for devices detected by that sensor:
+Use Defender for IoT data mining reports on an OT network sensor to retrieve forensic data from that sensor’s storage. The following types of forensic data are stored locally on OT sensors, for devices detected by that sensor:
 
 - Device data
 - Alert data
@@ -481,7 +483,7 @@ Clearing data deletes all detected or learned data on the sensor. After clearing
 
 1. In the confirmation dialog box, select **Yes** to confirm that you do want to clear all data from the sensor and reset it. For example:
 
-    :::image type="content" source="media/how-to-manage-individual-sensors/clear-system-data.png" alt-text="Screenshot of clearing system data on the support page in the sensor console.":::
+    :::image type="content" source="media/how-to-manage-individual-sensors/clear-system-data.png" alt-text="Screenshot of clearing system data on the support page in the sensor console." lightbox="media/how-to-manage-individual-sensors/clear-system-data.png":::
 
 A confirmation message appears that the action was successful. All learned data, allowlists, policies, and configuration settings are cleared from the sensor.
 
@@ -496,4 +498,4 @@ For more information, see:
 - [Manage sensors with Defender for IoT in the Azure portal](how-to-manage-sensors-on-the-cloud.md)
 - [Threat intelligence research and packages](how-to-work-with-threat-intelligence-packages.md)
 - [Manage sensors from the management console](how-to-manage-sensors-from-the-on-premises-management-console.md)
-- [Troubleshoot the sensor and on-premises management console](how-to-troubleshoot-the-sensor-and-on-premises-management-console.md)
+- [Troubleshoot the sensor and on-premises management console](how-to-troubleshoot-the-sensor-and-on-premises-management-console.md)

articles/defender-for-iot/organizations/includes/caution-manual-configurations.md

@@ -0,0 +1,11 @@
+---
+title: include
+author: batamig
+ms.date: 01/12/2023
+ms.topic: include
+---
+
+<!-- docutune:disable -->
+
+> [!CAUTION]
+> Only documented configuration parameters on the OT network sensor and on-premises management console are supported for customer configuration. Do not change any non-documented configuration parameters, as changes may cause unexpected behavior and system failures.

articles/defender-for-iot/organizations/ot-deploy/install-software-on-premises-management-console.md

@@ -144,6 +144,8 @@ sudo ethtool -p <port value> <time-in-seconds>
 
 This command will cause the light on the port to flash for the specified time period. For example, entering `sudo ethtool -p eno1 120`, will have port eno1 flash for 2 minutes, allowing you to find the port on the back of your appliance.
 
+[!INCLUDE [caution do not use manual configurations](../includes/caution-manual-configurations.md)]
+
 ## Next steps
 
 > [!div class="nextstepaction"]

articles/defender-for-iot/organizations/ot-deploy/install-software-ot-sensor.md

@@ -143,6 +143,8 @@ This procedure describes how to install OT monitoring software on a sensor.
 
 Make sure that your sensor is connected to your network, and then you can sign in to your sensor via a network-connected browser. For more information, see [Activate and set up your sensor](../how-to-activate-and-set-up-your-sensor.md#activate-and-set-up-your-sensor).
 
+[!INCLUDE [caution do not use manual configurations](../includes/caution-manual-configurations.md)]
+
 ## Next steps
 
 > [!div class="nextstepaction"]

articles/defender-for-iot/organizations/references-work-with-defender-for-iot-cli-commands.md

@@ -14,6 +14,8 @@ To access the Defender for IoT CLI, you'll need access to the sensor or on-premi
 - For OT sensors or the on-premises management console, you'll need to sign in as a [privileged user](#privileged-user-access-for-ot-monitoring).
 - For Enterprise IoT sensors, you can sign in as any user.
 
+[!INCLUDE [caution do not use manual configurations](includes/caution-manual-configurations.md)]
+
 ## Privileged user access for OT monitoring
 
 Privileged users for OT monitoring are pre-defined together with the [OT monitoring software installation](../how-to-install-software.md), as part of the hardened operating system.