set up instructions for stop on disconnect

Author: dhruvchand

articles/dev-box/how-to-configure-dev-box-hibernation.md

@@ -21,10 +21,11 @@ Hibernating dev boxes at the end of the workday can help you save a substantial
 
 With the introduction of Dev Box Hibernation (Preview), you can enable this capability on new dev boxes and hibernate and resume them. This feature provides a convenient way to manage your dev boxes while maintaining your work environment.
 
-There are two steps to enable hibernation: 
+There are three steps to enable hibernation: 
 
 1. Enable hibernation on your dev box image
 1. Enable hibernation on your dev box definition
+1. Automate hibernation of pools of dev boxes using auto-stop schedules, or stop on RDP disconnect.
 
 > [!IMPORTANT]
 > Dev Box Hibernation is currently in PREVIEW.
@@ -184,6 +185,7 @@ az devcenter admin devbox-definition update
 
 ## Related content
 
-- [Configure a dev box by using Azure VM Image Builder](how-to-customize-devbox-azure-image-builder.md)  
+
 - [How to hibernate your dev box](how-to-hibernate-your-dev-box.md)
+- [Configure a dev box by using Azure VM Image Builder](how-to-customize-devbox-azure-image-builder.md)  
 - [Azure CLI reference for az devcenter admin devbox-definition](/cli/azure/devcenter/admin/devbox-definition?view=azure-cli-latest&preserve-view=true)

articles/dev-box/how-to-configure-stop-on-disconnect.md

@@ -0,0 +1,67 @@
+---
+title: Set a dev box auto-stop schedule
+titleSuffix: Microsoft Dev Box
+description: Learn how to configure stop on disconnect to automatically stop  dev boxes in a pool when a user .
+services: dev-box
+ms.service: dev-box
+ms.custom: devx-track-azurecli
+author: dhruvmu
+ms.author: rosemalcolm
+ms.date: 01/10/2024
+ms.topic: how-to
+---
+
+# Auto-stop your Dev Boxes on schedule
+
+To save on costs, you can configure your Dev Box pools to stop when a user disconnects from their RDP session
+
+> [!NOTE]
+> Stop on disconnect will only apply to Dev Boxes that are created with hibernation enabled Dev Box definitions. To learn more about enabling hibernation on your Dev Box definitions, see  [how to configure dev box hibernation](./how-to-configure-dev-box-hibernation.md)
+
+## Permissions
+
+To manage a dev box schedule, you need the following permissions:
+
+| Action | Permission required |
+|---|---|
+| _Configure a schedule_ | Owner, Contributor, or DevCenter Project Admin. |
+
+
+## Manage an auto-stop schedule with the Azure CLI
+
+You can manage stop on disconnect settings on dev box pools by using the Azure CLI.
+
+
+### Update a pool wiith stop on disconnect
+
+The following Azure CLI command enables stop on disconnect on a dev box pool:
+
+```azurecli
+az devcenter admin pool update --pool-name {poolName} --project {projectName} --resource-group {resourceGroupName} --stop-on-disconnect status="Enabled" grace-period-minutes="180"
+```
+
+| Parameter | Value |
+|---|---|
+| `pool-name` | Name of your dev box pool. |
+| `project` | Name of your dev box project. |
+| `resource-group` | Name of the resource group for your dev box pool. |
+| `grace-period-minutes` | Duration to wait after the user disconnects from an RDP session before stopping the dev box, in minutes|
+| `status` | Indicates whether the schedule is in use. The options include `Enabled` or `Disabled`. |
+
+### Disable stop on disconnect
+
+The following Azure CLI command enabdisablesles stop on disconnect on a dev box pool:
+
+```azurecli
+az devcenter admin pool update --pool-name {poolName} --project {projectName} --resource-group {resourceGroupName} --stop-on-disconnect status="Disabled" 
+```
+
+| Parameter | Value |
+|---|---|
+| `pool-name` | Name of your dev box pool. |
+| `project-name` | Name of your dev box project. |
+
+## Related content
+- [How to configure dev box hibernation](./how-to-configure-dev-box-hibernation.md)
+- [Manage a dev box definition](./how-to-manage-dev-box-definitions.md)
+- [Manage a dev box by using the developer portal](./how-to-create-dev-boxes-developer-portal.md)

articles/dev-box/how-to-configure-stop-schedule.md

@@ -13,7 +13,10 @@ ms.topic: how-to
 
 # Auto-stop your Dev Boxes on schedule
 
-To save on costs, you can enable an auto-stop schedule on a dev box pool. Microsoft Dev Box attempts to shut down all dev boxes in the pool at the time specified in the schedule. You can configure one stop time in one timezone for each pool.
+To save on costs, you can enable an auto-stop schedule on a dev box pool. Microsoft Dev Box attempts to stop all dev boxes in the pool at the time specified in the schedule. You can configure one stop time in one timezone for each pool.
+
+> [!NOTE]
+> Auto-stop schedules hibernate Dev Boxes that were created with a hibernation-enabled Dev Box definition. Dev boxes that were created using Dev >Box definitions that do not support hibernation will be shut down. To learn more about enabling hibernation on your Dev Box definitions, see  [how to configure dev box hibernation](./how-to-configure-dev-box-hibernation.md)
 
 ## Permissions