New-AzVmss

Sintaxe

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>]

Description

O cmdlet New-AzVmss cria um VMSS (Conjunto de Dimensionamento de Máquinas Virtuais) no Azure. Use o conjunto de parâmetros simples (SimpleParameterSet) para criar rapidamente um VMSS predefinido e recursos associados.

Use o conjunto de parâmetros padrão (DefaultParameter) para cenários mais avançados quando você precisar configurar com precisão cada componente do VMSS e cada recurso associado antes da criação. Para o conjunto de parâmetros padrão, primeiro use o cmdlet New-AzVmssConfig para criar um objeto de conjunto de dimensionamento de máquinas virtuais.

Em seguida, use os seguintes cmdlets para definir propriedades diferentes do objeto do conjunto de dimensionamento de máquinas virtuais:

• Add-AzVmssNetworkInterfaceConfiguration para definir o perfil de rede.
  
• Set-AzVmssOsProfile para definir o perfil do sistema operacional.
  
• Set-AzVmssStorageProfile para definir o perfil de armazenamento.
  
• Get-AzComputeResourceSku também pode ser usado para descobrir os tamanhos de máquina virtual disponíveis para sua assinatura e região.
  

Confira outros cmdlets para o conjunto de dimensionamento de máquinas virtuais aqui.

A criação do VMSS será padronizada para OrchestrationMode:Flexible. O conjunto de parâmetros padrão definirá propriedades em VirtualMachineScaleSetVMProfile por padrão. Para criar um VMSS com uma propriedade VirtualMachineScaleSetVMProfile vazia, use um conjunto de parâmetros simples criando primeiro um objeto VirtualMachineScaleSet com uma propriedade VirtualMachineScaleSetVMProfile vazia usando New-AzVmssConfig.

Consulte [Início Rápido: Criar um conjunto de dimensionamento de máquinas virtuais com o Azure PowerShell](https://video2.skills-academy.com/en-us/azure/virtual-machine-scale-sets/quick-create-powershell) para obter o tutorial.

Exemplos

Exemplo 1: Criar um VMSS usando o 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

O comando acima cria o seguinte com o nome $vmssName :

• Um grupo de recursos
• Uma rede virtual
• Um balanceador de carga
• Um IP público
• o VMSS com 2 instâncias

A imagem padrão escolhida para as VMs no VMSS é 2016-Datacenter Windows Server e o SKU é Standard_DS1_v2

Exemplo 2: Criar um VMSS usando o 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;

O exemplo complexo acima cria um VMSS, a seguir está uma explicação do que está acontecendo:

• O primeiro comando cria um grupo de recursos com o nome e o local especificados.
• O segundo comando usa o cmdlet New-AzStorageAccount para criar uma conta de armazenamento.
• Em seguida, o terceiro comando usa o cmdlet Get-AzStorageAccount para obter a conta de armazenamento criada no segundo comando e armazena o resultado na variável $STOAccount.
• O quinto comando usa o cmdlet New-AzVirtualNetworkSubnetConfig para criar uma sub-rede e armazena o resultado na variável chamada $SubNet.
• O sexto comando usa o cmdlet New-AzVirtualNetwork para criar uma rede virtual e armazena o resultado na variável chamada $VNet.
• O sétimo comando usa o Get-AzVirtualNetwork para obter informações sobre a rede virtual criada no sexto comando e armazena as informações na variável chamada $VNet.
• O oitavo e o nono comando usam New-AzPublicIpAddress e Get- AzureRmPublicIpAddress para criar e obter informações desse endereço IP público.
• Os comandos armazenam as informações na variável chamada $PubIP.
• O décimo comando usa o cmdlet New-AzureRmLoadBalancerFrontendIpConfig para criar um balanceador de carga de front-end e armazena o resultado na variável chamada $Frontend.
• O décimo primeiro comando usa o New-AzLoadBalancerBackendAddressPoolConfig para criar uma configuração de pool de endereços de back-end e armazena o resultado na variável chamada $BackendAddressPool.
• O décimo segundo comando usa o New-AzLoadBalancerProbeConfig para criar uma investigação e armazena as informações da investigação na variável chamada $Probe.
• O décimo terceiro comando usa o cmdlet New-AzLoadBalancerInboundNatPoolConfig para criar uma configuração de pool NAT (conversão de endereços de rede) de entrada do balanceador de carga.
• O décimo quarto comando usa o New-AzLoadBalancerRuleConfig para criar uma configuração de regra do balanceador de carga e armazena o resultado na variável chamada $LBRule.
• O décimo quinto comando usa o cmdlet New-AzLoadBalancer para criar um balanceador de carga e armazena o resultado na variável chamada $ActualLb.
• O décimo sexto comando usa o Get-AzLoadBalancer para obter informações sobre o balanceador de carga que foi criado no décimo quinto comando e armazena as informações na variável chamada $ExpectedLb.
• O décimo sétimo comando usa o cmdlet New-AzVmssIpConfig para criar uma configuração de IP VMSS e armazena as informações na variável chamada $IPCfg.
• O décimo oitavo comando usa o cmdlet New-AzVmssConfig para criar um objeto de configuração VMSS e armazena o resultado na variável chamada $VMSS.
• O décimo nono comando usa o cmdlet New-AzVmss para criar o VMSS.

Exemplo 3: Criar um VMSS com um valor 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;

Criar um VMSS com um valor UserData

Exemplo 4: Criar um Vmss com o tipo de segurança 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;

Este exemplo cria um novo VMSS com o novo tipo de segurança 'TrustedLaunch' e os valores UEFISettings necessários, VTpmEnabled e SecureBootEnalbed são verdadeiros. Consulte a página do recurso Trusted Launch para obter mais informações.

Exemplo 5: Criar um Vmss no modo de orquestração: flexível por padrão

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

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

Este exemplo cria um novo VMSS e ele será padronizado para OrchestrationMode Flexible.

Exemplo 6: criar um novo VMSS com TrustedLaunch ativado por padrão.

$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.

O conjunto de dimensionamento de máquinas virtuais acima tem o Trusted Launch habilitado por padrão. Consulte a página do recurso Trusted Launch para obter mais informações.

Parâmetros

-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

Entradas

String

PSVirtualMachineScaleSet

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

Saídas

PSVirtualMachineScaleSet

Links Relacionados

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