Update-AzureRmVmss

Referens

Modul:: AzureRM.Compute

Uppdateringar tillståndet för en VMSS.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

Update-AzureRmVmss
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
      [-ImageReferenceSku <String>]
      [-ManagedDiskStorageAccountType <String>]
      [-PlanPublisher <String>]
      [-ProvisionVMAgent <Boolean>]
      [-BootDiagnosticsEnabled <Boolean>]
      [-Overprovision <Boolean>]
      [-MaxBatchInstancePercent <Int32>]
      [-TimeZone <String>]
      [-BootDiagnosticsStorageUri <String>]
      [-AutomaticOSUpgrade <Boolean>]
      [-DisableAutoRollback <Boolean>]
      [-SinglePlacementGroup <Boolean>]
      [-CustomData <String>]
      [-UpgradePolicyMode <UpgradeMode>]
      [-ImageReferenceId <String>]
      [-DisablePasswordAuthentication <Boolean>]
      [-Tag <Hashtable>]
      [-PlanName <String>]
      [-MaxUnhealthyUpgradedInstancePercent <Int32>]
      [-ImageReferencePublisher <String>]
      [-PlanProduct <String>]
      [-VhdContainer <String[]>]
      [-ImageUri <String>]
      [-SkuTier <String>]
      [-EnableAutomaticUpdate <Boolean>]
      [-LicenseType <String>]
      [-SkuName <String>]
      [-PlanPromotionCode <String>]
      [-MaxUnhealthyInstancePercent <Int32>]
      [-SkuCapacity <Int32>]
      [-OsDiskWriteAccelerator <Boolean>]
      [-ImageReferenceOffer <String>]
      [-PauseTimeBetweenBatches <String>]
      [-OsDiskCaching <CachingTypes>]
      [-ImageReferenceVersion <String>]
      [-UltraSSDEnabled <Boolean>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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

Description

Cmdleten Update-AzureRmVmss uppdaterar tillståndet för en VMSS (Virtual Machine Scale Set) 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.

PS C:\> Update-AzureRmVmss -ResourceGroupName "Group001" -Name "VMSS001" -VirtualMachineScaleSet $LocalVMSS

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

Parametrar

-AsJob

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

Typ:	SwitchParameter
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AutomaticOSUpgrade

Anger om OS-uppgraderingar ska tillämpas automatiskt på skalningsuppsättningsinstanser på ett rullande sätt när en nyare version av avbildningen blir tillgänglig.

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BootDiagnosticsEnabled

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

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
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.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
standardvärde:	False
Obligatorisk:	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 på den binära matrisen är 65535 byte.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableAutoRollback

Inaktivera automatisk återställning för automatisk uppgraderingsprincip för operativsystem

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisablePasswordAuthentication

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

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAutomaticUpdate

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

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
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}'

Typ:	String[]
Position:	Named
standardvärde:	None
Obligatorisk:	False
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:

SystemAssigned
UserAssigned
SystemAssignedUserAssigned
Ingen

Typ:	Nullable<T>[ResourceIdentityType]
accepterade värden:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferenceId

Anger bildens referens-ID.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferenceOffer

Anger typen av VMImage-erbjudande (virtual machine image). Om du vill hämta ett avbildningserbjudande använder du cmdleten Get-AzureRmVMImageOffer.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
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-AzureRmVMImagePublisher.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageReferenceSku

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

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
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.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ImageUri

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

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseType

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

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
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

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
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 har angetts anges det till 20.

Typ:	Int32
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaxUnhealthyInstancePercent

Den maximala procentandelen av de totala virtuella datorinstanserna i skalningsuppsättningen som kan vara felfritt samtidigt, antingen till följd av uppgraderingen 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 har angetts anges det till 20.

Typ:	Int32
Position:	Named
standardvärde:	None
Obligatorisk:	False
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 sker när varje batch har uppgraderats. Om den här procentandelen någonsin överskrids avbryts den löpande uppdateringen. Om värdet inte har angetts anges det till 20.

Typ:	Int32
Position:	Named
standardvärde:	None
Obligatorisk:	False
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
Skrivskyddat
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.

Typ:	CachingTypes
accepterade värden:	None, ReadOnly, ReadWrite
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OsDiskWriteAccelerator

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

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Overprovision

Anger om cmdleten överetablerar VMSS.

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
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 starta nästa batch. Varaktigheten ska anges i ISO 8601-format. Standardvärdet är 0 sekunder (PT0S).

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlanName

Anger plannamnet.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlanProduct

Anger planprodukten.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlanPromotionCode

Anger koden för planhöjning.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PlanPublisher

Anger planutgivaren.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
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.

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Anger namnet på resursgruppen som VMSS tillhör.

Typ:	String
Position:	1
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SinglePlacementGroup

Anger den enskilda placeringsgruppen.

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkuCapacity

Anger antalet instanser i VMSS.

Typ:	Int32
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkuName

Anger storleken på alla instanser av VMSS.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
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
Grundläggande

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
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"}

Typ:	Hashtable
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeZone

Anger tidszonen för Windows OS.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
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.

Typ:	Boolean
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-UpgradePolicyMode

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

Automatisk
Manuell
Rullande

Typ:	UpgradeMode
accepterade värden:	Automatic, Manual, Rolling
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VhdContainer

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

Typ:	String[]
Position:	Named
standardvärde:	None
Obligatorisk:	False
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-AzureRmVmss. Det här objektet för den virtuella datorn innehåller det uppdaterade tillståndet för VMSS.

Typ:	PSVirtualMachineScaleSet
Position:	3
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VMScaleSetName

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

Typ:	String
Aliases:	Name
Position:	2
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
standardvärde:	False
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

String

PSVirtualMachineScaleSet

Parametrar: VirtualMachineScaleSet (ByValue)

Utdata