New-AzVmss

Синтаксис

New-AzVmss
   [-ResourceGroupName] <String>
   [-VMScaleSetName] <String>
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [-AsJob]
   [-IfMatch <String>]
   [-IfNoneMatch <String>]
   [-EdgeZone <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzVmss
   [[-ResourceGroupName] <String>]
   [-VMScaleSetName] <String>
   [-AsJob]
   [-UserData <String>]
   [-EnableAutomaticOSUpgrade]
   [-IfMatch <String>]
   [-IfNoneMatch <String>]
   [-ImageName <String>]
   -Credential <PSCredential>
   [-InstanceCount <Int32>]
   [-VirtualNetworkName <String>]
   [-SubnetName <String>]
   [-PublicIpAddressName <String>]
   [-DomainNameLabel <String>]
   [-SecurityGroupName <String>]
   [-LoadBalancerName <String>]
   [-BackendPort <Int32[]>]
   [-Location <String>]
   [-EdgeZone <String>]
   [-VmSize <String>]
   [-UpgradePolicyMode <UpgradeMode>]
   [-AllocationMethod <String>]
   [-VnetAddressPrefix <String>]
   [-SubnetAddressPrefix <String>]
   [-FrontendPoolName <String>]
   [-BackendPoolName <String>]
   [-SystemAssignedIdentity]
   [-UserAssignedIdentity <String>]
   [-EnableUltraSSD]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-NatBackendPort <Int32[]>]
   [-DataDiskSizeInGb <Int32[]>]
   [-ProximityPlacementGroupId <String>]
   [-HostGroupId <String>]
   [-Priority <String>]
   [-EvictionPolicy <String>]
   [-MaxPrice <Double>]
   [-ScaleInPolicy <String[]>]
   [-SkipExtensionsOnOverprovisionedVMs]
   [-EncryptionAtHost]
   [-PlatformFaultDomainCount <Int32>]
   [-OrchestrationMode <String>]
   [-CapacityReservationGroupId <String>]
   [-ImageReferenceId <String>]
   [-DiskControllerType <String>]
   [-SharedGalleryImageId <String>]
   [-SecurityType <String>]
   [-EnableVtpm <Boolean>]
   [-EnableSecureBoot <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SinglePlacementGroup]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет New-AzVmss создает масштабируемый набор виртуальных машин (VMSS) в Azure. Используйте простой набор параметров (SimpleParameterSet) для быстрого создания предварительно заданных vmSS и связанных ресурсов.

Используйте набор параметров по умолчанию (DefaultParameter) для более сложных сценариев, если необходимо точно настроить каждый компонент VMSS и каждый связанный ресурс перед созданием. Для набора параметров по умолчанию сначала используйте командлет New-AzVmssConfig для создания объекта масштабируемого набора виртуальных машин.

Затем используйте следующие командлеты, чтобы задать различные свойства объекта масштабируемого набора виртуальных машин:

• Add-AzVmssNetworkInterfaceConfiguration , чтобы задать сетевой профиль.
  
• Set-AzVmssOsProfile , чтобы задать профиль ОС.
  
• Set-AzVmssStorageProfile , чтобы задать профиль хранения.
  
• Get-AzComputeResourceSku также можно использовать для определения доступных размеров виртуальных машин для подписки и региона.
  

См. другие командлеты для масштабируемого набора виртуальных машин.

Создание VMSS по умолчанию будет использовать OrchestrationMode:Flexible. По умолчанию набор параметров будет задавать свойства в VirtualMachineScaleSetVMProfile по умолчанию. Чтобы создать VMSS с пустым свойством VirtualMachineScaleSetVMProfile, используйте простой параметр, создав объект VirtualMachineScaleSet с пустым свойством VirtualMachineScaleSetVMProfile с помощью New-AzVmssConfig.

См. [краткое руководство. Создание масштабируемого набора виртуальных машин с помощью Azure PowerShell](https://video2.skills-academy.com/en-us/azure/virtual-machine-scale-sets/quick-create-powershell) для руководства.

Примеры

Пример 1. Создание VMSS с помощью SimpleParameterSet

$vmssName = 'VMSSNAME'
# Create credentials, I am using one way to create credentials, there are others as well.
# Pick one that makes the most sense according to your use case.
$vmPassword = ConvertTo-SecureString -String "****" -AsPlainText -Force
$vmCred = New-Object System.Management.Automation.PSCredential('USERNAME', $vmPassword)
$securityTypeStnd = "Standard"

#Create a VMSS using the default settings
New-AzVmss -Credential $vmCred -VMScaleSetName $vmssName -SecurityType $securityTypeStnd

Приведенная выше команда создает следующую команду с именем $vmssName :

• Группа ресурсов
• виртуальная сеть;
• Подсистема балансировки нагрузки
• общедоступный IP-адрес;
• VMSS с 2 экземплярами

Образ по умолчанию, выбранный для виртуальных машин в VMSS, — это 2016-Datacenter Windows Server SKU. Standard_DS1_v2

Пример 2. Создание VMSS с помощью DefaultParameterSet

# Common
$LOC = "WestUs";
$RGName = "rgkyvms";

New-AzResourceGroup -Name $RGName -Location $LOC -Force;

# SRP
$STOName = "sto" + $RGName;
$STOType = "Standard_GRS";
New-AzStorageAccount -ResourceGroupName $RGName -Name $STOName -Location $LOC -Type $STOType;
$STOAccount = Get-AzStorageAccount -ResourceGroupName $RGName -Name $STOName;

# NRP
$SubNet = New-AzVirtualNetworkSubnetConfig -Name ("subnet" + $RGName) -AddressPrefix "10.0.0.0/24";
$VNet = New-AzVirtualNetwork -Force -Name ("vnet" + $RGName) -ResourceGroupName $RGName -Location $LOC -AddressPrefix "10.0.0.0/16" -DnsServer "10.1.1.1" -Subnet $SubNet;
$VNet = Get-AzVirtualNetwork -Name ('vnet' + $RGName) -ResourceGroupName $RGName;
$SubNetId = $VNet.Subnets[0].Id;

$PubIP = New-AzPublicIpAddress -Force -Name ("pubip" + $RGName) -ResourceGroupName $RGName -Location $LOC -AllocationMethod Dynamic -DomainNameLabel ("pubip" + $RGName);
$PubIP = Get-AzPublicIpAddress -Name ("pubip"  + $RGName) -ResourceGroupName $RGName;

# Create LoadBalancer
$FrontendName = "fe" + $RGName
$BackendAddressPoolName = "bepool" + $RGName
$ProbeName = "vmssprobe" + $RGName
$InboundNatPoolName  = "innatpool" + $RGName
$LBRuleName = "lbrule" + $RGName
$LBName = "vmsslb" + $RGName

$Frontend = New-AzLoadBalancerFrontendIpConfig -Name $FrontendName -PublicIpAddress $PubIP
$BackendAddressPool = New-AzLoadBalancerBackendAddressPoolConfig -Name $BackendAddressPoolName
$Probe = New-AzLoadBalancerProbeConfig -Name $ProbeName -RequestPath healthcheck.aspx -Protocol http -Port 80 -IntervalInSeconds 15 -ProbeCount 2
$InboundNatPool = New-AzLoadBalancerInboundNatPoolConfig -Name $InboundNatPoolName  -FrontendIPConfigurationId `
    $Frontend.Id -Protocol Tcp -FrontendPortRangeStart 3360 -FrontendPortRangeEnd 3367 -BackendPort 3370;
$LBRule = New-AzLoadBalancerRuleConfig -Name $LBRuleName `
    -FrontendIPConfiguration $Frontend -BackendAddressPool $BackendAddressPool `
    -Probe $Probe -Protocol Tcp -FrontendPort 80 -BackendPort 80 `
    -IdleTimeoutInMinutes 15 -EnableFloatingIP -LoadDistribution SourceIP;
$ActualLb = New-AzLoadBalancer -Name $LBName -ResourceGroupName $RGName -Location $LOC `
    -FrontendIpConfiguration $Frontend -BackendAddressPool $BackendAddressPool `
    -Probe $Probe -LoadBalancingRule $LBRule -InboundNatPool $InboundNatPool;
$ExpectedLb = Get-AzLoadBalancer -Name $LBName -ResourceGroupName $RGName

# New VMSS Parameters
$VMSSName = "vmss" + $RGName;

$AdminUsername = "Admin01";
$AdminPassword = "p4ssw0rd@123" + $RGName;

$PublisherName = "MicrosoftWindowsServer"
$Offer         = "WindowsServer"
$Sku           = "2012-R2-Datacenter"
$Version       = "latest"

$VHDContainer = "https://" + $STOName + ".blob.core.windows.net/" + $VMSSName;

$ExtName = "CSETest";
$Publisher = "Microsoft.Compute";
$ExtType = "BGInfo";
$ExtVer = "2.1";

#IP Config for the NIC
$IPCfg = New-AzVmssIpConfig -Name "Test" `
    -LoadBalancerInboundNatPoolsId $ExpectedLb.InboundNatPools[0].Id `
    -LoadBalancerBackendAddressPoolsId $ExpectedLb.BackendAddressPools[0].Id `
    -SubnetId $SubNetId;

#VMSS Config
$securityTypeStnd = "Standard";
$VMSS = New-AzVmssConfig -Location $LOC -SkuCapacity 2 -SkuName "Standard_E4-2ds_v4" -UpgradePolicyMode "Automatic" -SecurityType $securityTypeStnd `
    | Add-AzVmssNetworkInterfaceConfiguration -Name "Test" -Primary $True -IPConfiguration $IPCfg `
    | Add-AzVmssNetworkInterfaceConfiguration -Name "Test2"  -IPConfiguration $IPCfg `
    | Set-AzVmssOsProfile -ComputerNamePrefix "Test"  -AdminUsername $AdminUsername -AdminPassword $AdminPassword `
    | Set-AzVmssStorageProfile -Name "Test"  -OsDiskCreateOption 'FromImage' -OsDiskCaching "None" `
    -ImageReferenceOffer $Offer -ImageReferenceSku $Sku -ImageReferenceVersion $Version `
    -ImageReferencePublisher $PublisherName -VhdContainer $VHDContainer `
    | Add-AzVmssExtension -Name $ExtName -Publisher $Publisher -Type $ExtType -TypeHandlerVersion $ExtVer -AutoUpgradeMinorVersion $True

#Create the VMSS
New-AzVmss -ResourceGroupName $RGName -Name $VMSSName -VirtualMachineScaleSet $VMSS;

Сложный пример, приведенный выше, создает vmSS, ниже приведено объяснение того, что происходит:

• Первая команда создает группу ресурсов с указанным именем и расположением.
• Вторая команда использует командлет New-AzStorageAccount для создания учетной записи хранения.
• Третья команда затем использует командлет Get-AzStorageAccount для получения учетной записи хранения, созданной во второй команде, и сохраняет результат в переменной $STOAccount.
• Пятая команда использует командлет New-AzVirtualNetworkSubnetConfig для создания подсети и хранения результата в переменной с именем $SubNet.
• Шестая команда использует командлет New-AzVirtualNetwork для создания виртуальной сети и хранения результата в переменной с именем $VNet.
• Седьмая команда использует Get-AzVirtualNetwork для получения сведений о виртуальной сети, созданной в шестой команде, и сохраняет сведения в переменной с именем $VNet.
• Восьмая и девятая команда используют New-AzPublicIpAddress и Get-AzureRmPublicIpAddress для создания и получения сведений из этого общедоступного IP-адреса.
• Команды хранят сведения в переменной с именем $PubIP.
• Десятая команда использует командлет New-AzureRmLoadBalancerFrontendIpConfig для создания интерфейсного подсистемы балансировки нагрузки и сохраняет результат в переменной с именем $Frontend.
• Одиннадцатая команда использует New-AzLoadBalancerBackendAddressPoolConfig для создания конфигурации серверного пула адресов и хранения результата в переменной с именем $BackendAddressPool.
• Двенадцатая команда использует New-AzLoadBalancerProbeConfig для создания пробы и хранения сведений о пробе в переменной с именем $Probe.
• Тринадцатая команда использует командлет New-AzLoadBalancerInboundNatPoolConfig для создания конфигурации пула преобразования сетевых адресов (NAT) подсистемы балансировки нагрузки.
• Четырнадцатая команда использует New-AzLoadBalancerRuleConfig для создания конфигурации правила подсистемы балансировки нагрузки и сохраняет результат в переменной с именем $LBRule.
• Пятнадцатая команда использует командлет New-AzLoadBalancer для создания подсистемы балансировки нагрузки и хранения результата в переменной с именем $ActualLb.
• Шестнадцатая команда использует Get-AzLoadBalancer для получения сведений о подсистеме балансировки нагрузки, созданной в пятнадцатой команде, и сохраняет сведения в переменной с именем $ExpectedLb.
• Семнадцатая команда использует командлет New-AzVmssIpConfig для создания IP-конфигурации VMSS и хранения сведений в переменной с именем $IPCfg.
• Восемнадцатая команда использует командлет New-AzVmssConfig для создания объекта конфигурации VMSS и сохраняет результат в переменной с именем $VMSS.
• Девятнадцатая команда использует командлет New-AzVmss для создания VMSS.

Пример 3. Создание VMSS со значением UserData

$ResourceGroupName = 'RESOURCE GROUP NAME';
$vmssName = 'VMSSNAME';
$domainNameLabel = "dnl" + $ResourceGroupName;
# Create credentials, I am using one way to create credentials, there are others as well.
# Pick one that makes the most sense according to your use case.
$vmPassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$vmCred = New-Object System.Management.Automation.PSCredential('USERNAME', $vmPassword);

$text = "UserData value to encode";
$bytes = [System.Text.Encoding]::Unicode.GetBytes($text);
$userData = [Convert]::ToBase64String($bytes);
$securityTypeStnd = "Standard";

#Create a VMSS
New-AzVmss -ResourceGroupName $ResourceGroupName -Name $vmssName -Credential $vmCred -DomainNameLabel $domainNameLabel -Userdata $userData -SecurityType $securityTypeStnd;
$vmss = Get-AzVmss -ResourceGroupName $ResourceGroupName -VMScaleSetName $vmssName -InstanceView:$false -Userdata;

Создание VMSS со значением UserData

Пример 4. Создание виртуальных машин с типом безопасности TrustedLaunch

$rgname = "rgname";
$loc = "eastus";

# VMSS Profile & Hardware requirements for the TrustedLaunch default behavior.
$vmssSize = 'Standard_D4s_v3';
$vmssName1 = 'vmss1' + $rgname;
$imageName = "Win2022AzureEdition";
$adminUsername = "<Username>";
$adminPassword = ConvertTo-SecureString -String "****" -AsPlainText -Force;
$vmCred = New-Object System.Management.Automation.PSCredential ($adminUsername, $adminPassword);

# VMSS Creation 
$result = New-AzVmss -Credential $vmCred -VMScaleSetName $vmssName1 -ImageName $imageName -SecurityType "TrustedLaunch";
# Validate that for -SecurityType "TrustedLaunch", "-Vtpm" and -"SecureBoot" are "Enabled/true"
# $result.VirtualMachineProfile.SecurityProfile.UefiSettings.VTpmEnabled;
# $result.VirtualMachineProfile.SecurityProfile.UefiSettings.SecureBootEnabled;

В этом примере создается новая виртуальная машина с новым типом безопасности TrustedLaunch и необходимыми значениями UEFISettings, VTpmEnabled и SecureBootEnalbed. Дополнительные сведения см . на странице функции доверенного запуска.

Пример 5. Создание виртуальных машин в режиме оркестрации: гибкий по умолчанию

# Create configration object
$vmssConfig = New-AzVmssConfig -Location EastUs2 -UpgradePolicyMode Manual -SinglePlacementGroup $true

# VMSS Creation 
New-AzVmss -ResourceGroupName TestRg -VMScaleSetName myVMSS -VirtualMachineScaleSet $vmssConfig

В этом примере создается новая виртуальная машина, и она по умолчанию будет использовать OrchestrationMode Flexible.

Пример 6. Создание виртуальной машины vmSS с включенным TrustedLaunch по умолчанию.

$rgname = "<Resource Group>";
$loc = "<Azure Region>";
New-AzResourceGroup -Name $rgname -Location $loc -Force;

$vmssName = 'vmss' + $rgname;
$vmssSize = 'Standard_D4s_v3';
$imageName = "Win2022AzureEdition";
$publisherName = "MicrosoftWindowsServer";
$offer = "WindowsServer";
$sku = "2022-Datacenter-Azure-Edition";
$adminUsername = "<Username>";
$password = "<Password>";

# NRP
$vnetworkName = 'vnet' + $rgname;
$subnetName = 'subnet' + $rgname;
$subnet = New-AzVirtualNetworkSubnetConfig -Name $subnetName -AddressPrefix "10.0.0.0/24";
$vnet = New-AzVirtualNetwork -Name $vnetworkName -ResourceGroupName $rgname -Location $loc -AddressPrefix "10.0.0.0/16" -Subnet $subnet;
$vnet = Get-AzVirtualNetwork -Name $vnetworkName -ResourceGroupName $rgname;
$subnetId = $vnet.Subnets[0].Id;

$ipCfg = New-AzVmssIpConfig -Name 'test' -SubnetId $subnetId;

$vmss = New-AzVmssConfig -Location $loc -SkuCapacity 2 -SkuName $vmssSize -UpgradePolicyMode 'Manual' `
    | Add-AzVmssNetworkInterfaceConfiguration -Name 'test' -Primary $true -IPConfiguration $ipCfg `
    | Set-AzVmssOsProfile -ComputerNamePrefix 'test' -AdminUsername $adminUsername -AdminPassword $password;
    
# Create TL Vmss
$result = New-AzVmss -ResourceGroupName $rgname -VMScaleSetName $vmssName -VirtualMachineScaleSet $vmss;
$vmssGet = Get-AzVmss -ResourceGroupName $rgname -VMScaleSetName $vmssName;

# Verify $vmssGet.VirtualMachineProfile.SecurityProfile.SecurityType is TrustedLaunch.
# Verify $vmssGet.VirtualMachineProfile.SecurityProfile.UefiSettings.VTpmEnabled is True.
# Verify $vmssGet.VirtualMachineProfile.SecurityProfile.UefiSettings.SecureBootEnabled is True.
# Verify $vmssGet.VirtualMachineProfile.StorageProfile.ImageReference.Sku is 2022-Datacenter-Azure-Edition.

В масштабируемом наборе виртуальных машин выше включен доверенный запуск по умолчанию. Дополнительные сведения см . на странице функции доверенного запуска.

Параметры

-AllocationMethod

-AsJob

-BackendPoolName

-BackendPort

-CapacityReservationGroupId

-Confirm

-Credential

-DataDiskSizeInGb

-DefaultProfile

-DiskControllerType

-DomainNameLabel

-EdgeZone

-EnableAutomaticOSUpgrade

-EnableSecureBoot

-EnableUltraSSD

-EnableVtpm

-EncryptionAtHost

-EvictionPolicy

-FrontendPoolName

-HostGroupId

-IfMatch

-IfNoneMatch

-ImageName

-ImageReferenceId

-InstanceCount

-LoadBalancerName

-Location

-MaxPrice

-NatBackendPort

-OrchestrationMode

-PlatformFaultDomainCount

-Priority

-ProximityPlacementGroupId

-PublicIpAddressName

-ResourceGroupName

-ScaleInPolicy

-SecurityGroupName

-SecurityType

-SharedGalleryImageId

-SinglePlacementGroup

-SkipExtensionsOnOverprovisionedVMs

-SubnetAddressPrefix

-SubnetName

-SystemAssignedIdentity

-UpgradePolicyMode

-UserAssignedIdentity

-UserData

-VirtualMachineScaleSet

-VirtualNetworkName

-VMScaleSetName

-VmSize

-VnetAddressPrefix

-WhatIf

-Zone

Входные данные

String

PSVirtualMachineScaleSet

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Выходные данные

PSVirtualMachineScaleSet

Связанные ссылки

• Get-AzVmss
• Remove-AzVmss
• Restart-AzVmss
• Set-AzVmss
• Start-AzVmss
• Stop-AzVmss
• Update-AzVmss