Compartilhar via

New-AzVmss

  • Referência
Módulo:
Az.Compute

Cria um conjunto de dimensionamento de máquinas virtuais.

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>]
   [-SecurityPostureId <String>]
   [-SecurityPostureExcludeExtension <String[]>]
   [-SkuProfileVmSize <String[]>]
   [-SkuProfileAllocationStrategy <String>]
   [-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 precisar configurar precisamente 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.

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

A criação do VMSS será padrão 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 o 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://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/quick-create-powershell) para 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 nono comando usa o 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 de 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ço 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 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 do 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 uma 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. Verifique página de recursos de Inicialização Confiável para obter mais informações.

Exemplo 5: Criar uma 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 o padrão será OrchestrationMode Flexível.

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 Início Confiável habilitado por padrão. Verifique página de recursos de Inicialização Confiável para obter mais informações.

Parâmetros

-AllocationMethod

Método de alocação para o endereço IP público do conjunto de dimensionamento (estático ou dinâmico). Se nenhum valor for fornecido, a alocação será estática.

Tipo:String
Valores aceitos:Static, Dynamic
Cargo:Named
Valor padrão:Static
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AsJob

Execute o cmdlet em segundo plano e retorne um trabalho para acompanhar o progresso.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BackendPoolName

O nome do pool de endereços de back-end a ser usado no balanceador de carga para este Conjunto de Dimensionamento. Se nenhum valor for fornecido, um novo pool de back-end será criado, com o mesmo nome do Conjunto de Dimensionamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BackendPort

Números de porta de back-end usados pelo balanceador de carga do Conjunto de Dimensionamento para se comunicar com VMs no Conjunto de Dimensionamento. Se nenhum valor for especificado, as portas 3389 e 5985 serão usadas para VMS do Windows e a porta 22 será usada para VMs linux.

Tipo:Int32[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CapacityReservationGroupId

ID do grupo de reserva de capacidade usado para alocar.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

As credenciais de administrador (nome de usuário e senha) para VMs neste Conjunto de Dimensionamento.

de nome de usuário
Restrição de :
Windows: Não é possível conter caracteres especiais /""[]:|<>+=;,?*@& ou terminar em "".
Linux: o nome de usuário deve conter apenas letras, números, hifens e sublinhados e pode não começar com um hífen ou número.
valores não permitidos: "administrador", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5".
Comprimento mínimo: 1 caractere
comprimento máximo: 20 caracteres para Windows, 64 caracteres para Linux
de senha
Deve ter 3 dos seguintes: 1 caractere de maiúsculas e minúsculas, 1 caractere maiúsculo, 1 número e 1 caractere especial.
O valor deve ter entre 12 e 123 caracteres.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DataDiskSizeInGb

Especifica os tamanhos dos discos de dados em GB.

Tipo:Int32[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DiskControllerType

Especifica o tipo de controlador de disco configurado para a VM e VirtualMachineScaleSet. Essa propriedade só tem suporte para máquinas virtuais cujo disco do sistema operacional e sku de VM dá suporte à geração 2 (https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2), verifique se a funcionalidade HyperVGenerations retornada como parte dos recursos de sku de VM na resposta da api de SKUs microsoft.Compute para a região contém V2 (https://learn.microsoft.com/rest/api/compute/resourceskus/list) .
Para obter mais informações sobre os tipos de controlador de disco com suporte, consulte https://aka.ms/azure-diskcontrollertypes.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DomainNameLabel

O rótulo de nome de domínio do FQDN (nome de domínio Fully-Qualified público) para este Conjunto de Dimensionamento. Esse é o primeiro componente do nome de domínio que é atribuído automaticamente ao Conjunto de Dimensionamento. Os nomes de domínio atribuídos automaticamente usam o formulário (<DomainNameLabel>.<Location>.cloudapp.azure.com). Se nenhum valor for fornecido, o rótulo de nome de domínio padrão será a concatenação de <ScaleSetName> e <ResourceGroupName>.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EdgeZone

Define o nome da zona de borda. Se definido, a consulta será roteada para a edgezone especificada em vez da região principal.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EnableAutomaticOSUpgrade

Se as atualizações do sistema operacional devem ser aplicadas automaticamente a instâncias de conjunto de dimensionamento de forma sem interrupção quando uma versão mais recente da imagem estiver disponível.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableSecureBoot

Especifica se a inicialização segura deve ser habilitada na máquina virtual.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EnableUltraSSD

Use discos UltraSSD para as VMs no conjunto de dimensionamento.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableVtpm

Especifica se o vTPM deve ser habilitado na máquina virtual.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-EncryptionAtHost

Esse parâmetro habilitará a criptografia para todos os discos, incluindo o disco Resource/Temp no próprio host. Padrão: a criptografia no host será desabilitada, a menos que essa propriedade seja definida como verdadeira para o recurso.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EvictionPolicy

A política de remoção do conjunto de dimensionamento de máquinas virtuais de baixa prioridade. Somente os valores com suporte são 'Desalocar' e 'Excluir'.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FrontendPoolName

O nome do pool de endereços de front-end a ser usado no balanceador de carga do Conjunto de Dimensionamento. Se nenhum valor for fornecido, um novo Pool de Endereços front-end será criado, com o mesmo nome do conjunto de dimensionamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-HostGroupId

Especifica o grupo de hosts dedicado em que o conjunto de dimensionamento de máquinas virtuais residirá.

Tipo:String
Aliases:HostGroup
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IfMatch

usado para tornar uma solicitação condicional para o PUT e outros métodos não seguros. O servidor só retornará os recursos solicitados se o recurso corresponder a um dos valores ETag listados. Omita esse valor para sempre substituir o recurso atual. Especifique o valor de ETag visto pela última vez para impedir a substituição acidental de alterações simultâneas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IfNoneMatch

Usado para tornar uma solicitação condicional para os métodos GET e HEAD. O servidor só retornará os recursos solicitados se nenhum dos valores ETag listados corresponder à entidade atual. Usado para tornar uma solicitação condicional para os métodos GET e HEAD. O servidor só retornará os recursos solicitados se nenhum dos valores ETag listados corresponder à entidade atual. Defina como '*' para permitir que um novo conjunto de registros seja criado, mas para impedir a atualização de um conjunto de registros existente. Outros valores resultarão em erro do servidor, pois não têm suporte.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ImageName

O alias da imagem para VMs neste Conjunto de Dimensionamento. Se nenhum valor for fornecido, a imagem "Windows Server 2016 DataCenter" será usada. Os aliases disponíveis são: Win2022AzureEdition, Win2022AzureEditionCore, Win2019Datacenter, Win2016Datacenter, Win2012R2Datacenter, Win2012Datacenter, UbuntuLTS, Ubuntu2204, CentOS85Gen2, Debian11, OpenSuseLeap154Gen2, RHELRaw8LVMGen2, SuseSles15SP3, FlatcarLinuxFreeGen2.

Tipo:String
Aliases:Image
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ImageReferenceId

Especifica a ID exclusiva da imagem da galeria compartilhada para implantação de vmss. Isso pode ser buscado na chamada GET da imagem da galeria compartilhada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstanceCount

O número de imagens de VM no Conjunto de Dimensionamento. Se nenhum valor for fornecido, serão criadas 2 instâncias.

Tipo:Int32
Cargo:Named
Valor padrão:2
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LoadBalancerName

O nome do balanceador de carga a ser usado com este Conjunto de Dimensionamento. Um novo balanceador de carga usando o mesmo nome que o Conjunto de Dimensionamento será criado se nenhum valor for especificado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

O local do Azure em que esse Conjunto de Dimensionamento será criado. Se nenhum valor for especificado, o local será inferido do local de outros recursos referenciados nos parâmetros.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaxPrice

O preço máximo da cobrança de um conjunto de dimensionamento de máquinas virtuais de baixa prioridade.

Tipo:Double
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NatBackendPort

Porta de back-end para tradução de endereço de rede de entrada.

Tipo:Int32[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OrchestrationMode

Especifica o modo de orquestração para o conjunto de dimensionamento de máquinas virtuais. Valores possíveis: Uniforme, Flexível

A criação de um VMSS em OrchestrationMode:Flexible usando o conjunto de parâmetros padrão resultará na população do VirtualMachineScaleSetVMProfile por padrão. Se você quiser criar um VMSS com um VirtualMachineScaleSetVMProfile vazio, primeiro crie um objeto VirtualMachineScaleSet com uma propriedade VMProfile vazia usando New-AzVmssConfig e crie o VMSS usando um conjunto de parâmetros simples.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PlatformFaultDomainCount

Contagem de domínios de falha para cada grupo de posicionamento.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Priority

A prioridade da máquina virtual no conjunto de dimensionamento. Somente os valores com suporte são 'Regular', 'Spot' e 'Low'. 'Regular' é para máquina virtual regular. 'Spot' é para máquina virtual spot. 'Low' também é para máquina virtual spot, mas é substituído por 'Spot'. Use 'Spot' em vez de 'Low'.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProximityPlacementGroupId

A ID do recurso do Grupo de Posicionamento por Proximidade a ser usado com esse conjunto de dimensionamento.

Tipo:String
Aliases:ProximityPlacementGroup
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublicIpAddressName

O nome do endereço IP público a ser usado com esse conjunto de dimensionamento. Um novo IPAddress público com o mesmo nome do Conjunto de Dimensionamento será criado se nenhum valor for fornecido.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos do VMSS. Se nenhum valor for especificado, um novo ResourceGroup será criado usando o mesmo nome que o Conjunto de Dimensionamento.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ScaleInPolicy

As regras a serem seguidas ao dimensionar um conjunto de dimensionamento de máquinas virtuais. Os valores possíveis são: 'Default', 'OldestVM' e 'NewestVM'. 'Padrão' quando um conjunto de dimensionamento de máquinas virtuais é dimensionado, o conjunto de dimensionamento será primeiro equilibrado entre zonas se for um conjunto de dimensionamento zonal. Em seguida, ele será equilibrado entre domínios de falha na medida do possível. Em cada Domínio de Falha, as máquinas virtuais escolhidas para remoção serão as mais recentes que não estão protegidas contra o scale-in. 'OldestVM' quando um conjunto de dimensionamento de máquinas virtuais está sendo dimensionado, as máquinas virtuais mais antigas que não estão protegidas contra o scale-in serão escolhidas para remoção. Para conjuntos de dimensionamento de máquinas virtuais zonais, o conjunto de dimensionamento será primeiro equilibrado entre zonas. Em cada zona, as máquinas virtuais mais antigas que não estão protegidas serão escolhidas para remoção. 'NewestVM' quando um conjunto de dimensionamento de máquinas virtuais está sendo dimensionado, as máquinas virtuais mais recentes que não estão protegidas contra o scale-in serão escolhidas para remoção. Para conjuntos de dimensionamento de máquinas virtuais zonais, o conjunto de dimensionamento será primeiro equilibrado entre zonas. Em cada zona, as máquinas virtuais mais recentes que não estão protegidas serão escolhidas para remoção.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecurityGroupName

O nome do grupo de segurança de rede a ser aplicado a este Conjunto de Dimensionamento. Se nenhum valor for fornecido, um grupo de segurança de rede padrão com o mesmo nome do Conjunto de Dimensionamento será criado e aplicado ao Conjunto de Dimensionamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecurityPostureExcludeExtension

Lista de extensões de máquina virtual a serem excluídas ao aplicar a postura de segurança.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SecurityPostureId

A ID de referência de postura de segurança na forma de /CommunityGalleries/{communityGalleryName}/securityPostures/{securityPostureName}/versions/{major.minor.patch}|mais recente

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SecurityType

Especifica o SecurityType da máquina virtual. Ele deve ser definido como qualquer valor especificado para habilitar UefiSettings. UefiSettings não serão habilitados, a menos que essa propriedade esteja definida.

Tipo:String
Valores aceitos:TrustedLaunch, ConfidentialVM, Standard
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SharedGalleryImageId

Especifica a ID exclusiva da imagem da galeria compartilhada para implantação de VM. Isso pode ser buscado na chamada GET da imagem da galeria compartilhada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SinglePlacementGroup

Use isso para criar o conjunto de dimensionamento em um único grupo de posicionamento, o padrão é vários grupos

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SkipExtensionsOnOverprovisionedVMs

Especifica que as extensões não são executadas nas VMs com superprovisionamento extra.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SkuProfileAllocationStrategy

Estratégia de alocação para o perfil de SKU.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SkuProfileVmSize

Matriz de tamanhos de VM para o conjunto de dimensionamento.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SubnetAddressPrefix

O prefixo de endereço da sub-rede que este ScaleSet usará. As configurações de sub-rede padrão (192.168.1.0/24) serão aplicadas se nenhum valor for fornecido.

Tipo:String
Cargo:Named
Valor padrão:192.168.1.0/24
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubnetName

O nome da sub-rede a ser usada com este Conjunto de Dimensionamento. Uma nova sub-rede será criada com o mesmo nome do Conjunto de Dimensionamento se nenhum valor for fornecido.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SystemAssignedIdentity

Se o parâmetro estiver presente, as VMs no conjunto de dimensionamento receberão uma identidade do sistema gerenciada gerada automaticamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpgradePolicyMode

O modo de política de atualização para instâncias de VM neste Conjunto de Dimensionamento. A política de atualização pode especificar atualizações automáticas, manuais ou sem interrupção.

Tipo:UpgradeMode
Valores aceitos:Automatic, Manual, Rolling
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserAssignedIdentity

O nome de uma identidade de serviço gerenciada que deve ser atribuída às VMs no conjunto de dimensionamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserData

UserData para as Vmss, que serão codificadas em base 64. O cliente não deve passar segredos aqui.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VirtualMachineScaleSet

Especifica o objeto VirtualMachineScaleSet que contém as propriedades do VMSS que esse cmdlet cria.

Tipo:PSVirtualMachineScaleSet
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VirtualNetworkName

O nome da Rede Virtual a ser usada com esse conjunto de dimensionamento. Se nenhum valor for fornecido, uma nova rede virtual com o mesmo nome do Conjunto de Dimensionamento será criada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMScaleSetName

Especifica o nome do VMSS criado por esse cmdlet.

Tipo:String
Aliases:Name
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VmSize

O tamanho das instâncias de VM neste conjunto de dimensionamento. Get-AzComputeResourceSku pode ser usado para descobrir os tamanhos disponíveis para sua assinatura e região. Um tamanho padrão (Standard_DS1_v2) será usado se nenhum Tamanho for especificado.

Tipo:String
Cargo:Named
Valor padrão:Standard_DS1_v2
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VnetAddressPrefix

O prefixo de endereço para a rede virtual usada com este Conjunto de Dimensionamento. As configurações de prefixo de endereço de rede virtual padrão (192.168.0.0/16) serão usadas se nenhum valor for fornecido.

Tipo:String
Cargo:Named
Valor padrão:192.168.0.0/16
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Zone

Uma lista de zonas de disponibilidade que denotam o IP alocado para o recurso precisa vir.

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

PSVirtualMachineScaleSet

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

Saídas

PSVirtualMachineScaleSet