Partilhar 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>]
   [-SkuProfileVmSize <String[]>]
   [-SkuProfileAllocationStrategy <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-SinglePlacementGroup]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzVmss cria um VMSS (Virtual Machine Scale set) 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 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 escala de máquina virtual.

Em seguida, use os seguintes cmdlets para definir propriedades diferentes do objeto do conjunto de escala da máquina virtual:

Consulte outros cmdlets para definir a escala da máquina virtual 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 um conjunto de parâmetros simples criando primeiro um objeto VirtualMachineScaleSet com uma propriedade VirtualMachineScaleSetVMProfile vazia usando New-AzVmssConfig.


Consulte [Guia de início rápido: criar um conjunto de dimensionamento de máquina virtual 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 a 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 comandos 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 frontend 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 um teste e armazena as informações do teste 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 de 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 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 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. Verifique a página do recurso Início Confiável 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: Crie 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.

A escala da máquina virtual definida acima tem a Inicialização Confiável habilitada por padrão. Verifique a página do recurso Início 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 escala (estático ou dinâmico). Se nenhum valor for fornecido, a alocação será estática.

Tipo:String
Valores aceites:Static, Dynamic
Position:Named
Default value:Static
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AsJob

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BackendPoolName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-BackendPort

Números de porta de back-end usados pelo balanceador de carga Scale set para se comunicar com VMs no Scale set. 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[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CapacityReservationGroupId

Id do grupo de reserva de capacidade usado para alocar.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

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

Nome de utilizador
Restrição:
Windows: Não é possível conter caracteres especiais /""[]:|<>+=;,?*@& ou terminar em "."
Linux: O nome de usuário deve conter apenas letras, números, hífenes e sublinhados e não pode começar com um hífen ou número.
Valores não permitidos: "administrator", "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
Palavra-passe
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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DataDiskSizeInGb

Especifica os tamanhos dos discos de dados em GB.

Tipo:Int32[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DiskControllerType

Especifica o tipo de controlador de disco configurado para a VM e VirtualMachineScaleSet. Esta propriedade só é suportada para máquinas virtuais cujo disco do sistema operacional e sku de VM suporta a Geração 2 (https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2), verifique o recurso HyperVGenerations retornado como parte dos recursos de sku de VM na resposta da API de SKUs de computação da 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 suportados, consulte https://aka.ms/azure-diskcontrollertypes.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 escala. Este é o primeiro componente do nome de domínio que é atribuído automaticamente ao Conjunto de Escalas. 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EdgeZone

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EnableAutomaticOSUpgrade

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnableSecureBoot

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

Tipo:Nullable<T>[Boolean]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EnableUltraSSD

Use discos UltraSSD para as VMs no conjunto de escala.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnableVtpm

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

Tipo:Nullable<T>[Boolean]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EvictionPolicy

A política de remoção para o conjunto de escala de máquina virtual de baixa prioridade. Apenas os valores suportados são 'Deslocalizar' e 'Eliminar'.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FrontendPoolName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HostGroupId

Especifica o grupo de hosts dedicados no qual o conjunto de escala da máquina virtual residirá.

Tipo:String
Aliases:HostGroup
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-IfMatch

utilizado para condicionar um pedido 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 ETag visto pela última vez para evitar a substituição acidental de alterações simultâneas.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 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 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ImageName

O alias da imagem para VMs neste Conjunto de Escala. 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ImageReferenceId

Especificada a id exclusiva da imagem da galeria compartilhada para a implantação do vmss. Isso pode ser obtido na chamada GET da imagem compartilhada da galeria.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InstanceCount

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

Tipo:Int32
Position:Named
Default value:2
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LoadBalancerName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Location

O local do Azure onde esse Conjunto de Escala será criado. Se nenhum valor for especificado, o local será inferido a partir do local de outros recursos referenciados nos parâmetros.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaxPrice

O preço máximo do faturamento de um conjunto de escala de máquina virtual de baixa prioridade.

Tipo:Double
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NatBackendPort

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

Tipo:Int32[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OrchestrationMode

Especifica o modo de orquestração para o conjunto de escala da máquina virtual. Valores possíveis: Uniforme, Flexível

Criar um VMSS em OrchestrationMode:Flexible usando o conjunto de parâmetros padrão resultará em ter o arquivo 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 um conjunto de parâmetros simples.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PlatformFaultDomainCount

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Priority

A prioridade para a máquina virtual no conjunto de escala. Apenas os valores suportados são 'Regular', 'Spot' e 'Low'. 'Regular' é para máquina virtual normal. 'Spot' é para máquina virtual spot. 'Baixo' também é para máquina virtual spot, mas é substituído por 'Spot'. Por favor, use 'Spot' em vez de 'Low'.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ProximityPlacementGroupId

A id do recurso do Grupo de Colocação de Proximidade a ser usado com esse conjunto de escala.

Tipo:String
Aliases:ProximityPlacementGroup
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublicIpAddressName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 Escalas.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ScaleInPolicy

As regras a serem seguidas ao dimensionar um conjunto de dimensionamento de máquina virtual. Os valores possíveis são: 'Default', 'OldestVM' e 'NewestVM'. 'Padrão' quando um conjunto de escala de máquina virtual é dimensionado, o conjunto de escala primeiro será balanceado entre zonas se for um conjunto de escala zonal. Em seguida, ele será balanceado entre Domínios de Falha na medida do 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 scale-in. 'OldestVM' quando um conjunto de dimensionamento de máquina virtual está sendo dimensionado, as máquinas virtuais mais antigas que não estão protegidas contra scale-in serão escolhidas para remoção. Para conjuntos de escala de máquina virtual zonal, o conjunto de escala 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áquina virtual está sendo dimensionado, as máquinas virtuais mais recentes que não estão protegidas contra scale-in serão escolhidas para remoção. Para conjuntos de escala de máquina virtual zonal, o conjunto de escala 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[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SecurityGroupName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SecurityType

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

Tipo:String
Valores aceites:TrustedLaunch, ConfidentialVM, Standard
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SharedGalleryImageId

Especificada a id exclusiva da imagem da galeria compartilhada para implantação de vm. Isso pode ser obtido na chamada GET da imagem compartilhada da galeria.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SinglePlacementGroup

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SkipExtensionsOnOverprovisionedVMs

Especifica que as extensões não são executadas nas VMs superprovisionadas extras.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SkuProfileAllocationStrategy

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SkuProfileVmSize

Matriz de tamanhos de VM para o conjunto de escala.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SubnetAddressPrefix

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

Tipo:String
Position:Named
Default value:192.168.1.0/24
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SubnetName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SystemAssignedIdentity

Se o parâmetro estiver presente, a(s) VM(s) no conjunto de escala é(são) atribuída(s) a uma identidade de sistema gerenciado que é gerada automaticamente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UpgradePolicyMode

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

Tipo:UpgradeMode
Valores aceites:Automatic, Manual, Rolling
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserAssignedIdentity

O nome de uma identidade de serviço gerenciado que deve ser atribuída à(s) VM(s) no conjunto de escala.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserData

UserData para o Vmss, que será codificado em base-64. O cliente não deve passar nenhum segredo aqui.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VirtualMachineScaleSet

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

Tipo:PSVirtualMachineScaleSet
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VirtualNetworkName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMScaleSetName

Especifica o nome do VMSS que esse cmdlet cria.

Tipo:String
Aliases:Name
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VmSize

O tamanho das instâncias de VM neste conjunto de escala. 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
Position:Named
Default value:Standard_DS1_v2
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VnetAddressPrefix

O prefixo de endereço para a rede virtual usada com este Conjunto de Escala. 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
Position:Named
Default value:192.168.0.0/16
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Zone

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

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

String

PSVirtualMachineScaleSet

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

Saídas

PSVirtualMachineScaleSet