Skip to content

Commit d412538

Browse files
grizzlytheodoreTheodore ChangmsJinLei
authored
update zone documentation (#20354)
* update zone doc * example issue * Update New-AzVMConfig.md * spacing * Update ExampleIssues.csv Co-authored-by: Theodore Chang <[email protected]> Co-authored-by: Jin Lei <[email protected]>
1 parent 51ac1b4 commit d412538

File tree

2 files changed

+6
-4
lines changed

2 files changed

+6
-4
lines changed

src/Compute/Compute/help/New-AzVM.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -146,7 +146,7 @@ $VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -Computer
146146
$VirtualMachine = Add-AzVMNetworkInterface -VM $VirtualMachine -Id $NIC.Id
147147
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -Name $OSDiskName -VhdUri $OSDiskUri -SourceImageUri $SourceImageUri -Caching $OSDiskCaching -CreateOption $OSCreateOption -Windows
148148
149-
New-AzVM -ResourceGroupName $ResourceGroupName -Location $LocationName -VM $VirtualMachine -Verbose
149+
New-AzVM -ResourceGroupName $ResourceGroupName -Location $LocationName -VM $VirtualMachine -Verbose -Zone @("1")
150150
```
151151

152152
This example takes an existing sys-prepped, generalized custom operating system image and attaches a data disk to it, provisions a new network, deploys the VHD, and runs it.
@@ -1154,7 +1154,8 @@ Accept wildcard characters: False
11541154
```
11551155

11561156
### -Zone
1157-
Specifies the zone list of the virtual machine.
1157+
Specifies the zone of the virtual machine. Although it takes in an array of zones, virtual machines do not support multiple availability zones.
1158+
The allowed value depends on the capabilities of the region. Allowed value will normally be 1, 2, or 3. More information on [Azure availability zones](https://learn.microsoft.com/en-us/azure/reliability/availability-zones-overview#availability-zones).
11581159

11591160
```yaml
11601161
Type: System.String[]

src/Compute/Compute/help/New-AzVMConfig.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ See [Quickstart: Create a Windows virtual machine in Azure with PowerShell](http
5252
### Example 1: Create a virtual machine object
5353
```powershell
5454
$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
55-
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
55+
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id -Zone "1"
5656
```
5757

5858
The first command gets the availability set named AvailabilitySet03 in the resource group named ResourceGroup11, and then stores that object in the $AvailabilitySet variable.
@@ -446,7 +446,8 @@ Accept wildcard characters: False
446446
```
447447
448448
### -Zone
449-
Specifies the availability zone list for the virtual machine. The allowed values depend on the capabilities of the region. Allowed values will normally be 1,2,3.
449+
Specifies the availability zone for the virtual machine. Although it takes in an array of zones, virtual machines do not support multiple availability zones.
450+
The allowed value depends on the capabilities of the region. Allowed value will normally be 1, 2, or 3. More information on [Azure availability zones](https://learn.microsoft.com/en-us/azure/reliability/availability-zones-overview#availability-zones).
450451
451452
```yaml
452453
Type: System.String[]

0 commit comments

Comments
 (0)