Merge pull request #112014 from Justinha/control-maintenance-portal

Control maintenance portal

Author: PMEds28

articles/virtual-machines/linux/toc.yml

@@ -438,10 +438,14 @@
         href: ../maintenance-notifications-powershell.md?toc=/azure/virtual-machines/linux/toc.json&bc=/azure/virtual-machines/linux/breadcrumb/toc.json
     - name: Maintenance control
       items:
+      - name: Overview
+        href: ../maintenance-control.md?toc=/azure/virtual-machines/linux/toc.json&bc=/azure/virtual-machines/linux/breadcrumb/toc.json
       - name: CLI
         href: ../maintenance-control-cli.md?toc=/azure/virtual-machines/linux/toc.json&bc=/azure/virtual-machines/linux/breadcrumb/toc.json
       - name: PowerShell
         href: ../maintenance-control-powershell.md?toc=/azure/virtual-machines/linux/toc.json&bc=/azure/virtual-machines/linux/breadcrumb/toc.json
+      - name: Portal
+        href: ../maintenance-control-portal.md?toc=/azure/virtual-machines/linux/toc.json&bc=/azure/virtual-machines/linux/breadcrumb/toc.json
     - name: Scheduled events
       href: scheduled-events.md
   - name: Monitor VMs

articles/virtual-machines/maintenance-control-cli.md

@@ -1,50 +1,18 @@
 ---
-title: Maintenance control 
-description: Learn how to control when maintenance is applied to your Azure VMs using Maintenance Control.
+title: Maintenance control for Azure virtual machines using CLI 
+description: Learn how to control when maintenance is applied to your Azure VMs using Maintenance control and CLI.
 author: cynthn
 ms.service: virtual-machines
 ms.topic: article
 ms.workload: infrastructure-services
-ms.date: 11/21/2019
+ms.date: 04/20/2020
 ms.author: cynthn
 #pmcontact: shants
 ---
 
-# Preview: Control updates with Maintenance Control and the Azure CLI
-
-Manage platform updates, that don't require a reboot, using maintenance control. Azure frequently updates its infrastructure to improve reliability, performance, security or launch new features. Most updates are transparent to users. Some sensitive workloads, like gaming, media streaming, and financial transactions, can’t tolerate even few seconds of a VM freezing or disconnecting for maintenance. Maintenance control gives you the option to wait on platform updates and apply them within a 35-day rolling window. 
-
-Maintenance control lets you decide when to apply updates to your isolated VMs and Azure Dedicated Hosts.
-
-With maintenance control, you can:
-- Batch updates into one update package.
-- Wait up to 35 days to apply updates. 
-- Automate platform updates for your maintenance window using Azure Functions.
-- Maintenance configurations work across subscriptions and resource groups. 
-
-> [!IMPORTANT]
-> Maintenance Control is currently in public preview.
-> This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. 
-> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
->
-
-## Limitations
-
-- VMs must be on a [dedicated host](./linux/dedicated-hosts.md), or be created using an [isolated VM size](./linux/isolation.md).
-- After 35 days, an update will automatically be applied.
-- User must have **Resource Contributor** access.
-
-
-## Install the maintenance extension
-
-If you choose to install the [Azure CLI](https://docs.microsoft.com/cli/azure/install-azure-cli) locally, you need version 2.0.76 or later.
-
-Install the `maintenance` preview CLI extension locally or in Cloud Shell. 
-
-```azurecli-interactive
-az extension add -n maintenance
-```
+# Control updates with Maintenance Control and the Azure CLI
 
+Maintenance control lets you decide when to apply updates to your isolated VMs and Azure dedicated hosts. This topic covers the Azure CLI options for Maintenance control. For more about benefits of using Maintenance control, its limitations, and other management options, see [Managing platform updates with Maintenance Control](maintenance-control.md).
 
 ## Create a maintenance configuration
 
@@ -58,7 +26,7 @@ az maintenance configuration create \
    -g myMaintenanceRG \
    --name myConfig \
    --maintenanceScope host\
-   --location  eastus
+   --location eastus
 ```
 
 Copy the configuration ID from the output to use later.

articles/virtual-machines/maintenance-control-portal.md

@@ -0,0 +1,98 @@
+---
+title: Maintenance control for Azure virtual machines using the Azure portal 
+description: Learn how to control when maintenance is applied to your Azure VMs using Maintenance control and the Azure portal.
+author: cynthn
+ms.service: virtual-machines
+ms.topic: article
+ms.workload: infrastructure-services
+ms.date: 04/22/2020
+ms.author: cynthn
+#pmcontact: shants
+---
+
+# Control updates with Maintenance Control and the Azure portal
+
+Maintenance control lets you decide when to apply updates to your isolated VMs and Azure dedicated hosts. This topic covers the Azure portal options for Maintenance control. For more about benefits of using Maintenance control, its limitations, and other management options, see [Managing platform updates with Maintenance Control](maintenance-control.md).
+
+## Create a maintenance configuration
+
+1. Sign in to the Azure portal.
+
+1. Search for **Maintenance Configurations**.
+
+   ![Screenshot showing how to open Maintenance Configurations](media/virtual-machines-maintenance-control-portal/maintenance-configurations-search.png)
+
+1. Click **Add**.
+
+   ![Screenshot showing how to add a maintenance configuration](media/virtual-machines-maintenance-control-portal/maintenance-configurations-add.png)
+
+1. Choose a subscription and resource group, provide a name for the configuration, and choose a region. Click **Next**.
+
+   ![Screenshot showing Maintenance Configuration basics](media/virtual-machines-maintenance-control-portal/maintenance-configurations-basics.png)
+
+1. Add tags and values. Click **Next**.
+
+   ![Screenshot showing how to add tags to a maintenance configuration](media/virtual-machines-maintenance-control-portal/maintenance-configurations-tags.png)
+
+1. Review the summary. Click **Create**.
+
+   ![Screenshot showing how to create a maintenance configuration](media/virtual-machines-maintenance-control-portal/maintenance-configurations-create.png)
+
+1. After the deployment is complete, click **Go to resource**.
+
+   ![Screenshot showing Maintenance Configuration deployment complete](media/virtual-machines-maintenance-control-portal/maintenance-configurations-deployment-complete.png)
+
+## Assign the configuration
+
+On the details page of the maintenance configuration, click Assignments and then click **Assign resource**. 
+
+![Screenshot showing how to assign a resource](media/virtual-machines-maintenance-control-portal/maintenance-configurations-add-assignment.png)
+
+Select the resources that you want the maintenance configuration assigned to and click **Ok**. The **Type** column shows whether the resource is an isolated VM or Azure dedicated host. The VM needs to be running to assign the configuration. An error occurs if you try to assign a configuration to a VM that is stopped. 
+
+<!---Shantanu to add details about the error case--->
+
+![Screenshot showing how to select a resource](media/virtual-machines-maintenance-control-portal/maintenance-configurations-select-resource.png)
+
+## Check configuration
+
+You can verify that the configuration was applied correctly or check to see any maintenance configuration that is currently assigned using **Maintenance Configurations**. The **Type** column shows whether the configuration is assigned to an isolated VM or Azure dedicated host. 
+
+![Screenshot showing how to check a maintenance configuration](media/virtual-machines-maintenance-control-portal/maintenance-configurations-host-type.png)
+
+You can also check the configuration for a specific virtual machine on its properties page. Click **Maintenance** to see the configuration assigned to that virtual machine.
+
+![Screenshot showing how to check Maintenance for a host](media/virtual-machines-maintenance-control-portal/maintenance-configurations-check-config.png)
+
+## Check for pending updates
+
+There are also two ways to check if updates are pending for a maintenance configuration. In **Maintenance Configurations**, on the details for the configuration, click **Assignments** and check **Maintenance status**.
+
+![Screenshot showing how to check pending updates](media/virtual-machines-maintenance-control-portal/maintenance-configurations-pending.png)
+
+You can also check a specific host using **Virtual Machines** or properties of the dedicated host. 
+
+![Screenshot showing how to check Maintenance for a host](media/virtual-machines-maintenance-control-portal/maintenance-configurations-pending-vm.png)
+
+## Apply updates
+
+You can apply pending updates on demand using **Virtual Machines**. On the VM details, click **Maintenance** and click **Apply maintenance now**.
+
+![Screenshot showing how to apply pending updates](media/virtual-machines-maintenance-control-portal/maintenance-configurations-apply-updates-now.png)
+
+## Check the status of applying updates 
+
+You can check on the progress of the updates for a configuration in **Maintenance Configurations** or using **Virtual Machines**. On the VM details, click **Maintenance**. In the following example, the **Maintenance state** shows an update is **Pending**.
+
+![Screenshot showing how to check status of pending updates](media/virtual-machines-maintenance-control-portal/maintenance-configurations-status.png)
+
+## Delete a maintenance configuration
+
+To delete a configuration, open the configuration details and click **Delete**.
+
+![Screenshot showing how to check Maintenance for a host](media/virtual-machines-maintenance-control-portal/maintenance-configurations-delete.png)
+
+
+## Next steps
+
+To learn more, see [Maintenance and updates](maintenance-and-updates.md).

articles/virtual-machines/maintenance-control-powershell.md

@@ -1,6 +1,6 @@
 ---
 title: Maintenance control for Azure virtual machines using PowerShell
-description: Learn how to control when maintenance is applied to your Azure VMs using Maintenance Control and PowerShell.
+description: Learn how to control when maintenance is applied to your Azure VMs using Maintenance control and PowerShell.
 author: cynthn
 ms.service: virtual-machines
 ms.topic: article
@@ -10,31 +10,10 @@ ms.author: cynthn
 #pmcontact: shants
 ---
 
-# Preview: Control updates with Maintenance Control and Azure PowerShell
-
-Manage platform updates, that don't require a reboot, using maintenance control. Azure frequently updates its infrastructure to improve reliability, performance, security or launch new features. Most updates are transparent to users. Some sensitive workloads, like gaming, media streaming, and financial transactions, can’t tolerate even few seconds of a VM freezing or disconnecting for maintenance. Maintenance control gives you the option to wait on platform updates and apply them within a 35-day rolling window. 
-
-Maintenance control lets you decide when to apply updates to your isolated VMs.
-
-With maintenance control, you can:
-- Batch updates into one update package.
-- Wait up to 35 days to apply updates. 
-- Automate platform updates for your maintenance window using Azure Functions.
-- Maintenance configurations work across subscriptions and resource groups. 
-
-> [!IMPORTANT]
-> Maintenance Control is currently in public preview.
-> This preview version is provided without a service level agreement, and it's not recommended for production workloads. Certain features might not be supported or might have constrained capabilities. 
-> For more information, see [Supplemental Terms of Use for Microsoft Azure Previews](https://azure.microsoft.com/support/legal/preview-supplemental-terms/).
-> 
-
-## Limitations
-
-- VMs must be on a [dedicated host](./linux/dedicated-hosts.md), or be created using an [isolated VM size](./linux/isolation.md).
-- After 35 days, an update will automatically be applied.
-- User must have **Resource Contributor** access.
-
+# Control updates with Maintenance Control and Azure PowerShell
 
+Maintenance control lets you decide when to apply updates to your isolated VMs and Azure dedicated hosts. This topic covers the Azure PowerShell options for Maintenance control. For more about benefits of using Maintenance control, its limitations, and other management options, see [Managing platform updates with Maintenance Control](maintenance-control.md).
+ 
 ## Enable the PowerShell module
 
 Make sure `PowerShellGet` is up to date.
@@ -43,18 +22,11 @@ Make sure `PowerShellGet` is up to date.
 Install-Module -Name PowerShellGet -Repository PSGallery -Force
 ```
 
-The Az.Maintenance PowerShell cmdlets are in preview, so you need to install the module with the `AllowPrerelease` parameter in Cloud Shell or your local PowerShell installation.   
-
-```azurepowershell-interactive
-Install-Module -Name Az.Maintenance -AllowPrerelease
-```
-
 If you are installing locally, make sure you open your PowerShell prompt as an administrator.
 
 You may also be asked to confirm that you want to install from an *untrusted repository*. Type `Y` or select **Yes to All** to install the module.
 
 
-
 ## Create a maintenance configuration
 
 Create a resource group as a container for your configuration. In this example, a resource group named *myMaintenanceRG* is created in *eastus*. If you already have a resource group that you want to use, you can skip this part and replace the resource group name with you own in the rest of the examples.

articles/virtual-machines/maintenance-control.md

@@ -0,0 +1,41 @@
+---
+title: Overview of Maintenance control for Azure virtual machines using the Azure portal 
+description: Learn how to control when maintenance is applied to your Azure VMs using Maintenance Control.
+author: cynthn
+ms.service: virtual-machines
+ms.topic: article
+ms.workload: infrastructure-services
+ms.date: 04/22/2020
+ms.author: cynthn
+#pmcontact: shants
+---
+
+# Managing platform updates with Maintenance Control 
+
+Manage platform updates, that don't require a reboot, using maintenance control. Azure frequently updates its infrastructure to improve reliability, performance, security or launch new features. Most updates are transparent to users. Some sensitive workloads, like gaming, media streaming, and financial transactions, can't tolerate even few seconds of a VM freezing or disconnecting for maintenance. Maintenance control gives you the option to wait on platform updates and apply them within a 35-day rolling window. 
+
+Maintenance control lets you decide when to apply updates to your isolated VMs and Azure dedicated hosts.
+
+With maintenance control, you can:
+- Batch updates into one update package.
+- Wait up to 35 days to apply updates. 
+- Automate platform updates for your maintenance window using Azure Functions.
+- Maintenance configurations work across subscriptions and resource groups. 
+
+## Limitations
+
+- VMs must be on a [dedicated host](./linux/dedicated-hosts.md), or be created using an [isolated VM size](./linux/isolation.md).
+- After 35 days, an update will automatically be applied.
+- User must have **Resource Contributor** access.
+
+## Management options
+
+You can create and manage maintenance configurations using any of the following options:
+
+- [Azure CLI](maintenance-control-cli.md)
+- [Azure PowerShell](maintenance-control-powershell.md)
+- [Azure portal](maintenance-control-portal.md)
+
+## Next steps
+
+To learn more, see [Maintenance and updates](maintenance-and-updates.md).