Compartilhar via

New-AzVmss

  • Referência
Módulo:
Az.Compute

Criar 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 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:

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://learn.microsoft.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

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 esse 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 do 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 sua 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.

Nome de usuário
Restrição:
Windows: Não pode conter caracteres especiais /""[]:|<>+=;,?*@& ou terminar em "."
Linux: o nome de usuário deve conter apenas letras, números, hífens e sublinhados e não pode começar com um hífen ou número.
Valores não permitidos: "administrador", "admin", "usuário", "usuário1", "teste", "usuário2", "teste1", "usuário3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "convidado", "john", "proprietário", "raiz", "servidor", "sql", "suporte", "support_388945a0", "sys", "teste2", "teste3", "usuário4", "usuário5".
Comprimento mínimo: 1 caractere
Comprimento máximo: 20 caracteres para Windows, 64 caracteres para Linux
Senha
Deve ter 3 dos seguintes: 1 caractere minúsculo, 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ão suporte à Geração 2 (https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2), verifique a funcionalidade HyperVGenerations retornada como parte dos recursos de SKU de VM na resposta da API Microsoft.Compute SKUs 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 suportados, 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 para o FQDN (nome de domínio totalmente qualificado) 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 zona de borda 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 às instâncias do conjunto de dimensionamento de forma contínua quando uma versão mais recente da imagem for disponibilizada.

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

Este 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 true 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 para o conjunto de dimensionamento de máquinas virtuais de baixa prioridade. Os únicos valores com suporte são 'Deallocate' e 'Delete'.

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 de 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 no qual 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 de ETag listados. Omita esse valor para sempre substituir o recurso atual. Especifique o valor da ETag visto pela última vez para evitar 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 condicionar uma solicitação para os métodos GET e HEAD. O servidor só retornará os recursos solicitados se nenhum dos valores de ETag listados corresponder à entidade atual. Usado para condicionar uma solicitação para os métodos GET e HEAD. O servidor só retornará os recursos solicitados se nenhum dos valores de 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 são suportados.

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

Especificado o ID exclusivo da imagem da galeria compartilhada para implantação do vmss. Isso pode ser obtido 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, 2 instâncias serão criadas.

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 esse conjunto de dimensionamento. Um novo balanceador de carga usando o mesmo nome do 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 conversão de endereços 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á em ter o VirtualMachineScaleSetVMProfile sendo preenchido por padrão. Se você quiser criar um VMSS com um VirtualMachineScaleSetVMProfile vazio, primeiro crie um objeto VirtualMachineScaleSet com a propriedade VMProfile vazia usando New-AzVmssConfig e, em seguida, crie o VMSS usando o 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ínio 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. Os únicos valores suportados 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'. Por favor, 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 endereço IP 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 do 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 é reduzido horizontalmente, o conjunto de dimensionamento será primeiro balanceado entre zonas se for um conjunto de dimensionamento zonal. Em seguida, ele será balanceado entre os domínios de falha, tanto quanto possível. Dentro de 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 redução horizontal. 'OldestVM' quando um conjunto de dimensionamento de máquinas virtuais estiver sendo reduzido horizontalmente, as máquinas virtuais mais antigas que não estão protegidas contra redução horizontal serão escolhidas para remoção. Para conjuntos de dimensionamento de máquinas virtuais zonais, o conjunto de dimensionamento será primeiro balanceado entre zonas. Dentro de 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 estiver sendo escalado horizontalmente, as máquinas virtuais mais recentes que não estiverem protegidas contra redução horizontal serão escolhidas para remoção. Para conjuntos de dimensionamento de máquinas virtuais zonais, o conjunto de dimensionamento será primeiro balanceado entre zonas. Dentro de 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 esse 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

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

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á habilitado a menos que essa propriedade seja 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ção da ID exclusiva da imagem da galeria compartilhada para implantação de VM. Isso pode ser obtido 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 superprovisionadas extras.

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 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 esse conjunto de dimensionamento 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 esse 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 de 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 gerenciado que deve ser atribuída à(s) VM(s) 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 o Vmss, que será codificado em base 64. O cliente não deve passar nenhum segredo 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 que esse cmdlet cria.

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 padrão de prefixo de endereço de rede virtual (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 indicam 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