Skip to content

Commit 6fb47cc

Browse files
authored
Merge pull request #198194 from brittanyrowe/patch-14
VMSS Update
2 parents 2a78def + 3e9cfa1 commit 6fb47cc

File tree

1 file changed

+20
-17
lines changed

1 file changed

+20
-17
lines changed

articles/virtual-machines/dedicated-hosts-how-to.md

Lines changed: 20 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -24,20 +24,21 @@ This article guides you through how to create an Azure [dedicated host](dedicate
2424
## Limitations
2525

2626
- The sizes and hardware types available for dedicated hosts vary by region. Refer to the host [pricing page](https://aka.ms/ADHPricing) to learn more.
27+
- The fault domain count of the virtual machine scale set can't exceed the fault domain count of the host group.
2728

2829
## Create a host group
2930

30-
A **host group** is a resource that represents a collection of dedicated hosts. You create a host group in a region and an availability zone, and add hosts to it. When planning for high availability, there are additional options. You can use one or both of the following options with your dedicated hosts:
31-
- Span across multiple availability zones. In this case, you are required to have a host group in each of the zones you wish to use.
32-
- Span across multiple fault domains which are mapped to physical racks.
31+
A **host group** is a resource that represents a collection of dedicated hosts. You create a host group in a region and an availability zone, and add hosts to it. When planning for high availability, there are more options. You can use one or both of the following options with your dedicated hosts:
32+
- Span across multiple availability zones. In this case, you're required to have a host group in each of the zones you wish to use.
33+
- Span across multiple fault domains, which are mapped to physical racks.
3334

34-
In either case, you are need to provide the fault domain count for your host group. If you do not want to span fault domains in your group, use a fault domain count of 1.
35+
In either case, you need to provide the fault domain count for your host group. If you don't want to span fault domains in your group, use a fault domain count of 1.
3536

3637
You can also decide to use both availability zones and fault domains.
3738

3839
### [Portal](#tab/portal)
3940

40-
In this example, we will create a host group using 1 availability zone and 2 fault domains.
41+
In this example, we will create a host group using one availability zone and two fault domains.
4142

4243
1. Open the Azure [portal](https://portal.azure.com).
4344
1. Select **Create a resource** in the upper left corner.
@@ -89,7 +90,7 @@ az vm host group create \
8990
--platform-fault-domain-count 1
9091
```
9192

92-
The following uses [az vm host group create](/cli/azure/vm/host/group#az-vm-host-group-create) to create a host group by using fault domains only (to be used in regions where availability zones are not supported).
93+
The following code snippet uses [az vm host group create](/cli/azure/vm/host/group#az-vm-host-group-create) to create a host group by using fault domains only (to be used in regions where availability zones aren't supported).
9394

9495
```azurecli-interactive
9596
az vm host group create \
@@ -124,11 +125,11 @@ Add the `-SupportAutomaticPlacement true` parameter to have your VMs and scale s
124125

125126
## Create a dedicated host
126127

127-
Now create a dedicated host in the host group. In addition to a name for the host, you are required to provide the SKU for the host. Host SKU captures the supported VM series as well as the hardware generation for your dedicated host.
128+
Now create a dedicated host in the host group. In addition to a name for the host, you're required to provide the SKU for the host. Host SKU captures the supported VM series and the hardware generation for your dedicated host.
128129

129130
For more information about the host SKUs and pricing, see [Azure Dedicated Host pricing](https://aka.ms/ADHPricing).
130131

131-
If you set a fault domain count for your host group, you will need to specify the fault domain for your host.
132+
If you set a fault domain count for your host group, you'll need to specify the fault domain for your host.
132133

133134
### [Portal](#tab/portal)
134135

@@ -139,7 +140,7 @@ If you set a fault domain count for your host group, you will need to specify th
139140
1. Select *myDedicatedHostsRG* as the **Resource group**.
140141
1. In **Instance details**, type *myHost* for the **Name** and select *East US* for the location.
141142
1. In **Hardware profile**, select *Standard Es3 family - Type 1* for the **Size family**, select *myHostGroup* for the **Host group** and then select *1* for the **Fault domain**. Leave the defaults for the rest of the fields.
142-
1. When you are done, select **Review + create** and wait for validation.
143+
1. When you're done, select **Review + create** and wait for validation.
143144
1. Once you see the **Validation passed** message, select **Create** to create the host.
144145

145146
### [CLI](#tab/cli)
@@ -195,7 +196,7 @@ It will take a few minutes for your VM to be deployed.
195196

196197
### [CLI](#tab/cli)
197198

198-
Create a virtual machine within a dedicated host using [az vm create](/cli/azure/vm#az-vm-create). If you specified an availability zone when creating your host group, you are required to use the same zone when creating the virtual machine. Replace the values like image and host name with your own. If you are creating a Windows VM, remove `--generate-ssh-keys` to be prompted for a password.
199+
Create a virtual machine within a dedicated host using [az vm create](/cli/azure/vm#az-vm-create). If you specified an availability zone when creating your host group, you're required to use the same zone when creating the virtual machine. Replace the values like image and host name with your own. If you're creating a Windows VM, remove `--generate-ssh-keys` to be prompted for a password.
199200

200201
```azurecli-interactive
201202
az vm create \
@@ -254,7 +255,7 @@ When you deploy a scale set, you specify the host group.
254255

255256
### [CLI](#tab/cli)
256257

257-
When you deploy a scale set using [az vmss create](/cli/azure/vmss#az-vmss-create), you specify the host group using `--host-group`. In this example, we are deploying the latest Ubuntu LTS image. To deploy a Windows image, replace the value of `--image` and remove `--generate-ssh-keys` to be prompted for a password.
258+
When you deploy a scale set using [az vmss create](/cli/azure/vmss#az-vmss-create), you specify the host group using `--host-group`. In this example, we're deploying the latest Ubuntu LTS image. To deploy a Windows image, replace the value of `--image` and remove `--generate-ssh-keys` to be prompted for a password.
258259

259260
```azurecli-interactive
260261
az vmss create \
@@ -298,7 +299,7 @@ If you want to manually choose which host to deploy the scale set to, add `--hos
298299

299300
You can add an existing VM to a dedicated host, but the VM must first be Stop\Deallocated. Before you move a VM to a dedicated host, make sure that the VM configuration is supported:
300301

301-
- The VM size must be in the same size family as the dedicated host. For example, if your dedicated host is DSv3, then the VM size could be Standard_D4s_v3, but it could not be a Standard_A4_v2.
302+
- The VM size must be in the same size family as the dedicated host. For example, if your dedicated host is DSv3, then the VM size could be Standard_D4s_v3, but it couldn't be a Standard_A4_v2.
302303
- The VM needs to be located in same region as the dedicated host.
303304
- The VM can't be part of a proximity placement group. Remove the VM from the proximity placement group before moving it to a dedicated host. For more information, see [Move a VM out of a proximity placement group](./windows/proximity-placement-groups.md#move-an-existing-vm-out-of-a-proximity-placement-group)
304305
- The VM can't be in an availability set.
@@ -312,7 +313,7 @@ Move the VM to a dedicated host using the [portal](https://portal.azure.com).
312313
1. Select **Stop** to stop\deallocate the VM.
313314
1. Select **Configuration** from the left menu.
314315
1. Select a host group and a host from the drop-down menus.
315-
1. When you are done, select **Save** at the top of the page.
316+
1. When you're done, select **Save** at the top of the page.
316317
1. After the VM has been added to the host, select **Overview** from the left menu.
317318
1. At the top of the page, select **Start** to restart the VM.
318319

@@ -554,7 +555,9 @@ Tags : {}
554555
---
555556

556557
## Deleting hosts
557-
You are being charged for your dedicated hosts even when no virtual machines are deployed. You should delete any hosts you are currently not using to save costs.
558+
559+
560+
being charged for your dedicated hosts even when no virtual machines are deployed. You should delete any hosts you're currently not using to save costs.
558561

559562
You can only delete a host when there are no any longer virtual machines using it.
560563

@@ -580,7 +583,7 @@ After deleting the VMs, you can delete the host using [az vm host delete](/cli/a
580583
az vm host delete -g myDHResourceGroup --host-group myHostGroup --name myHost
581584
```
582585

583-
Once you have deleted all of your hosts, you may delete the host group using [az vm host group delete](/cli/azure/vm/host/group#az-vm-host-group-delete).
586+
Once you've deleted all of your hosts, you may delete the host group using [az vm host group delete](/cli/azure/vm/host/group#az-vm-host-group-delete).
584587

585588
```azurecli-interactive
586589
az vm host group delete -g myDHResourceGroup --host-group myHostGroup
@@ -607,7 +610,7 @@ After deleting the VMs, you can delete the host using [Remove-AzHost](/powershel
607610
Remove-AzHost -ResourceGroupName $rgName -Name myHost
608611
```
609612

610-
Once you have deleted all of your hosts, you may delete the host group using [Remove-AzHostGroup](/powershell/module/az.compute/remove-azhostgroup).
613+
Once you've deleted all of your hosts, you may delete the host group using [Remove-AzHostGroup](/powershell/module/az.compute/remove-azhostgroup).
611614

612615
```azurepowershell-interactive
613616
Remove-AzHost -ResourceGroupName $rgName -Name myHost
@@ -625,5 +628,5 @@ Remove-AzResourceGroup -Name $rgName
625628

626629
- For more information, see the [Dedicated hosts](dedicated-hosts.md) overview.
627630

628-
- There is sample template, available at [Azure quickstart templates](https://github.com/Azure/azure-quickstart-templates/blob/master/quickstarts/microsoft.compute/vm-dedicated-hosts/README.md), that uses both zones and fault domains for maximum resiliency in a region.
631+
- There's sample template, available at [Azure quickstart templates](https://github.com/Azure/azure-quickstart-templates/blob/master/quickstarts/microsoft.compute/vm-dedicated-hosts/README.md), that uses both zones and fault domains for maximum resiliency in a region.
629632

0 commit comments

Comments
 (0)