Update-AzVmss

Uppdateringar tillståndet för en VMSS.

Anteckning

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

Syntax

Update-AzVmss
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
      [-AutomaticOSUpgrade <Boolean>]
      [-AutomaticRepairGracePeriod <String>]
      [-BootDiagnosticsEnabled <Boolean>]
      [-BootDiagnosticsStorageUri <String>]
      [-CustomData <String>]
      [-DisableAutoRollback <Boolean>]
      [-DisablePasswordAuthentication <Boolean>]
      [-EnableAutomaticRepair <Boolean>]
      [-EnableAutomaticUpdate <Boolean>]
      [-ImageReferenceId <String>]
      [-ImageReferenceOffer <String>]
      [-ImageReferencePublisher <String>]
      [-ImageReferenceSku <String>]
      [-ImageReferenceVersion <String>]
      [-ImageUri <String>]
      [-LicenseType <String>]
      [-ManagedDiskStorageAccountType <String>]
      [-MaxBatchInstancePercent <Int32>]
      [-MaxPrice <Double>]
      [-MaxUnhealthyInstancePercent <Int32>]
      [-MaxUnhealthyUpgradedInstancePercent <Int32>]
      [-OsDiskCaching <CachingTypes>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-Overprovision <Boolean>]
      [-PauseTimeBetweenBatches <String>]
      [-PlanName <String>]
      [-PlanProduct <String>]
      [-PlanPromotionCode <String>]
      [-PlanPublisher <String>]
      [-ProvisionVMAgent <Boolean>]
      [-ProximityPlacementGroupId <String>]
      [-ScaleInPolicy <String[]>]
      [-SinglePlacementGroup <Boolean>]
      [-SkipExtensionsOnOverprovisionedVMs <Boolean>]
      [-SkuCapacity <Int32>]
      [-SkuName <String>]
      [-SkuTier <String>]
      [-Tag <Hashtable>]
      [-TerminateScheduledEventNotBeforeTimeoutInMinutes <Int32>]
      [-TerminateScheduledEvents <Boolean>]
      [-TimeZone <String>]
      [-UltraSSDEnabled <Boolean>]
      [-UpgradePolicyMode <UpgradeMode>]
      [-CapacityReservationGroupId <String>]
      [-VhdContainer <String[]>]
      [-AsJob]
      [-EncryptionAtHost <Boolean>]
      [-UserData <String>]
      [-AutomaticRepairAction <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzVmss
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
      [-AutomaticOSUpgrade <Boolean>]
      [-AutomaticRepairGracePeriod <String>]
      [-BootDiagnosticsEnabled <Boolean>]
      [-BootDiagnosticsStorageUri <String>]
      [-CustomData <String>]
      [-DisableAutoRollback <Boolean>]
      [-DisablePasswordAuthentication <Boolean>]
      [-EnableAutomaticRepair <Boolean>]
      [-EnableAutomaticUpdate <Boolean>]
      [-IdentityId <String[]>]
      -IdentityType <ResourceIdentityType>
      [-ImageReferenceId <String>]
      [-ImageReferenceOffer <String>]
      [-ImageReferencePublisher <String>]
      [-ImageReferenceSku <String>]
      [-ImageReferenceVersion <String>]
      [-ImageUri <String>]
      [-LicenseType <String>]
      [-ManagedDiskStorageAccountType <String>]
      [-MaxBatchInstancePercent <Int32>]
      [-MaxPrice <Double>]
      [-MaxUnhealthyInstancePercent <Int32>]
      [-MaxUnhealthyUpgradedInstancePercent <Int32>]
      [-OsDiskCaching <CachingTypes>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-Overprovision <Boolean>]
      [-PauseTimeBetweenBatches <String>]
      [-PlanName <String>]
      [-PlanProduct <String>]
      [-PlanPromotionCode <String>]
      [-PlanPublisher <String>]
      [-ProvisionVMAgent <Boolean>]
      [-ProximityPlacementGroupId <String>]
      [-ScaleInPolicy <String[]>]
      [-SinglePlacementGroup <Boolean>]
      [-SkipExtensionsOnOverprovisionedVMs <Boolean>]
      [-SkuCapacity <Int32>]
      [-SkuName <String>]
      [-SkuTier <String>]
      [-Tag <Hashtable>]
      [-TerminateScheduledEventNotBeforeTimeoutInMinutes <Int32>]
      [-TerminateScheduledEvents <Boolean>]
      [-TimeZone <String>]
      [-UltraSSDEnabled <Boolean>]
      [-UpgradePolicyMode <UpgradeMode>]
      [-CapacityReservationGroupId <String>]
      [-VhdContainer <String[]>]
      [-AsJob]
      [-EncryptionAtHost <Boolean>]
      [-UserData <String>]
      [-AutomaticRepairAction <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten Update-AzVmss uppdaterar tillståndet för en vm-skalningsuppsättning (VMSS) till tillståndet för ett lokalt VMSS-objekt.

Exempel

Exempel 1: Uppdatera tillståndet för en VMSS till tillståndet för ett lokalt VMSS-objekt.

Update-AzVmss -ResourceGroupName "Group001" -Name "VMSS001" -VirtualMachineScaleSet $LocalVMSS

Det här kommandot uppdaterar tillståndet för VMSS med namnet VMSS001 som tillhör resursgruppen Group001 till tillståndet för ett lokalt VMSS-objekt, $LocalVMSS.

Exempel 2

Uppdateringar tillståndet för en VMSS. (automatiskt genererad)

Update-AzVmss -ResourceGroupName 'Group001' -VMScaleSetName 'VMSS001' -VirtualMachineScaleSet <PSVirtualMachineScaleSet> -IdentityType SystemAssigned

Parametrar

-AsJob

Kör cmdleten i bakgrunden och returnera ett jobb för att spåra förloppet.

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

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

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

Typ av reparationsåtgärd (ersätt, starta om, återskapa) som ska användas för att reparera virtuella datorer som inte är felfria i skalningsuppsättningen. Standardvärdet är ersätt.

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 bör 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:False
Accept wildcard characters:False
-BootDiagnosticsEnabled

Om startdiagnostik ska aktiveras på vm-skalningsuppsättningen.

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

URI för lagringskontot som ska användas för att placera konsolens utdata och skärmbild.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
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:False
Accept pipeline input:False
Accept wildcard characters:False
-CustomData

Anger en base-64-kodad sträng med anpassade data. Detta avkodas till en binär matris som sparas som en fil på den virtuella datorn. Den maximala längden för den binära matrisen är 65535 byte.
Information om hur du använder cloud-init för din virtuella dator finns i Använda cloud-init för att anpassa en virtuell Linux-dator under skapandet.

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

Autentiseringsuppgifter, konto, klientorganisation och prenumeration 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
-DisablePasswordAuthentication

Anger att den här cmdleten inaktiverar lösenordsautentisering för Linux OS.

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

Aktivera eller inaktivera automatiska reparationer på vm-skalningsuppsättningen.

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

Anger om de virtuella Windows-datorerna i VMSS är aktiverade för automatiska uppdateringar.

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

Den här parametern kan användas av användaren i begäran för att aktivera eller inaktivera värdkryptering för vm-skalningsuppsättningen.

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

Anger listan över användaridentiteter som är associerade med VM-skalningsuppsättningen. Användaridentitetsreferenserna är ARM-resurs-ID:n i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}'

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
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 "Ingen" tar bort alla identiteter från vm-skalningsuppsättningen. De acceptabla värdena för den här parametern är:

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

Anger bildreferensens ID.

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

Anger typen av vm-avbildningserbjudande (VMImage). Om du vill hämta ett avbildningserbjudande använder du cmdleten Get-AzVMImageOffer.

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

Anger namnet på en utgivare av en VMImage. Om du vill hämta en utgivare använder du cmdleten Get-AzVMImagePublisher.

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

Anger VMImage SKU. Om du vill hämta SKU:er använder du cmdleten Get-AzVMImageSku.

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

Anger versionen av VMImage. Om du vill använda den senaste versionen anger du ett värde för den senaste versionen i stället för en viss version.

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

Anger blob-URI:n för användarbilden. VMSS skapar en operativsystemdisk i samma container för användaravbildningen.

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

Ange licenstypen, som är till för att skapa ett eget licensscenario.

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

Anger lagringskontotypen för hanterad disk. De acceptabla värdena för den här parametern är:

  • StandardLRS
  • PremiumLRS
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaxBatchInstancePercent

Den maximala procentandelen av de totala virtuella datorinstanserna som uppgraderas samtidigt av den löpande uppgraderingen i en batch. Eftersom detta är ett maximalt antal felaktiga instanser i tidigare eller framtida batchar kan procentandelen instanser i en batch minska för att säkerställa högre tillförlitlighet. Om värdet inte anges anges det till 20.

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

Anger det högsta pris som du är villig att betala för en virtuell dator/VMSS med låg prioritet. Det här priset är i amerikanska dollar. Det här priset jämförs med det aktuella priset med låg prioritet för VM-storleken. Dessutom jämförs priserna vid tidpunkten för skapande/uppdatering av virtuell dator/VMSS med låg prioritet och åtgärden lyckas bara om maxPrice är större än det aktuella priset med låg prioritet. MaxPrice används också för att ta bort en virtuell dator/VMSS med låg prioritet om det aktuella priset med låg prioritet överskrider maxPrice när du har skapat en virtuell dator/VMSS. Möjliga värden är: alla decimalvärden som är större än noll. Exempel: 0.01538. -1 anger att den virtuella datorn/VMSS med låg prioritet inte ska tas bort 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:False
Accept wildcard characters:False
-MaxUnhealthyInstancePercent

Den maximala procentandelen av de totala instanserna av virtuella datorer i skalningsuppsättningen som kan vara felfria samtidigt, antingen på grund av att de har uppgraderats eller genom att hittas i ett feltillstånd av hälsokontrollerna för den virtuella datorn innan den löpande uppgraderingen avbryts. Den här begränsningen kontrolleras innan någon batch startas. Om värdet inte anges anges det till 20.

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

Den maximala procentandelen uppgraderade virtuella datorinstanser som kan konstateras vara i ett feltillstånd. Den här kontrollen utförs när varje batch har uppgraderats. Om den här procentandelen någonsin överskrids avbryts den löpande uppdateringen. Om värdet inte anges anges det till 20.

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

Anger cachelagringsläget för operativsystemdisken. De acceptabla värdena för den här parametern är:

  • Ingen
  • ReadOnly
  • ReadWrite Standardvärdet är ReadWrite. Om du ändrar cachelagringsvärdet startar cmdleten om den virtuella datorn. Den här inställningen påverkar diskens konsekvens och prestanda.
Type:CachingTypes
Accepted values:None, ReadOnly, ReadWrite
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OsDiskWriteAccelerator

Anger om WriteAccelerator ska aktiveras eller inaktiveras på OS-disken.

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

Anger om cmdleten överetablerar VMSS.

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

Väntetiden mellan att slutföra uppdateringen för alla virtuella datorer i en batch och att starta nästa batch. Tidsåtgången ska anges i ISO 8601-format. Standardvärdet är 0 sekunder (PT0S).

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

Anger planens namn.

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

Anger planprodukten.

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

Anger koden för planhöjning.

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

Anger planutgivaren.

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

Anger om agenten för virtuella datorer ska etableras på de virtuella Windows-datorerna i VMSS.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
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:False
Accept wildcard characters:False
-ResourceGroupName

Anger namnet på den resursgrupp som VMSS tillhör.

Type:String
Position:0
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:False
Accept wildcard characters:False
-SinglePlacementGroup

Anger den enskilda placeringsgruppen.

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

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

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

Anger antalet instanser i VMSS.

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

Anger storleken på alla instanser av VMSS.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
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:Named
Default value:None
Accept pipeline input:False
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:Named
Default value:None
Accept pipeline input:False
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

Anger om avsluta schemalagd händelse är aktiverad eller inaktiverad.

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

Anger tidszonen för Windows-operativsystemet, t.ex. "Pacific Standard Time".
Möjliga värden kan vara TimeZoneInfo.Id värde från tidszoner som returneras av TimeZoneInfo.GetSystemTimeZones.

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

Flaggan som aktiverar eller inaktiverar en funktion för 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:Boolean
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
  • Rullande
Type:UpgradeMode
Accepted values:Automatic, Manual, Rolling
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserData

UserData för Vmss, 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
-VhdContainer

Anger de container-URL:er som används för att lagra operativsystemdiskar för VMSS.

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

Anger ett lokalt VMSS-objekt. Om du vill hämta ett VMSS-objekt använder du cmdleten Get-AzVmss. Det här objektet för den virtuella datorn innehåller det uppdaterade tillståndet för VMSS.

Type:PSVirtualMachineScaleSet
Position:2
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-VMScaleSetName

Anger namnet på den VMSS som den här cmdleten skapar.

Type:String
Aliases:Name
Position:1
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:False
Accept pipeline input:False
Accept wildcard characters:False

Indata

String

PSVirtualMachineScaleSet

Boolean

Utdata

PSVirtualMachineScaleSet