New-AzVmssConfig

Hiermee maakt u een VMSS-configuratieobject.

Notitie

Dit is de vorige versie van onze documentatie. Raadpleeg de meest recente versie voor actuele informatie.

Syntax

New-AzVmssConfig
   [[-Overprovision] <Boolean>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [[-Tag] <Hashtable>]
   [[-SkuName] <String>]
   [[-SkuTier] <String>]
   [[-SkuCapacity] <Int32>]
   [[-UpgradePolicyMode] <UpgradeMode>]
   [[-OsProfile] <VirtualMachineScaleSetOSProfile>]
   [[-StorageProfile] <VirtualMachineScaleSetStorageProfile>]
   [[-NetworkInterfaceConfiguration] <VirtualMachineScaleSetNetworkConfiguration[]>]
   [[-Extension] <PSVirtualMachineScaleSetExtension[]>]
   [-SkipExtensionsOnOverprovisionedVMs]
   [-SinglePlacementGroup <Boolean>]
   [-ZoneBalance]
   [-PlatformFaultDomainCount <Int32>]
   [-Zone <String[]>]
   [-PlanName <String>]
   [-PlanPublisher <String>]
   [-PlanProduct <String>]
   [-PlanPromotionCode <String>]
   [-RollingUpgradePolicy <RollingUpgradePolicy>]
   [-EnableAutomaticRepair]
   [-AutomaticRepairGracePeriod <String>]
   [-AutoOSUpgrade]
   [-DisableAutoRollback <Boolean>]
   [-EnableUltraSSD]
   [-HealthProbeId <String>]
   [-BootDiagnostic <BootDiagnostics>]
   [-LicenseType <String>]
   [-Priority <String>]
   [-EnableSpotRestore]
   [-SpotRestoreTimeout <String>]
   [-EvictionPolicy <String>]
   [-MaxPrice <Double>]
   [-TerminateScheduledEvents]
   [-TerminateScheduledEventNotBeforeTimeoutInMinutes <Int32>]
   [-ProximityPlacementGroupId <String>]
   [-ScaleInPolicy <String[]>]
   [-EncryptionAtHost]
   [-OrchestrationMode <String>]
   [-CapacityReservationGroupId <String>]
   [-UserData <String>]
   [-AutomaticRepairAction <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzVmssConfig
   [[-Overprovision] <Boolean>]
   [[-Location] <String>]
   [-EdgeZone <String>]
   [[-Tag] <Hashtable>]
   [[-SkuName] <String>]
   [[-SkuTier] <String>]
   [[-SkuCapacity] <Int32>]
   [[-UpgradePolicyMode] <UpgradeMode>]
   [[-OsProfile] <VirtualMachineScaleSetOSProfile>]
   [[-StorageProfile] <VirtualMachineScaleSetStorageProfile>]
   [[-NetworkInterfaceConfiguration] <VirtualMachineScaleSetNetworkConfiguration[]>]
   [[-Extension] <PSVirtualMachineScaleSetExtension[]>]
   [-SkipExtensionsOnOverprovisionedVMs]
   [-SinglePlacementGroup <Boolean>]
   [-ZoneBalance]
   [-PlatformFaultDomainCount <Int32>]
   [-Zone <String[]>]
   [-PlanName <String>]
   [-PlanPublisher <String>]
   [-PlanProduct <String>]
   [-PlanPromotionCode <String>]
   [-RollingUpgradePolicy <RollingUpgradePolicy>]
   [-EnableAutomaticRepair]
   [-AutomaticRepairGracePeriod <String>]
   [-AutoOSUpgrade]
   [-DisableAutoRollback <Boolean>]
   [-EnableUltraSSD]
   [-HealthProbeId <String>]
   [-BootDiagnostic <BootDiagnostics>]
   [-LicenseType <String>]
   [-Priority <String>]
   [-EnableSpotRestore]
   [-SpotRestoreTimeout <String>]
   [-EvictionPolicy <String>]
   [-MaxPrice <Double>]
   [-TerminateScheduledEvents]
   [-TerminateScheduledEventNotBeforeTimeoutInMinutes <Int32>]
   [-ProximityPlacementGroupId <String>]
   [-ScaleInPolicy <String[]>]
   -IdentityType <ResourceIdentityType>
   [-IdentityId <String[]>]
   [-EncryptionAtHost]
   [-OrchestrationMode <String>]
   [-CapacityReservationGroupId <String>]
   [-UserData <String>]
   [-AutomaticRepairAction <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Met de cmdlet New-AzVmssConfig maakt u een configureerbaar lokaal VMSS-object (Virtual Manager Scale Set). Er zijn andere cmdlets nodig om het VMSS-object te configureren. Deze cmdlets zijn:

  • Set-AzVmssOsProfile
  • Set-AzVmssStorageProfile
  • Add-AzVmssNetworkInterfaceConfiguration
  • Add-AzVmssExtension

Voorbeelden

Voorbeeld 1: Een VMSS-configuratieobject maken

$VMSS = New-AzVmssConfig -Location $Loc -SkuCapacity 2 -SkuName "Standard_A0" -UpgradePolicyMode "Automatic" -NetworkInterfaceConfiguration $NetCfg `
            | Add-AzVmssNetworkInterfaceConfiguration -Name "Test" -Primary $True -IPConfiguration $IPCfg `
            | Set-AzVmssOSProfile -ComputerNamePrefix "Test" -AdminUsername $adminUsername -AdminPassword $AdminPassword `
            | Set-AzVmssStorageProfile -Name "Test" -OsDiskCreateOption "FromImage" -OsDiskCaching "None" `
            -ImageReferenceOffer $ImgRef.Offer -ImageReferenceSku $ImgRef.Skus -ImageReferenceVersion $ImgRef.Version `
            -ImageReferencePublisher $ImgRef.PublisherName -VhdContainer $VHDContainer `
            | Add-AzVmssAdditionalUnattendContent -ComponentName  $AUCComponentName -Content  $AUCContent -PassName  $AUCPassName -SettingName  $AUCSetting;

New-AzVmss -ResourceGroupName $RGName -Name $VMSSName -VirtualMachineScaleSet $VMSS;

In dit voorbeeld wordt een VMSS-configuratieobject gemaakt. De eerste opdracht maakt gebruik van de cmdlet New-AzVmssConfig om een VMSS-configuratieobject te maken en slaat het resultaat op in de variabele met de naam $VMSS. De tweede opdracht maakt gebruik van de cmdlet New-AzVmss om een VMSS te maken die gebruikmaakt van het VMSS-configuratieobject dat in de eerste opdracht is gemaakt.

Voorbeeld 2

Hiermee maakt u een VMSS-configuratieobject. (automatisch gegenereerd)

New-AzVmssConfig -Location <String> -Overprovision $false -SkuCapacity 2 -SkuName 'Standard_A0' -Tag @{key0="value0";key1=$null;key2="value2"} -UpgradePolicyMode Automatic;

Voorbeeld 3

Hiermee maakt u een VMSS-configuratieobject. (automatisch gegenereerd)

New-AzVmssConfig -Location <String> -SkuCapacity 2 -SkuName 'Standard_A0' -UpgradePolicyMode Automatic -IdentityType SystemAssigned;

Parameters

-AutomaticRepairAction

Type herstelactie (vervangen, opnieuw opstarten, installatiekopie herstellen) dat wordt gebruikt voor het herstellen van beschadigde virtuele machines in de schaalset. De standaardwaarde wordt vervangen.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-AutomaticRepairGracePeriod

De hoeveelheid tijd waarvoor automatische reparaties worden onderbroken vanwege een statuswijziging op de VM. De respijttijd begint nadat de statuswijziging is voltooid. Zo voorkomt u voortijdige of onbedoelde reparaties. De tijdsduur moet worden opgegeven in ISO 8601-indeling. De minimaal toegestane respijtperiode is 30 minuten (PT30M), wat ook de standaardwaarde is. De maximaal toegestane respijtperiode is 90 minuten (PT90M).

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-AutoOSUpgrade

Hiermee stelt u in of besturingssysteemupgrades automatisch moeten worden toegepast op exemplaren van schaalsets wanneer er een nieuwere versie van de installatiekopie beschikbaar komt.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BootDiagnostic

Hiermee geeft u het diagnostische profiel van de virtuele-machineschaalset op.

Type:BootDiagnostics
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-CapacityReservationGroupId

Id van de capaciteitsreserveringsgroep die wordt gebruikt om toe te wijzen.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableAutoRollback

Automatisch terugdraaien uitschakelen voor beleid voor automatische upgrade van het besturingssysteem

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EdgeZone

Hiermee stelt u de naam van de randzone in. Als deze optie is ingesteld, wordt de query doorgestuurd naar de opgegeven edgezone in plaats van de hoofdregio.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-EnableAutomaticRepair

Hiermee schakelt u automatische reparaties in op de virtuele-machineschaalset.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-EnableSpotRestore

Hiermee schakelt u de functie Spot-Try-Restore in waarbij verwijderde VMSS SPOT-exemplaren opportunistisch worden hersteld op basis van capaciteitsbeschikbaarheid en prijsbeperkingen

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-EnableUltraSSD

Hiermee kunt u een of meer beheerde gegevensschijven met UltraSSD_LRS opslagaccounttype op de virtuele-machineschaalset hebben. Beheerde schijven met het type opslagaccount UltraSSD_LRS kunnen alleen worden toegevoegd aan een VMSS als deze eigenschap is ingeschakeld.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-EncryptionAtHost

Met deze parameter wordt de versleuteling ingeschakeld voor alle schijven, inclusief resource/temp-schijf op de host zelf. Standaard: De versleuteling op de host wordt uitgeschakeld, tenzij deze eigenschap is ingesteld op true voor de resource.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-EvictionPolicy

Hiermee geeft u het verwijderingsbeleid voor de virtuele machines in de schaalset.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Extension

Hiermee geeft u het extensie-informatieobject voor de VMSS. U kunt de cmdlet Add-AzVmssExtension gebruiken om dit object toe te voegen.

Type:PSVirtualMachineScaleSetExtension[]
Position:10
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-HealthProbeId

Hiermee geeft u de id op van een load balancer-test die wordt gebruikt om de status van een exemplaar in de virtuele-machineschaalset te bepalen. HealthProbeId heeft de vorm '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-IdentityId

Hiermee geeft u de lijst met gebruikersidentiteiten die zijn gekoppeld aan de virtuele-machineschaalset. De verwijzingen naar gebruikersidentiteiten zijn ARM-resource-id's in de vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-IdentityType

Hiermee geeft u het type identiteit op dat wordt gebruikt voor de virtuele-machineschaalset. Het type SystemAssignedUserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type 'Geen' worden alle identiteiten uit de virtuele-machineschaalset verwijderd. De aanvaardbare waarden voor deze parameter zijn:

  • SystemAssigned
  • UserAssigned
  • SystemAssignedUserAssigned
  • Geen
Type:Nullable<T>[ResourceIdentityType]
Accepted values:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-LicenseType

Geef het licentietype op. Dit is bedoeld voor het meenemen van uw eigen licentiescenario.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Location

Hiermee geeft u de Azure-locatie op waar de VMSS wordt gemaakt.

Type:String
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-MaxPrice

Hiermee geeft u de maximale prijs die u wilt betalen voor een spot-VM/VMSS. Deze prijs is in Amerikaanse dollars. Deze prijs wordt vergeleken met de huidige spotprijs voor de VM-grootte. De prijzen worden ook vergeleken op het moment van het maken/bijwerken van Spot VM/VMSS en de bewerking slaagt alleen als de maxPrice groter is dan de huidige spotprijs. De maxPrice wordt ook gebruikt voor het verwijderen van een spot-VM/VMSS als de huidige spotprijs hoger is dan maxPrice na het maken van VM/VMSS. Mogelijke waarden zijn: elke decimale waarde die groter is dan nul. Voorbeeld: 0.01538. -1 geeft aan dat de spot-VM/VMSS om prijsredenen niet mag worden verwijderd. De standaard maximumprijs is -1 als deze niet door u wordt verstrekt.

Type:Double
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-NetworkInterfaceConfiguration

Hiermee geeft u het netwerkprofielobject op dat de netwerkeigenschappen voor de VMSS-configuratie bevat. U kunt de cmdlet Add-AzVmssNetworkInterfaceConfiguration gebruiken om dit object toe te voegen.

Type:VirtualMachineScaleSetNetworkConfiguration[]
Position:9
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-OrchestrationMode

Hiermee geeft u de indelingsmodus voor de virtuele-machineschaalset op. Mogelijke waarden: Uniform, Flexibel

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-OsProfile

Hiermee geeft u het profielobject van het besturingssysteem dat de eigenschappen van het besturingssysteem voor de VMSS-configuratie bevat. U kunt de cmdlet Set-AzVmssOsProfile gebruiken om dit object in te stellen.

Type:VirtualMachineScaleSetOSProfile
Position:7
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Overprovision

Hiermee wordt aangegeven of de cmdlet de VMSS overprovisioneert.

Type:Nullable<T>[Boolean]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PlanName

Hiermee geeft u de naam van het plan op.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PlanProduct

Hiermee geeft u het planproduct.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PlanPromotionCode

Hiermee geeft u de promotiecode van het plan.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PlanPublisher

Hiermee geeft u de uitgever van het plan op.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-PlatformFaultDomainCount

Aantal foutdomeinen voor elke plaatsingsgroep.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Priority

De prioriteit voor de virtuele vm in de schaalset. Alleen ondersteunde waarden zijn 'Regular', 'Spot' en 'Low'. 'Normaal' is voor reguliere virtuele machine. Spot is voor spot-VM. 'Laag' is ook bedoeld voor spot-VM's, maar wordt vervangen door Spot. Gebruik Spot in plaats van 'Laag'.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ProximityPlacementGroupId

De resource-id van de nabijheidsplaatsingsgroep die moet worden gebruikt met deze schaalset.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-RollingUpgradePolicy

Hiermee geeft u het beleid voor rolling upgrades op.

Type:RollingUpgradePolicy
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ScaleInPolicy

De regels die moeten worden gevolgd bij het schalen van een virtuele-machineschaalset. Mogelijke waarden zijn: 'Default', 'OldestVM' en 'NewestVM'. 'Standaard' wanneer een virtuele-machineschaalset wordt ingeschaald, wordt de schaalset eerst verdeeld over zones als het een zonegebonden schaalset is. Vervolgens wordt het zo veel mogelijk verdeeld over foutdomeinen. Binnen elk foutdomein zijn de virtuele machines die zijn gekozen voor verwijdering, de nieuwste machines die niet zijn beveiligd tegen inschalen. 'OudsteVM' wanneer een virtuele-machineschaalset wordt ingeschaald, worden de oudste virtuele machines die niet zijn beveiligd tegen inschalen gekozen voor verwijdering. Voor zonegebonden virtuele-machineschaalsets wordt de schaalset eerst verdeeld over zones. Binnen elke zone worden de oudste virtuele machines die niet zijn beveiligd gekozen voor verwijdering. 'NieuwsteVM' wanneer een virtuele-machineschaalset wordt ingeschaald, worden de nieuwste virtuele machines die niet zijn beveiligd tegen inschalen gekozen voor verwijdering. Voor zonegebonden virtuele-machineschaalsets wordt de schaalset eerst verdeeld over zones. Binnen elke zone worden de nieuwste virtuele machines die niet zijn beveiligd gekozen voor verwijdering.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-SinglePlacementGroup

Hiermee geeft u de groep met één plaatsing op.

Type:Nullable<T>[Boolean]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-SkipExtensionsOnOverprovisionedVMs

Hiermee geeft u op dat de extensies niet worden uitgevoerd op de extra overprovisioned VM's.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SkuCapacity

Hiermee geeft u het aantal exemplaren in de VMSS.

Type:Int32
Position:5
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-SkuName

Hiermee geeft u de grootte van alle exemplaren van VMSS.

Type:String
Aliases:AccountType
Position:3
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-SkuTier

Hiermee geeft u de laag van VMSS. De aanvaardbare waarden voor deze parameter zijn:

  • Standard
  • Basic
Type:String
Position:4
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-SpotRestoreTimeout

Hiermee geeft u de time-outwaarde op die wordt uitgedrukt als een ISO 8601-tijdsduur, waarna het platform de VMSS SPOT-exemplaren niet probeert te herstellen

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-StorageProfile

Hiermee geeft u het opslagprofielobject op dat de schijfeigenschappen voor de VMSS-configuratie bevat. U kunt de cmdlet Set-AzVmssStorageProfile gebruiken om dit object in te stellen.

Type:VirtualMachineScaleSetStorageProfile
Position:8
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0";key1=$null;key2="value2"}

Type:Hashtable
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-TerminateScheduledEventNotBeforeTimeoutInMinutes

Configureerbare tijdsduur (in minuten) een virtuele machine die wordt verwijderd, moet de geplande beëindigingsgebeurtenis mogelijk goedkeuren voordat de gebeurtenis automatisch wordt goedgekeurd (time-out).

Type:Int32
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-TerminateScheduledEvents

Geplande gebeurtenissen beëindigen inschakelen

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-UpgradePolicyMode

De modus van een upgrade naar virtuele machines in de schaalset opgegeven. De aanvaardbare waarden voor deze parameter zijn:

  • Automatisch
  • Handmatig
Type:Nullable<T>[UpgradeMode]
Accepted values:Automatic, Manual, Rolling
Position:6
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-UserData

UserData voor de VM, die wordt gecodeerd met base-64. Klant mag hier geen geheimen doorgeven.

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Zone

Hiermee geeft u de zonelijst voor de virtuele-machineschaalset.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-ZoneBalance

Of de distributie van virtuele machines strikt zelfs x-zones moet afdwingen voor het geval er sprake is van een zonestoring.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

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

String

Hashtable

Int32

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.UpgradeMode, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

VirtualMachineScaleSetOSProfile

VirtualMachineScaleSetStorageProfile

VirtualMachineScaleSetNetworkConfiguration[]

VirtualMachineScaleSetExtension[]

String[]

RollingUpgradePolicy

SwitchParameter

BootDiagnostics

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.ResourceIdentityType, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Uitvoerwaarden

PSVirtualMachineScaleSet