New-AzVmssConfig

Skapar ett VMSS-konfigurationsobjekt.

Anteckning

Det här är den tidigare versionen av vår dokumentation. Se den senaste versionen för uppdaterad information.

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

Cmdleten New-AzVmssConfig skapar ett konfigurerbart lokalt VMSS-objekt (Virtual Manager Scale Set). Andra cmdletar behövs för att konfigurera VMSS-objektet. Dessa cmdletar är:

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

Exempel

Exempel 1: Skapa ett VMSS-konfigurationsobjekt

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

I det här exemplet skapas ett VMSS-konfigurationsobjekt. Det första kommandot använder cmdleten New-AzVmssConfig för att skapa ett VMSS-konfigurationsobjekt och lagrar resultatet i variabeln med namnet $VMSS. Det andra kommandot använder cmdleten New-AzVmss för att skapa en VMSS som använder VMSS-konfigurationsobjektet som skapades i det första kommandot.

Exempel 2

Skapar ett VMSS-konfigurationsobjekt. (genereras automatiskt)

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

Exempel 3

Skapar ett VMSS-konfigurationsobjekt. (genereras automatiskt)

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

Parametrar

-AutomaticRepairAction

Typ av reparationsåtgärd (ersätt, starta om, avbildning) som ska användas för att reparera virtuella datorer med feltillstånd i skalningsuppsättningen. Standardvärdet är replace.

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

Hur lång tid automatiska reparationer pausas på grund av en tillståndsändring på den virtuella datorn. Respittiden börjar när tillståndsändringen har slutförts. Detta hjälper till att undvika för tidiga eller oavsiktliga reparationer. Tidsåtgången ska anges i ISO 8601-format. Den minsta tillåtna respitperioden är 30 minuter (PT30M), vilket också är standardvärdet. Den maximala tillåtna respitperioden är 90 minuter (PT90M).

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

Anger om OS-uppgraderingar ska tillämpas automatiskt på skalningsuppsättningsinstanser löpande när en nyare version av avbildningen blir tillgänglig.

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

Anger startdiagnostikprofilen för VM-skalningsuppsättningen.

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

ID för kapacitetsreservationsgruppen som används för allokering.

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

Uppmanar dig att bekräfta innan du kör cmdleten.

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

Autentiseringsuppgifterna, kontot, klientorganisationen och prenumerationen som används för kommunikation med Azure.

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

Inaktivera automatisk återställning för princip för automatisk uppgradering av operativsystem

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

Anger gränszonens namn. Om den anges dirigeras frågan till den angivna gränszonen i stället för huvudregionen.

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

Aktiverar automatiska reparationer på VM-skalningsuppsättningen.

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

Aktiverar funktionen Spot-Try-Restore där avlägsnade VMSS SPOT-instanser kommer att försöka återställas opportunistiskt baserat på kapacitetstillgänglighet och prisbegränsningar

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

Gör det möjligt att ha en eller flera hanterade datadiskar med UltraSSD_LRS lagringskontotyp på VM-skalningsuppsättningen. Hanterade diskar med lagringskontotyp UltraSSD_LRS kan bara läggas till i en VMSS om den här egenskapen är aktiverad.

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

Den här parametern aktiverar kryptering för alla diskar, inklusive resurs/temporär disk på själva värden. Standard: Krypteringen på värden inaktiveras om inte den här egenskapen är inställd på true för resursen.

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

Anger borttagningsprincipen för de virtuella datorerna i skalningsuppsättningen.

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

Anger informationsobjektet för tillägget för VMSS. Du kan använda cmdleten Add-AzVmssExtension för att lägga till det här objektet.

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

Anger ID:t för en lastbalanseringsavsökning som används för att fastställa hälsotillståndet för en instans i VM-skalningsuppsättningen. HealthProbeId är i form av '/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

Anger listan över användaridentiteter som är associerade med VM-skalningsuppsättningen. Referenserna för användaridentiteten är ARM-resurs-ID:n i formatet: '/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

Anger vilken typ av identitet som används för VM-skalningsuppsättningen. Typen "SystemAssignedUserAssigned" innehåller både en implicit skapad identitet och en uppsättning användartilldelade identiteter. Typen None tar bort alla identiteter från VM-skalningsuppsättningen. De acceptabla värdena för den här parametern är:

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

Ange licenstypen, som är till för att ta med ditt eget licensscenario.

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

Anger den Azure-plats där VMSS skapas.

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

Anger det högsta pris som du är villig att betala för en virtuell dator med oanvänd kapacitet/VMSS. Det här priset är i us-dollar. Det här priset jämförs med det aktuella spotpriset för VM-storleken. Dessutom jämförs priserna vid tidpunkten för skapande/uppdatering av VM/VMSS för oanvänd kapacitet och åtgärden lyckas bara om maxPriset är större än det aktuella spotpriset. MaxPrice kommer också att användas för att ta bort en virtuell dator för oanvänd kapacitet/VMSS om det aktuella spotpriset överskrider maxPriset när den virtuella datorn/VMSS har skapats. Möjliga värden är: ett decimalvärde som är större än noll. Exempel: 0.01538. -1 anger att vm/VMSS för oanvänd kapacitet inte ska avlägsnas av prisskäl. Dessutom är det högsta standardpriset -1 om det inte tillhandahålls av dig.

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

Anger nätverksprofilobjektet som innehåller nätverksegenskaperna för VMSS-konfigurationen. Du kan använda cmdleten Add-AzVmssNetworkInterfaceConfiguration för att lägga till det här objektet.

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

Anger orkestreringsläget för VM-skalningsuppsättningen. Möjliga värden: Enhetliga, flexibla

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

Anger det operativsystemprofilobjekt som innehåller operativsystemets egenskaper för VMSS-konfigurationen. Du kan använda cmdleten Set-AzVmssOsProfile för att ange det här objektet.

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

Anger om cmdleten överetablerar VMSS.

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

Anger planens namn.

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

Anger planprodukten.

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

Anger koden för planhöjning.

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

Anger planutgivaren.

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

Antal feldomäner för varje placeringsgrupp.

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

Prioriteten för den virtuella machien i skalningsuppsättningen. Endast värden som stöds är "Regular", "Spot" och "Low". "Vanlig" är för vanliga virtuella datorer. "Spot" är avsedd för virtuell dator för oanvänd kapacitet. "Låg" är också för virtuell dator med oanvänd kapacitet men ersätts av "Spot". Använd "Spot" i stället för "Low".

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

Resurs-ID för närhetsplaceringsgruppen som ska användas med den här skalningsuppsättningen.

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

Anger principen för löpande uppgradering.

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

De regler som ska följas när du skalar in en VM-skalningsuppsättning. Möjliga värden är: "Default", "OldestVM" och "NewestVM". "Standard" när en VM-skalningsuppsättning skalas in balanseras först skalningsuppsättningen mellan zoner om det är en zonindelad skalningsuppsättning. Sedan balanseras den över feldomäner så långt det är möjligt. I varje feldomän är de virtuella datorer som valts för borttagning de senaste som inte skyddas från inskalning. "OldestVM" när en VM-skalningsuppsättning skalas in väljs de äldsta virtuella datorerna som inte skyddas från inskalning för borttagning. För zonindelade VM-skalningsuppsättningar balanseras först skalningsuppsättningen mellan zoner. I varje zon väljs de äldsta virtuella datorerna som inte är skyddade för borttagning. "NewestVM" när en VM-skalningsuppsättning skalas in väljs de senaste virtuella datorerna som inte skyddas från inskalning för borttagning. För zonindelade VM-skalningsuppsättningar balanseras först skalningsuppsättningen mellan zoner. I varje zon väljs de senaste virtuella datorerna som inte skyddas för borttagning.

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

Anger den enskilda placeringsgruppen.

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

Anger att tilläggen inte körs på de extra överetablerade virtuella datorerna.

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

Anger antalet instanser i VMSS.

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

Anger storleken på alla instanser av VMSS.

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

Anger nivån för VMSS. De acceptabla värdena för den här parametern är:

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

Anger timeout-värdet uttryckt som en ISO 8601-varaktighet efter vilken plattformen inte kommer att försöka återställa VMSS SPOT-instanserna

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

Anger lagringsprofilobjektet som innehåller diskegenskaperna för VMSS-konfigurationen. Du kan använda cmdleten Set-AzVmssStorageProfile för att ange det här objektet.

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

Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0";key1=$null;key2="value2"}

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

Konfigurerbar tid (i minuter) en virtuell dator som tas bort måste eventuellt godkänna avsluta schemalagd händelse innan händelsen godkänns automatiskt (tidsgränsen uppnås).

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

Aktivera avsluta schemalagda händelser

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

Angav läget för en uppgradering till virtuella datorer i skalningsuppsättningen. De acceptabla värdena för den här parametern är:

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

UserData för den virtuella datorn, som kommer att vara base-64-kodad. Kunden bör inte skicka in några hemligheter här.

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

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Anger zonlistan för VM-skalningsuppsättningen.

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

Om du vill framtvinga strikt jämn distribution av virtuella datorer mellan x-zoner om det skulle uppstå zonstopp.

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

Indata

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

Utdata

PSVirtualMachineScaleSet