Compartir a través de


New-AzVmss

Crea un conjunto de escalado de máquinas virtuales.

Sintaxis

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

Description

El cmdlet New-AzVmss crea un conjunto de escalado de máquinas virtuales (VMSS) en Azure. Use el conjunto de parámetros simple (SimpleParameterSet) para crear rápidamente un VMSS preconfijo y los recursos asociados.

Use el conjunto de parámetros predeterminado (DefaultParameter) para escenarios más avanzados cuando necesite configurar con precisión cada componente de VMSS y cada recurso asociado antes de la creación. Para el conjunto de parámetros predeterminado, use primero el cmdlet New-AzVmssConfig para crear un objeto de conjunto de escalado de máquinas virtuales.

A continuación, use los siguientes cmdlets para establecer diferentes propiedades del objeto del conjunto de escalado de máquinas virtuales:

Consulte otros cmdlets para el conjunto de escalado de máquinas virtuales aquí.

La creación de VMSS tendrá como valor predeterminado OrchestrationMode:Flexible. El conjunto de parámetros predeterminado establecerá propiedades en VirtualMachineScaleSetVMProfile de forma predeterminada. Para crear un VMSS con una propiedad VirtualMachineScaleSetVMProfile vacía, use el parámetro simple establecido creando primero un objeto VirtualMachineScaleSet con una propiedad VirtualMachineScaleSetProfile vacía mediante New-AzVmssConfig.


Consulte [Inicio rápido: Creación de un conjunto de escalado de máquinas virtuales con Azure PowerShell](https://learn.microsoft.com/en-us/azure/virtual-machine-scale-sets/quick-create-powershell) para ver el tutorial.

Ejemplos

Ejemplo 1: Creación de un VMSS mediante 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

El comando anterior crea lo siguiente con el nombre $vmssName :

  • Un grupo de recursos
  • Una red virtual
  • Un equilibrador de carga
  • Una dirección IP pública
  • VMSS con 2 instancias

La imagen predeterminada elegida para las máquinas virtuales de VMSS es 2016-Datacenter Windows Server y la SKU es Standard_DS1_v2

Ejemplo 2: Creación de un VMSS mediante 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;

En el ejemplo complejo anterior se crea un VMSS, a continuación se muestra una explicación de lo que sucede:

  • El primer comando crea un grupo de recursos con el nombre y la ubicación especificados.
  • El segundo comando usa el cmdlet New-AzStorageAccount para crear una cuenta de almacenamiento.
  • A continuación, el tercer comando usa el cmdlet Get-AzStorageAccount para obtener la cuenta de almacenamiento creada en el segundo comando y almacena el resultado en la variable $STOAccount.
  • El quinto comando usa el cmdlet New-AzVirtualNetworkSubnetConfig para crear una subred y almacena el resultado en la variable denominada $SubNet.
  • El sexto comando usa el cmdlet New-AzVirtualNetwork para crear una red virtual y almacena el resultado en la variable denominada $VNet.
  • El séptimo comando usa Get-AzVirtualNetwork para obtener información sobre la red virtual creada en el sexto comando y almacena la información en la variable denominada $VNet.
  • El octavo y noveno comando usa New-AzPublicIpAddress y Get- AzureRmPublicIpAddress para crear y obtener información de esa dirección IP pública.
  • Los comandos almacenan la información en la variable denominada $PubIP.
  • El décimo comando usa el cmdlet New- AzureRmLoadBalancerFrontendIpConfig para crear un equilibrador de carga de front-end y almacena el resultado en la variable denominada $Frontend.
  • El undécimo comando usa New-AzLoadBalancerBackendAddressPoolConfig para crear una configuración del grupo de direcciones de back-end y almacena el resultado en la variable denominada $BackendAddressPool.
  • El duodécimo comando usa New-AzLoadBalancerProbeConfig para crear un sondeo y almacena la información de sondeo en la variable denominada $Probe.
  • El decimotercer comando usa el cmdlet New-AzLoadBalancerInboundNatPoolConfig para crear una configuración de grupo de traducción de direcciones de red entrantes (NAT).
  • El decimocuarto comando usa New-AzLoadBalancerRuleConfig para crear una configuración de regla del equilibrador de carga y almacena el resultado en la variable denominada $LBRule.
  • El decimoquinto comando usa el cmdlet New-AzLoadBalancer para crear un equilibrador de carga y almacena el resultado en la variable denominada $ActualLb.
  • El decimosexto comando usa Get-AzLoadBalancer para obtener información sobre el equilibrador de carga que se creó en el decimoquinto comando y almacena la información en la variable denominada $ExpectedLb.
  • El diecisiete comando usa el cmdlet New-AzVmssIpConfig para crear una configuración ip de VMSS y almacena la información en la variable denominada $IPCfg.
  • El decimoctavo comando usa el cmdlet New-AzVmssConfig para crear un objeto de configuración de VMSS y almacena el resultado en la variable denominada $VMSS.
  • El decimonoveno comando usa el cmdlet New-AzVmss para crear vmSS.

Ejemplo 3: Creación de un VMSS con un 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;

Creación de un VMSS con un valor UserData

Ejemplo 4: Creación de una máquina virtual con el tipo de seguridad 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;

En este ejemplo se crea un nuevo VMSS con el nuevo tipo de seguridad "TrustedLaunch" y los valores UEFISettings necesarios, VTpmEnabled y SecureBootEnalbed son true. Consulte la página de características Inicio seguro para obtener más información.

Ejemplo 5: Crear una máquina virtual en modo de orquestación: flexible de forma predeterminada

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

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

En este ejemplo se crea un nuevo VMSS y se establece de forma predeterminada en OrchestrationMode Flexible.

Ejemplo 6: Creación de un nuevo VMSS con TrustedLaunch activado de forma predeterminada.

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

El conjunto de escalado de máquinas virtuales anterior tiene habilitado el inicio seguro de forma predeterminada. Consulte la página de características Inicio seguro para obtener más información.

Parámetros

-AllocationMethod

Método de asignación para la dirección IP pública del conjunto de escalado (estático o dinámico). Si no se proporciona ningún valor, la asignación será estática.

Tipo:String
Valores aceptados:Static, Dynamic
Posición:Named
Valor predeterminado:Static
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AsJob

Ejecute el cmdlet en segundo plano y devuelva un trabajo para realizar un seguimiento del progreso.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BackendPoolName

Nombre del grupo de direcciones de back-end que se va a usar en el equilibrador de carga de este conjunto de escalado. Si no se proporciona ningún valor, se creará un nuevo grupo de back-end con el mismo nombre que el conjunto de escalado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BackendPort

Números de puerto de back-end usados por el equilibrador de carga del conjunto de escalado para comunicarse con las máquinas virtuales del conjunto de escalado. Si no se especifica ningún valor, los puertos 3389 y 5985 se usarán para vmS Windows y se usará el puerto 22 para las máquinas virtuales Linux.

Tipo:Int32[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CapacityReservationGroupId

Identificador del grupo de reserva de capacidad que se usa para asignar.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Las credenciales de administrador (nombre de usuario y contraseña) de las máquinas virtuales de este conjunto de escalado.

Nombre de usuario
Restricción:
Windows: No se pueden contener caracteres especiales /""[]:|<>+=;,?*@& o terminar en "."
Linux: el nombre de usuario solo debe contener letras, números, guiones y guiones bajos y puede que no empiece por un guión o un número.
Valores no 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".
Longitud mínima: 1 carácter
Longitud máxima: 20 caracteres para Windows, 64 caracteres para Linux
Contraseña
Debe tener 3 de lo siguiente: 1 carácter en minúsculas, 1 carácter mayúscula, 1 número y 1 carácter especial.
El valor debe tener entre 12 y 123 caracteres.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DataDiskSizeInGb

Especifica los tamaños de los discos de datos en GB.

Tipo:Int32[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DiskControllerType

Especifica el tipo de controlador de disco configurado para la máquina virtual y VirtualMachineScaleSet. Esta propiedad solo se admite para las máquinas virtuales cuyo disco del sistema operativo y la SKU de máquina virtual admiten la generación 2 (https://learn.microsoft.com/en-us/azure/virtual-machines/generation-2), compruebe la funcionalidad HyperVGenerations devuelta como parte de las funcionalidades de SKU de máquina virtual en la respuesta de la API de SKU de Microsoft.Compute para la región contiene V2 (https://learn.microsoft.com/rest/api/compute/resourceskus/list).
Para obtener más información sobre los tipos de controlador de disco admitidos, consulte https://aka.ms/azure-diskcontrollertypes.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DomainNameLabel

Etiqueta de nombre de dominio para el nombre de dominio completo (FQDN) público para este conjunto de escalado. Este es el primer componente del nombre de dominio que se asigna automáticamente al conjunto de escalado. Los nombres de dominio asignados automáticamente usan el formulario (<DomainNameLabel>.<Location>.cloudapp.azure.com). Si no se proporciona ningún valor, la etiqueta de nombre de dominio predeterminada será la concatenación de <ScaleSetName> y <ResourceGroupName>.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EdgeZone

Establece el nombre de la zona perimetral. Si se establece, la consulta se enrutará a la zona perimetral especificada en lugar de a la región principal.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EnableAutomaticOSUpgrade

Si las actualizaciones del sistema operativo se deben aplicar automáticamente a las instancias del conjunto de escalado de forma gradual cuando esté disponible una versión más reciente de la imagen.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableSecureBoot

Especifica si se debe habilitar el arranque seguro en la máquina virtual.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EnableUltraSSD

Use discos UltraSSD para las máquinas virtuales del conjunto de escalado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableVtpm

Especifica si vTPM debe estar habilitado en la máquina virtual.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EncryptionAtHost

Este parámetro habilitará el cifrado para todos los discos, incluido el disco resource/temp en el propio host. Valor predeterminado: el cifrado en el host se deshabilitará a menos que esta propiedad esté establecida en true para el recurso.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EvictionPolicy

Directiva de expulsión para el conjunto de escalado de máquinas virtuales de prioridad baja. Solo los valores admitidos son "Deallocate" y "Delete".

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FrontendPoolName

Nombre del grupo de direcciones de front-end que se va a usar en el equilibrador de carga del conjunto de escalado. Si no se proporciona ningún valor, se creará un nuevo grupo de direcciones de front-end, con el mismo nombre que el conjunto de escalado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-HostGroupId

Especifica el grupo host dedicado en el que residirá el conjunto de escalado de máquinas virtuales.

Tipo:String
Alias:HostGroup
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-IfMatch

se usa para realizar una solicitud condicional para put y otros métodos no seguros. El servidor solo devolverá los recursos solicitados si el recurso coincide con uno de los valores de ETag enumerados. Omita este valor para sobrescribir siempre el recurso actual. Especifique el valor de ETag visto por última vez para evitar que se sobrescriba accidentalmente los cambios simultáneos.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IfNoneMatch

Se usa para realizar una solicitud condicional para los métodos GET y HEAD. El servidor solo devolverá los recursos solicitados si ninguno de los valores de ETag enumerados coincide con la entidad actual. Se usa para realizar una solicitud condicional para los métodos GET y HEAD. El servidor solo devolverá los recursos solicitados si ninguno de los valores de ETag enumerados coincide con la entidad actual. Establézcalo en "*" para permitir la creación de un nuevo conjunto de registros, pero para evitar la actualización de un conjunto de registros existente. Otros valores producirán un error del servidor, ya que no se admiten.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ImageName

Alias de la imagen de las máquinas virtuales de este conjunto de escalado. Si no se proporciona ningún valor, se usará la imagen "Windows Server 2016 DataCenter". Los alias disponibles son: Win2022AzureEdition, Win2022AzureEditionCore, Win2019Datacenter, Win2016Datacenter, Win2012R2Datacenter, Win2012Datacenter, UbuntuLTS, Ubuntu2204, CentOS85Gen2, Debian11, OpenSuseLeap154Gen2, RHELRaw8LVMGen2, SuseSles15SP3, FlatcarLinuxFreeGen2.

Tipo:String
Alias:Image
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ImageReferenceId

Se especificó el identificador único de la imagen de la galería compartida para la implementación de vmss. Esto se puede capturar desde la llamada GET de la imagen de la galería compartida.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InstanceCount

Número de imágenes de máquina virtual en el conjunto de escalado. Si no se proporciona ningún valor, se crearán 2 instancias.

Tipo:Int32
Posición:Named
Valor predeterminado:2
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LoadBalancerName

Nombre del equilibrador de carga que se va a usar con este conjunto de escalado. Se creará un nuevo equilibrador de carga con el mismo nombre que el conjunto de escalado si no se especifica ningún valor.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Location

Ubicación de Azure donde se creará este conjunto de escalado. Si no se especifica ningún valor, la ubicación se deducirá de la ubicación de otros recursos a los que se hace referencia en los parámetros.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaxPrice

Precio máximo de la facturación de un conjunto de escalado de máquinas virtuales de prioridad baja.

Tipo:Double
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NatBackendPort

Puerto back-end para la traducción de direcciones de red entrantes.

Tipo:Int32[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OrchestrationMode

Especifica el modo de orquestación del conjunto de escalado de máquinas virtuales. Valores posibles: Uniforme, Flexible

La creación de un VMSS en OrchestrationMode:Flexible mediante el conjunto de parámetros predeterminado dará como resultado que virtualMachineScaleSetVMProfile se rellene de forma predeterminada. Si desea crear un VMSS con un virtualMachineScaleSetVMProfile vacío, cree primero un objeto VirtualMachineScaleSet con una propiedad VMProfile vacía mediante New-AzVmssConfig y, a continuación, cree vmSS mediante un conjunto de parámetros simple.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PlatformFaultDomainCount

Recuento de dominios de error para cada grupo de selección de ubicación.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Priority

Prioridad de la máquina virtual en el conjunto de escalado. Solo los valores admitidos son "Regular", "Spot" y "Low". "Regular" es para la máquina virtual normal. "Spot" es para la máquina virtual de acceso puntual. "Low" también es para la máquina virtual de acceso puntual, pero se reemplaza por "Spot". Use "Spot" en lugar de "Low".

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProximityPlacementGroupId

Identificador de recurso del grupo de selección de ubicación de proximidad que se va a usar con este conjunto de escalado.

Tipo:String
Alias:ProximityPlacementGroup
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PublicIpAddressName

Nombre de la dirección IP pública que se va a usar con este conjunto de escalado. Se creará una nueva dirección IP pública con el mismo nombre que el conjunto de escalado si no se proporciona ningún valor.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Especifica el nombre del grupo de recursos de VMSS. Si no se especifica ningún valor, se creará un nuevo ResourceGroup con el mismo nombre que el conjunto de escalado.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ScaleInPolicy

Las reglas que se van a seguir al escalar verticalmente un conjunto de escalado de máquinas virtuales. Los valores posibles son: "Default", "OldestVM" y "NewestVM". "Valor predeterminado" cuando se escala un conjunto de escalado de máquinas virtuales, el conjunto de escalado se equilibrará primero entre zonas si es un conjunto de escalado zonal. A continuación, se equilibrará entre dominios de error en la medida de lo posible. Dentro de cada dominio de error, las máquinas virtuales elegidas para la eliminación serán las más recientes que no están protegidas contra el escalado horizontal. "OldestVM" cuando se escala un conjunto de escalado de máquinas virtuales, se elegirán las máquinas virtuales más antiguas que no están protegidas contra el escalado horizontal para su eliminación. En el caso de los conjuntos de escalado de máquinas virtuales zonales, el conjunto de escalado primero se equilibrará entre zonas. Dentro de cada zona, se elegirán las máquinas virtuales más antiguas que no están protegidas para su eliminación. "NewestVM" cuando se escala un conjunto de escalado de máquinas virtuales, se elegirán las máquinas virtuales más recientes que no están protegidas contra el escalado horizontal. En el caso de los conjuntos de escalado de máquinas virtuales zonales, el conjunto de escalado primero se equilibrará entre zonas. Dentro de cada zona, se elegirán las máquinas virtuales más recientes que no están protegidas para su eliminación.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecurityGroupName

Nombre del grupo de seguridad de red que se va a aplicar a este conjunto de escalado. Si no se proporciona ningún valor, se creará un grupo de seguridad de red predeterminado con el mismo nombre que el conjunto de escalado y se aplicará al conjunto de escalado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SecurityType

Especifica securityType de la máquina virtual. Debe establecerse en cualquier valor especificado para habilitar UefiSettings. UefiSettings no se habilitará a menos que se establezca esta propiedad.

Tipo:String
Valores aceptados:TrustedLaunch, ConfidentialVM, Standard
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SharedGalleryImageId

Se especificó el identificador único de la imagen de la galería compartida para la implementación de la máquina virtual. Esto se puede capturar desde la llamada GET de la imagen de la galería compartida.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SinglePlacementGroup

Úselo para crear el conjunto de escalado en un único grupo de selección de ubicación, el valor predeterminado es varios grupos.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SkipExtensionsOnOverprovisionedVMs

Especifica que las extensiones no se ejecutan en las máquinas virtuales aprovisionadas adicionales.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SubnetAddressPrefix

Prefijo de dirección de la subred que usará este Conjunto de escalado. La configuración predeterminada de subred (192.168.1.0/24) se aplicará si no se proporciona ningún valor.

Tipo:String
Posición:Named
Valor predeterminado:192.168.1.0/24
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SubnetName

Nombre de la subred que se va a usar con este conjunto de escalado. Se creará una nueva subred con el mismo nombre que el conjunto de escalado si no se proporciona ningún valor.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SystemAssignedIdentity

Si el parámetro está presente, a las máquinas virtuales del conjunto de escalado se les asigna una identidad del sistema administrada que se genera automáticamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UpgradePolicyMode

Modo de directiva de actualización para las instancias de máquina virtual en este conjunto de escalado. La directiva de actualización podría especificar actualizaciones automáticas, manuales o graduales.

Tipo:UpgradeMode
Valores aceptados:Automatic, Manual, Rolling
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserAssignedIdentity

Nombre de una identidad de servicio administrada que se debe asignar a las máquinas virtuales del conjunto de escalado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserData

UserData para Vmss, que se codificará en base 64. El cliente no debe pasar ningún secreto aquí.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VirtualMachineScaleSet

Especifica el objeto VirtualMachineScaleSet que contiene las propiedades del VMSS que crea este cmdlet.

Tipo:PSVirtualMachineScaleSet
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VirtualNetworkName

Nombre de la red virtual que se va a usar con este conjunto de escalado. Si no se proporciona ningún valor, se creará una nueva red virtual con el mismo nombre que el conjunto de escalado.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMScaleSetName

Especifica el nombre del VMSS que crea este cmdlet.

Tipo:String
Alias:Name
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VmSize

Tamaño de las instancias de máquina virtual de este conjunto de escalado. Get-AzComputeResourceSku se puede usar para averiguar los tamaños disponibles de su suscripción y región. Se usará un tamaño predeterminado (Standard_DS1_v2) si no se especifica Size.

Tipo:String
Posición:Named
Valor predeterminado:Standard_DS1_v2
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VnetAddressPrefix

Prefijo de dirección de la red virtual que se usa con este conjunto de escalado. Se usará la configuración predeterminada del prefijo de dirección de red virtual (192.168.0.0/16) si no se proporciona ningún valor.

Tipo:String
Posición:Named
Valor predeterminado:192.168.0.0/16
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Zone

Una lista de zonas de disponibilidad de las que se indica la dirección IP asignada para el recurso debe proceder.

Tipo:List<T>[String]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

String

PSVirtualMachineScaleSet

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

Salidas

PSVirtualMachineScaleSet