Merge pull request #276659 from dhruvchand/devbox-stop-on-disconnect

set up instructions for stop on disconnect

Author: Jill Grant

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,72 @@
+---
+title: Stop dev boxes automatically when a user disconnects.
+titleSuffix: Microsoft Dev Box
+description: Learn how to automatically stop a dev box when a user disconnects by configuring the auto stop setting on the Dev Box Pool.
+
+
+services: dev-box
+ms.service: dev-box
+ms.custom: devx-track-azurecli
+author: dhruvchand
+ms.author: dhruvmu
+ms.date: 01/10/2024
+ms.topic: how-to
+
+#Customer intent: As a Dev Box administrator, I want to configure dev boxes to stop when a user disconnects so that I can control costs.
+---
+
+# Auto-stop your Dev Boxes when users disconnect
+
+
+To save on costs, you can configure your Dev Box pools to stop when a user disconnects from their RDP session, after a timeout period that you can configure. Microsoft Dev Box attempts to stop all dev boxes after a user disconnects, and they do not re-establish a new RDP session within the configured timeout period.
+
+> [!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 with 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 disables 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
 

articles/dev-box/toc.yml

@@ -97,6 +97,8 @@ items:
     href: how-to-hibernate-your-dev-box.md  
   - name: Configure an auto-stop schedule
     href: how-to-configure-stop-schedule.md
+  - name: Configure stop on disconnect
+    href: how-to-configure-stop-on-disconnect.md
   - name: Skip or delay an automatic shutdown
     href: how-to-skip-delay-stop.md
 - name: Reference