New-AzVmss

Syntax

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

Beschreibung

Das Cmdlet New-AzVmss erstellt einen VM Scale Set (VMSS) in Azure. Verwenden Sie den einfachen Parametersatz (SimpleParameterSet), um schnell eine vordefinierte VMSS und zugeordnete Ressourcen zu erstellen.

Verwenden Sie den Standardparametersatz (DefaultParameter) für komplexere Szenarien, wenn Sie jede Komponente der VMSS und jeder zugeordneten Ressource vor der Erstellung genau konfigurieren müssen. Verwenden Sie für den Standardparametersatz zuerst das Cmdlet New-AzVmssConfig , um ein VM-Skalierungssatzobjekt zu erstellen.

Verwenden Sie dann die folgenden Cmdlets, um verschiedene Eigenschaften des Skalierungssatzobjekts des virtuellen Computers festzulegen:

• Add-AzVmssNetworkInterfaceConfiguration zum Festlegen des Netzwerkprofils.
  
• Set-AzVmssOsProfile zum Festlegen des Betriebssystemprofils.
  
• Set-AzVmssStorageProfile zum Festlegen des Speicherprofils.
  
• Get-AzComputeResourceSku kann auch verwendet werden, um verfügbare Größen für virtuelle Computer für Ihr Abonnement und Ihre Region zu ermitteln.
  

Weitere Cmdlets für skalierungsgruppe virtueller Computer finden Sie hier.

VMSS creation will default to OrchestrationMode:Flexible. Der Standardparametersatz legt standardmäßig Eigenschaften in VirtualMachineScaleSetVMProfile fest. Verwenden Sie zum Erstellen einer VMSS mit einer leeren VirtualMachineScaleSetVMProfile-Eigenschaft zunächst einen einfachen Parametersatz, indem Sie zuerst ein VirtualMachineScaleSet-Objekt mit einer leeren VirtualMachineScaleSetVMProfile-Eigenschaft mithilfe von New-AzVmssConfig erstellen.

Weitere Informationen finden Sie unter [Schnellstart: Erstellen eines Skalierungssatzes für virtuelle Computer mit Azure PowerShell](https://video2.skills-academy.com/en-us/azure/virtual-machine-scale-sets/quick-create-powershell) zum Lernprogramm.

Beispiele

Beispiel 1: Erstellen einer VMSS mit dem 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

Der obige Befehl erstellt Folgendes mit dem Namen $vmssName :

• Eine Ressourcengruppe
• Ein virtuelles Netzwerk
• Ein Load Balancer
• Eine öffentliche IP-Adresse
• vmSS mit 2 Instanzen

Das Standardimage, das für die virtuellen Computer im VMSS ausgewählt wird, ist 2016-Datacenter Windows Server und die SKU ist Standard_DS1_v2

Beispiel 2: Erstellen einer VMSS mithilfe des 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;

Im obigen komplexen Beispiel wird ein VMSS erstellt. Im Folgenden wird erläutert, was passiert:

• Der erste Befehl erstellt eine Ressourcengruppe mit dem angegebenen Namen und Speicherort.
• Der zweite Befehl verwendet das Cmdlet New-AzStorageAccount zum Erstellen eines Speicherkontos.
• Der dritte Befehl verwendet dann das Cmdlet "Get-AzStorageAccount ", um das speicherkonto abzurufen, das im zweiten Befehl erstellt wurde, und speichert das Ergebnis in der $STOAccount Variablen.
• Der fünfte Befehl verwendet das Cmdlet New-AzVirtualNetworkSubnetConfig zum Erstellen eines Subnetzes und speichert das Ergebnis in der Variablen namens $SubNet.
• Der sechste Befehl verwendet das Cmdlet New-AzVirtualNetwork , um ein virtuelles Netzwerk zu erstellen und speichert das Ergebnis in der Variablen namens $VNet.
• Der siebte Befehl verwendet das Get-AzVirtualNetwork , um Informationen über das virtuelle Netzwerk abzurufen, das im sechsten Befehl erstellt wurde, und speichert die Informationen in der Variablen namens $VNet.
• Der achte und neunte Befehl verwendet die New-AzPublicIpAddress und Get- AzureRmPublicIpAddress , um Informationen von dieser öffentlichen IP-Adresse zu erstellen und abzurufen.
• Die Befehle speichern die Informationen in der Variablen namens $PubIP.
• Der zehnte Befehl verwendet das Cmdlet New- AzureRmLoadBalancerFrontendIpConfig zum Erstellen eines Frontend-Lastenausgleichs und speichert das Ergebnis in der Variablen namens $Frontend.
• Der elfte Befehl verwendet die New-AzLoadBalancerBackendAddressPoolConfig zum Erstellen einer Back-End-Adresspoolkonfiguration und speichert das Ergebnis in der Variablen namens $BackendAddressPool.
• Der zwölfte Befehl verwendet die New-AzLoadBalancerProbeConfig , um einen Probepunkt zu erstellen und die Probeinformationen in der Variablen namens $Probe zu speichern.
• Der dreizehnte Befehl verwendet das Cmdlet New-AzLoadBalancerInboundNatPoolConfig , um eine NAT-Poolkonfiguration (Load Balancer inbound Network Address Translation) zu erstellen.
• Der vierzehnte Befehl verwendet die New-AzLoadBalancerRuleConfig zum Erstellen einer Lastenausgleichsregelkonfiguration und speichert das Ergebnis in der Variablen namens $LBRule.
• Der fünfzehnte Befehl verwendet das Cmdlet New-AzLoadBalancer zum Erstellen eines Lastenausgleichs und speichert das Ergebnis in der Variablen mit dem Namen $ActualLb.
• Der sechzehnte Befehl verwendet den Get-AzLoadBalancer , um Informationen zum Lastenausgleich abzurufen, der im fünfzehnten Befehl erstellt wurde, und speichert die Informationen in der Variablen mit dem Namen $ExpectedLb.
• Der siebzehnte Befehl verwendet das Cmdlet New-AzVmssIpConfig , um eine VMSS-IP-Konfiguration zu erstellen und die Informationen in der Variablen namens $IPCfg zu speichern.
• Der achtzehnte Befehl verwendet das Cmdlet New-AzVmssConfig zum Erstellen eines VMSS-Konfigurationsobjekts und speichert das Ergebnis in der Variablen namens $VMSS.
• Der neunzehnte Befehl verwendet das Cmdlet New-AzVmss , um vmSS zu erstellen.

Beispiel 3: Erstellen eines VMSS mit einem UserData-Wert

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

Erstellen eines VMSS mit einem UserData-Wert

Beispiel 4: Erstellen einer VMss mit dem Sicherheitstyp 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;

In diesem Beispiel wird ein neuer VMSS mit dem neuen Sicherheitstyp "TrustedLaunch" und den erforderlichen UEFISettings-Werten erstellt, VTpmEnabled und SecureBootEnalbed sind wahr. Weitere Informationen finden Sie auf der Seite "Vertrauenswürdige Startfeatures" .

Beispiel 5: Erstellen einer VMss im Orchestrierungsmodus: Standardmäßig flexibel

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

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

In diesem Beispiel wird ein neuer VMSS erstellt und standardmäßig "OrchestrationMode Flexible" verwendet.

Beispiel 6: Standardmäßig ein neues VMSS erstellen, bei dem "TrustedLaunch" aktiviert ist.

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

Der oben festgelegte Skalierungssatz für virtuelle Computer weist standardmäßig die Option "Vertrauenswürdige Start" auf. Weitere Informationen finden Sie auf der Seite "Vertrauenswürdige Startfeatures" .

Parameter

-AllocationMethod

-AsJob

-BackendPoolName

-BackendPort

-CapacityReservationGroupId

-Confirm

-Credential

-DataDiskSizeInGb

-DefaultProfile

-DiskControllerType

-DomainNameLabel

-EdgeZone

-EnableAutomaticOSUpgrade

-EnableSecureBoot

-EnableUltraSSD

-EnableVtpm

-EncryptionAtHost

-EvictionPolicy

-FrontendPoolName

-HostGroupId

-IfMatch

-IfNoneMatch

-ImageName

-ImageReferenceId

-InstanceCount

-LoadBalancerName

-Location

-MaxPrice

-NatBackendPort

-OrchestrationMode

-PlatformFaultDomainCount

-Priority

-ProximityPlacementGroupId

-PublicIpAddressName

-ResourceGroupName

-ScaleInPolicy

-SecurityGroupName

-SecurityPostureExcludeExtension

-SecurityPostureId

-SecurityType

-SharedGalleryImageId

-SinglePlacementGroup

-SkipExtensionsOnOverprovisionedVMs

-SkuProfileAllocationStrategy

-SkuProfileVmSize

-SubnetAddressPrefix

-SubnetName

-SystemAssignedIdentity

-UpgradePolicyMode

-UserAssignedIdentity

-UserData

-VirtualMachineScaleSet

-VirtualNetworkName

-VMScaleSetName

-VmSize

-VnetAddressPrefix

-WhatIf

-Zone

Eingaben

String

PSVirtualMachineScaleSet

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

Ausgaben

PSVirtualMachineScaleSet

Ähnliche Themen

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