Merge pull request #272979 from ShawnJackson/maintenance-configurations

[AQ] edit pass: Five articles about the Maintenance Configurations feature

Author: ktoliver

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

@@ -1,6 +1,6 @@
 ---
-title: Maintenance Configurations for Azure virtual machines using CLI
-description: Learn how to control when maintenance is applied to your Azure VMs using Maintenance configurations and CLI.
+title: Maintenance Configurations for Azure virtual machines using the Azure CLI
+description: Learn how to control when maintenance is applied to your Azure VMs by using Maintenance Configurations and the Azure CLI.
 author: ju-shim
 ms.service: virtual-machines
 ms.subservice: maintenance
@@ -15,26 +15,26 @@ ms.author: jushiman
 
 **Applies to:** :heavy_check_mark: Linux VMs :heavy_check_mark: Windows VMs :heavy_check_mark: Flexible scale sets :heavy_check_mark: Uniform scale sets
 
-Maintenance Configurations lets you decide when to apply platform updates to various Azure resources. This topic covers the Azure CLI options for using this service. For more about benefits of using Maintenance Configurations, its limitations, and other management options, see [Managing platform updates with Maintenance Configurations](maintenance-configurations.md).
+You can use the Maintenance Configurations feature to control when to apply platform updates to various Azure resources. This article covers the Azure CLI options for using this feature. For more information about the benefits of using Maintenance Configurations, its limitations, and other management options, see [Managing platform updates with Maintenance Configurations](maintenance-configurations.md).
 
 > [!IMPORTANT]
-> There are different **scopes** which support certain machine types and schedules, so please ensure you are selecting the right scope for your virtual machine.
+> Specific *scopes* support certain machine types and schedules. Be sure to select the right scope for your virtual machine (VM).
 
 ## Create a maintenance configuration
 
-The first step to creating a maintenance configuration is creating 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 your own in the rest of the examples.
+The first step in creating a maintenance configuration is creating a resource group as a container for your configuration. This example creates a resource group named *myMaintenanceRG* 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 your own in the rest of the examples.
 
 ```azurecli-interactive
 az group create \
    --location eastus \
    --name myMaintenanceRG
 ```
 
-After creating the resource group, use `az maintenance configuration create` to create a maintenance configuration. 
+After you create the resource group, use `az maintenance configuration create` to create a maintenance configuration.
 
 ### Host
 
-This example creates a maintenance configuration named *myConfig* scoped to host machines with a scheduled window of 5 hours on the fourth Monday of every month.
+This example creates a maintenance configuration named *myConfig* scoped to host machines, with a scheduled window of 5 hours on the fourth Monday of every month:
 
 ```azurecli-interactive
 az maintenance configuration create \
@@ -47,26 +47,26 @@ az maintenance configuration create \
    --maintenance-window-start-date-time "2020-12-30 08:00" \
    --maintenance-window-time-zone "Pacific Standard Time" 
 ```
- 
-Using `--maintenance-scope host` ensures that the maintenance configuration is used for controlling updates to the host infrastructure. If you try to create a configuration with the same name, but in a different location, you will get an error. Configuration names must be unique to your resource group.
 
-You can check if you have created the maintenance configuration successfully by querying for available maintenance configurations using `az maintenance configuration list`. 
+Using `--maintenance-scope host` ensures that the maintenance configuration is used for controlling updates to the host infrastructure. If you try to create a configuration with the same name but in a different location, you'll get an error. Configuration names must be unique to your resource group.
+
+To check if you successfully created the maintenance configuration, you can query for available maintenance configurations by using `az maintenance configuration list`:
 
 ```azurecli-interactive
 az maintenance configuration list 
    --query "[].{Name:name, ID:id}" 
    --output table 
 ```
 
-> [!NOTE]
-> Maintenance recurrence can be expressed as daily, weekly or monthly. Some examples are:
-> - **daily**- maintenance-window-recur-every: "Day" **or** "3Days"
-> - **weekly**- maintenance-window-recur-every: "3Weeks" **or** "Week Saturday,Sunday"
-> - **monthly**- maintenance-window-recur-every: "Month day23,day24" **or** "Month Last Sunday" **or** "Month Fourth Monday"
+You can express maintenance recurrence as daily, weekly, or monthly. Here are some examples:
+
+- **Daily**: A `maintenance-window-recur-every` value of `"Day"` or `"3Days"`.
+- **Weekly**: A `maintenance-window-recur-every` value of `"3Weeks"` or `"Week Saturday,Sunday"`.
+- **Monthly**: A `maintenance-window-recur-every` value of `"Month day23,day24"` or `"Month Last Sunday"` or `Month Fourth Monday`.
 
-### Virtual Machine Scale Sets 
+### Virtual machine scale sets
 
-This example creates a maintenance configuration named *myConfig* with the osimage scope for virtual machine scale sets with a scheduled window of 5 hours on the fourth Monday of every month.
+This example creates a maintenance configuration named *myConfig* with the OS image scope for virtual machine scale sets, with a scheduled window of 5 hours on the fourth Monday of every month:
 
 ```azurecli-interactive
 az maintenance configuration create \
@@ -82,7 +82,7 @@ az maintenance configuration create \
 
 ### Guest VMs
 
-This example creates a maintenance configuration named *myConfig* scoped to guest machines (VMs and Arc enabled servers) with a scheduled window of 2 hours every 20 days. To learn more about this maintenance configurations on guest VMs see [Guest](maintenance-configurations.md#guest).
+This example creates a maintenance configuration named *myConfig* scoped to guest machines (VMs and Azure Arc-enabled servers), with a scheduled window of 2 hours every 20 days. [Learn more about maintenance configurations on guest VMs](maintenance-configurations.md#guest).
 
 ```azurecli-interactive
 az maintenance configuration create \
@@ -106,7 +106,7 @@ Use `az maintenance assignment create` to assign the configuration to your machi
 
 ### Isolated VM
 
-Apply the configuration to an isolated host VM using the ID of the configuration. Specify `--resource-type virtualMachines` and supply the name of the VM for `--resource-name`, and the resource group for to the VM in `--resource-group`, and the location of the VM for `--location`. 
+Apply the configuration to an isolated host VM by using the ID of the configuration. Specify `--resource-type virtualMachines`. Supply the name of the VM for `--resource-name`, the VM's resource group for `--resource-group`, and the location of the VM for `--location`.
 
 ```azurecli-interactive
 az maintenance assignment create \
@@ -121,7 +121,7 @@ az maintenance assignment create \
 
 ### Dedicated host
 
-To apply a configuration to a dedicated host, you need to include `--resource-type hosts`, `--resource-parent-name` with the name of the host group, and `--resource-parent-type hostGroups`. 
+To apply a configuration to a dedicated host, you need to include `--resource-type hosts`, `--resource-parent-name` with the name of the host group, and `--resource-parent-type hostGroups`.
 
 The parameter `--resource-id` is the ID of the host. You can use [az-vm-host-get-instance-view](/cli/azure/vm/host#az-vm-host-get-instance-view) to get the ID of your dedicated host.
 
@@ -138,7 +138,7 @@ az maintenance assignment create \
    --resource-parent-type hostGroups 
 ```
 
-### Virtual Machine Scale Sets
+### Virtual machine scale sets
 
 ```azurecli-interactive
 az maintenance assignment create \
@@ -164,9 +164,9 @@ az maintenance assignment create \
    --maintenance-configuration-id "/subscriptions/{subscription ID}/resourcegroups/myMaintenanceRG/providers/Microsoft.Maintenance/maintenanceConfigurations/myConfig"
 ```
 
-## Check configuration
+## Check the configuration
 
-You can verify that the configuration was applied correctly, or check to see what configuration is currently applied using `az maintenance assignment list`.
+You can verify that the configuration was applied correctly, or check to see what configuration is currently applied, by using `az maintenance assignment list`.
 
 ### Isolated VM
 
@@ -194,7 +194,7 @@ az maintenance assignment list \
    --output table
 ```
 
-### Virtual Machine Scale Sets 
+### Virtual machine scale sets
 
 ```azurecli-interactive
 az maintenance assignment list \
@@ -220,11 +220,11 @@ az maintenance assignment list \
 
 ## Check for pending updates
 
-Use `az maintenance update list` to see if there are pending updates. Update --subscription to be the ID for the subscription that contains the VM.
+Use `az maintenance update list` to see if there are pending updates. Update `--subscription` to be the ID for the subscription that contains the VM.
 
-If there are no updates, the command will return an error message, which will contain the text: `Resource not found...StatusCode: 404`.
+If there are no updates, the command returns an error message that contains the text `Resource not found...StatusCode: 404`.
 
-If there are updates, only one will be returned, even if there are multiple updates pending. The data for this update will be returned in an object:
+If there are updates, the command returns only one, even if multiple updates are pending. The data for this update is returned in an object:
 
 ```text
 [
@@ -241,7 +241,7 @@ If there are updates, only one will be returned, even if there are multiple upda
 
 ### Isolated VM
 
-Check for pending updates for an isolated VM. In this example, the output is formatted as a table for readability.
+Check for pending updates for an isolated VM. In this example, the output is formatted as a table for readability:
 
 ```azurecli-interactive
 az maintenance update list \
@@ -255,7 +255,7 @@ az maintenance update list \
 
 ### Dedicated host
 
-To check for pending updates for a dedicated host. In this example, the output is formatted as a table for readability. Replace the values for the resources with your own.
+Check for pending updates for a dedicated host. In this example, the output is formatted as a table for readability. Replace the values for the resources with your own.
 
 ```azurecli-interactive
 az maintenance update list \
@@ -271,11 +271,11 @@ az maintenance update list \
 
 ## Apply updates
 
-Use `az maintenance apply update` to apply pending updates. On success, this command will return JSON containing the details of the update. Apply update calls can take up to 2 hours to complete.
+Use `az maintenance apply update` to apply pending updates. On success, this command returns JSON that contains the details of the update. Calls to apply updates can take up to 2 hours to complete.
 
 ### Isolated VM
 
-Create a request to apply updates to an isolated VM.
+Create a request to apply updates to an isolated VM:
 
 ```azurecli-interactive
 az maintenance applyupdate create \
@@ -286,10 +286,9 @@ az maintenance applyupdate create \
    --provider-name Microsoft.Compute
 ```
 
-
 ### Dedicated host
 
-Apply updates to a dedicated host.
+Apply updates to a dedicated host:
 
 ```azurecli-interactive
 az maintenance applyupdate create \
@@ -302,9 +301,9 @@ az maintenance applyupdate create \
    --resource-parent-type hostGroups
 ```
 
-### Virtual Machine Scale Sets
+### Virtual machine scale sets
 
-Apply update to a scale set
+Apply updates to a scale set:
 
 ```azurecli-interactive
 az maintenance applyupdate create \
@@ -315,11 +314,11 @@ az maintenance applyupdate create \
    --provider-name Microsoft.Compute
 ```
 
-## Check the status of applying updates 
+## Check the status of applying updates
 
-You can check on the progress of the updates using `az maintenance applyupdate get`. 
+You can check on the progress of the updates by using `az maintenance applyupdate get`.
 
-You can use `default` as the update name to see results for the last update, or replace `myUpdateName` with the name of the update that was returned when you ran `az maintenance applyupdate create`.
+To see results for the last update, use `default` as the update name. Or replace `myUpdateName` with the name of the update that was returned when you ran `az maintenance applyupdate create`.
 
 ```text
 Status         : Completed
@@ -331,7 +330,8 @@ ute/virtualMachines/DXT-test-04-iso/providers/Microsoft.Maintenance/applyUpdates
 Name           : default
 Type           : Microsoft.Maintenance/applyUpdates
 ```
-LastUpdateTime will be the time when the update got complete, either initiated by you or by the platform in case self-maintenance window was not used. If there has never been an update applied through maintenance control it will show default value.
+
+`LastUpdateTime` is the time when the update finished, whether you initiated the update or the platform initiated it because you didn't use the self-maintenance window. If an update was never applied through Maintenance Configurations, `LastUpdateTime` shows the default value.
 
 ### Isolated VM
 
@@ -363,7 +363,7 @@ az maintenance applyupdate get \
    --output table
 ```
 
-### Virtual Machine Scale Sets
+### Virtual machine scale sets
 
 ```azurecli-interactive
 az maintenance applyupdate get \
@@ -379,7 +379,7 @@ az maintenance applyupdate get \
 
 ## Delete a maintenance configuration
 
-Use `az maintenance configuration delete` to delete a maintenance configuration. Deleting the configuration removes the maintenance control from the associated resources.
+To delete a maintenance configuration, use `az maintenance configuration delete`. Deleting the configuration removes the maintenance control from the associated resources.
 
 ```azurecli-interactive
 az maintenance configuration delete \
@@ -389,4 +389,5 @@ az maintenance configuration delete \
 ```
 
 ## Next steps
-To learn more, see [Maintenance and updates](maintenance-and-updates.md).
+
+To learn more, see [Maintenance for virtual machines in Azure](maintenance-and-updates.md).