Skip to content

Commit 7d5c247

Browse files
authored
Fix typo in VM Customization documentation
1 parent 4f04bcf commit 7d5c247

File tree

1 file changed

+20
-16
lines changed

1 file changed

+20
-16
lines changed

articles/virtual-machines/vm-customization.md

Lines changed: 20 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.date: 10/21/2025
99
ms.author: eehindero
1010
ms.reviewer: mimckitt
1111
---
12-
# VM Customization Feature: Diable Simultaneous Multi-Threading (SMT/HT) and Configurable Constrained Cores (Preview)
12+
# VM Customization Feature: Disable Simultaneous Multi-Threading (SMT/HT) and Configurable Constrained Cores (Preview)
1313

1414
VM Customization is a new Azure VM feature that gives you greater control over the CPU resources of a virtual machine. It consists of two related capabilities:
1515

@@ -29,36 +29,39 @@ There's _no extra charge_ to use these CPU configuration options. The base VM pr
2929

3030
You can configure the "Threads per core" and "vCPUs available" settings using the Azure portal, Azure Resource Manager templates (ARM), or command-line tools.
3131

32-
## Azure Portal
32+
## Azure portal
3333

3434
In the Azure portal, the VM creation workflow has a UI for these options.
3535

3636
Start creating a VM as usual (for example, click **Create a resource > Virtual Machine** and fill out the Basics tab).
3737

38-
In the Size section of the Basics tab, select a VM size that you want to use. Under the size selection, click the "Customize cores" button. This opens more fields for VM Customization.
38+
1. In the Size section of the Basics tab, select a VM size that you want to use. Under the size selection, click the "Customize cores" button. This opens more fields for VM Customization.
3939

40-
To disable SMT, set Threads per core to 1. (Leave it at 2 if you want to keep hyperthreading enabled.)
40+
2. To disable SMT, set Threads per core to 1. (Leave it at 2 if you want to keep hyperthreading enabled.)
4141

42-
To the vCPU count, set vCPUs available to your desired number of vCPUs. The portal provides valid values for the chosen VM size.
42+
3. To the vCPU count, set vCPUs available to your desired number of vCPUs. The portal provides valid values for the chosen VM size.
4343

44-
Continue with the rest of the VM creation (set up disks, networking, etc.) and create the VM.
44+
4. Continue with the rest of the VM creation (set up disks, networking, etc.) and create the VM.
4545

4646
Once the VM is deployed, it has the specified number of vCPUs. If you set Threads per core to 1, the VM's OS sees half the usual number of processors (since hyperthreading is off). If you reduced vCPUs, it would see that lower count.
4747

4848
## Azure CLI
4949

50-
To disable SMT and configure cores during instance launch
50+
To disable SMT and configure cores during instance launch:
5151

5252
To disable SMT/HT, use the Azure CLI command and specify a value of 1 for vCPUsPerCore for the--cpu-options parameter. To configure cores, specify the number of CPU cores for vCPUsAvailable. In this example, to specify the default CPU core count for a Standard_D8s_v6 instance, specify a value of 8.
53-
```
53+
54+
```azure cli
5455
Az vm create --resource-group ccctest-rg-01 --name ccctestvm01 --image Ubuntu2204 --size Standard_D8s_v6 --location eastus2euap --admin-username azureuser --generate-ssh-keys --public-ip-address '""' --v-cpus-available 4 --v-cpus-per-core 1
5556
```
57+
5658
## PowerShell
5759

5860
To disable SMT and configure cores during instance launch
5961

6062
Use PowerShell and specify the properties on the underlying configuration object. To disable SMT/HT, specify a value of 1 for vCPUsPerCore for the --cpu-options parameter. To configure cores, specify the number of CPU cores for vCPUsAvailable.
61-
```
63+
64+
```powershell
6265
$vmConfig = New-AzVMConfig -VMName "MyVM" -VMSize "Standard_D8s_v6"
6366
6467
$vmConfig.HardwareProfile.VmSizeProperties = New-Object Microsoft.Azure.Management.Compute.Models.VMSizeProperties
@@ -67,6 +70,7 @@ $vmConfig.HardwareProfile.VmSizeProperties.VCPUsAvailable = 4
6770
6871
$vmConfig.HardwareProfile.VmSizeProperties.VCPUsPerCore = 1
6972
```
73+
7074
Then proceed to set OS, network, etc., and use New-AzVM to create the VM. This approach uses the Azure PowerShell SDK objects directly to inject the values.
7175

7276
## ARM Template (Azure Resource Manager)
@@ -85,8 +89,8 @@ Here are brief examples of ARM template snippets for different scenarios:
8589

8690
This snippet shows the setting to turn off SMT on a VM (the VM uses 1 thread per core)
8791

88-
JSON
89-
```
92+
93+
```json
9094
"properties": {
9195

9296
"hardwareProfile": {
@@ -111,8 +115,8 @@ In this case, if Standard_D8s_v6 normally has 8 vCPUs (4 cores * 2 threads), set
111115

112116
This snippet shows a VM configured to use a specific number of vCPUs (fewer than the default)
113117

114-
JSON
115-
```
118+
119+
```json
116120
"properties": {
117121

118122
"hardwareProfile": {
@@ -137,8 +141,8 @@ Here, we requested two cores. On Standard_D8s_v6 (which is hyperthreaded by defa
137141

138142
You can combine both settings as shown:
139143

140-
JSON
141-
```
144+
145+
```json
142146
"properties": {
143147

144148
"hardwareProfile": {
@@ -183,4 +187,4 @@ Most Azure VM families support these features, but there are some important rule
183187

184188
- Anytime you resize a VM (either within the same series or to a different series), a VM reboot occurs. Plan for downtime during the resize operation.
185189

186-
- In preview, only first-party Azure marketplace images (Windows Server, Ubuntu, Red Hat, SUSE, etc.) and custom images are supported.
190+
- In preview, only first-party Azure Marketplace images (Windows Server, Ubuntu, Red Hat, SUSE, etc.) and custom images are supported.

0 commit comments

Comments
 (0)