Delen via


Update-AzVmss

Hiermee wordt de status van een VMSS bijgewerkt.

Syntaxis

Update-AzVmss
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
      [-ImageReferenceSku <String>]
      [-ManagedDiskStorageAccountType <StorageAccountTypes>]
      [-PlanPublisher <String>]
      [-ProvisionVMAgent <Boolean>]
      [-BootDiagnosticsEnabled <Boolean>]
      [-Overprovision <Boolean>]
      [-MaxBatchInstancePercent <Int32>]
      [-TimeZone <String>]
      [-BootDiagnosticsStorageUri <String>]
      [-AutomaticOSUpgrade <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>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzVmss
      [-ResourceGroupName] <String>
      [-VMScaleSetName] <String>
      [[-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>]
      [-ImageReferenceSku <String>]
      [-IdentityId <String[]>]
      [-ManagedDiskStorageAccountType <StorageAccountTypes>]
      [-PlanPublisher <String>]
      [-ProvisionVMAgent <Boolean>]
      [-BootDiagnosticsEnabled <Boolean>]
      [-Overprovision <Boolean>]
      [-MaxBatchInstancePercent <Int32>]
      [-TimeZone <String>]
      [-BootDiagnosticsStorageUri <String>]
      [-AutomaticOSUpgrade <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>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

De cmdlet Update-AzVmss werkt de status van een virtuele-machineschaalset (VMSS) bij naar de status van een lokaal VMSS-object.

Voorbeelden

Voorbeeld 1: Werk de status van een VMSS bij naar de status van een lokaal VMSS-object.

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

Met deze opdracht wordt de status van de VMSS met de naam VMSS001 bijgewerkt die deel uitmaakt van de resourcegroep Group001 tot de status van een lokaal VMSS-object, $LocalVMSS.

Parameters

-AsJob

Voer de cmdlet op de achtergrond uit en retourneer een taak om de voortgang bij te houden.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AutomaticOSUpgrade

Hiermee stelt u in of besturingssysteemupgrades automatisch op schaalsetexemplaren moeten worden toegepast wanneer een nieuwere versie van de installatiekopie beschikbaar wordt.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BootDiagnosticsEnabled

Of diagnostische gegevens over opstarten moeten worden ingeschakeld op de virtuele-machineschaalset.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-BootDiagnosticsStorageUri

URI van het opslagaccount dat moet worden gebruikt voor het plaatsen van de console-uitvoer en schermopname.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

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

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CustomData

Hiermee geeft u een met base 64 gecodeerde tekenreeks van aangepaste gegevens op. Dit wordt gedecodeerd naar een binaire matrix die wordt opgeslagen als een bestand op de virtuele machine. De maximale lengte van de binaire matrix is 65535 bytes.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DisablePasswordAuthentication

Geeft aan dat met deze cmdlet wachtwoordverificatie voor linux-besturingssysteem wordt uitgeschakeld.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EnableAutomaticUpdate

Hiermee wordt aangegeven of de virtuele Windows-machines in de VMSS zijn ingeschakeld voor automatische updates.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IdentityType

Hiermee geeft u het type identiteit 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 None worden alle identiteiten uit de virtuele-machineschaalset verwijderd. De acceptabele waarden voor deze parameter zijn:

  • SystemAssigned
  • UserAssigned
  • SystemAssignedUserAssigned
  • None
Type:ResourceIdentityType
Geaccepteerde waarden:SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ImageReferenceId

Hiermee geeft u de referentie-id van de installatiekopieën op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ImageReferenceOffer

Hiermee geeft u het type vm-installatiekopie (VMImage) aanbieding. Gebruik de cmdlet Get-AzVMImageOffer om een installatiekopieaanbieding te verkrijgen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ImageReferencePublisher

Hiermee geeft u de naam van een uitgever van een VMImage. Gebruik de cmdlet Get-AzVMImagePublisher om een uitgever te verkrijgen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ImageReferenceSku

Hiermee geeft u de VMImage-SKU. Gebruik de cmdlet Get-AzVMImageSku om SKU's te verkrijgen.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ImageReferenceVersion

Hiermee geeft u de versie van de VMImage. Als u de nieuwste versie wilt gebruiken, geeft u een waarde op van de meest recente in plaats van een bepaalde versie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ImageUri

Hiermee geeft u de blob-URI voor de gebruikersinstallatiekopieën. VMSS maakt een besturingssysteemschijf in dezelfde container van de gebruikersinstallatiekopieën.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-LicenseType

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ManagedDiskStorageAccountType

Hiermee geeft u het type opslagaccount voor beheerde schijf. De acceptabele waarden voor deze parameter zijn:

  • StandardLRS
  • PremiumLRS
Type:StorageAccountTypes
Geaccepteerde waarden:StandardLRS, PremiumLRS
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaxBatchInstancePercent

Het maximumpercentage van het totale aantal exemplaren van virtuele machines dat tegelijkertijd wordt geüpgraded door de rolling upgrade in één batch. Omdat dit een maximum is, kunnen beschadigde exemplaren in eerdere of toekomstige batches ervoor zorgen dat het percentage exemplaren in een batch afneemt om een hogere betrouwbaarheid te garanderen. Als de waarde niet is opgegeven, wordt deze ingesteld op 20.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaxUnhealthyInstancePercent

Het maximumpercentage van het totale aantal exemplaren van virtuele machines in de schaalset dat tegelijkertijd beschadigd kan zijn, hetzij als gevolg van een upgrade of door de statuscontroles van de virtuele machine te worden aangetroffen voordat de rolling upgrade wordt afgebroken. Deze beperking wordt gecontroleerd voordat u een batch start. Als de waarde niet is opgegeven, wordt deze ingesteld op 20.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaxUnhealthyUpgradedInstancePercent

Het maximumpercentage van bijgewerkte exemplaren van virtuele machines die kunnen worden gevonden, hebben een slechte status. Deze controle vindt plaats nadat elke batch is bijgewerkt. Als dit percentage ooit wordt overschreden, wordt de rolling update afgebroken. Als de waarde niet is opgegeven, wordt deze ingesteld op 20.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OsDiskCaching

Hiermee geeft u de cachemodus van de besturingssysteemschijf. De acceptabele waarden voor deze parameter zijn:

  • None
  • Alleen-lezen
  • Readwrite

De standaardwaarde is ReadWrite. Als u de cachewaarde wijzigt, start de cmdlet de virtuele machine opnieuw op.

Deze instelling is van invloed op de consistentie en prestaties van de schijf.

Type:CachingTypes
Geaccepteerde waarden:None, ReadOnly, ReadWrite
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OsDiskWriteAccelerator

Hiermee geeft u op of WriteAccelerator moet worden ingeschakeld of uitgeschakeld op de besturingssysteemschijf.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Overprovision

Geeft aan of de cmdlet de VMSS overprovisiont.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PauseTimeBetweenBatches

De wachttijd tussen het voltooien van de update voor alle virtuele machines in één batch en het starten van de volgende batch. De tijdsduur moet worden opgegeven in ISO 8601-indeling. De standaardwaarde is 0 seconden (PT0S).

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PlanName

Hiermee geeft u de naam van het plan.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PlanProduct

Hiermee geeft u het planproduct op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PlanPromotionCode

Hiermee geeft u de promotiecode van het plan.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PlanPublisher

Hiermee geeft u de uitgever van het plan op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProvisionVMAgent

Hiermee wordt aangegeven of de virtuele-machineagent moet worden ingericht op de virtuele Windows-machines in de VMSS.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep waartoe de VMSS behoort.

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SinglePlacementGroup

Hiermee geeft u de individuele plaatsingsgroep.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkuCapacity

Hiermee geeft u het aantal exemplaren in de VMSS.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkuName

Hiermee geeft u de grootte van alle exemplaren van VMSS.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkuTier

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

  • Standard
  • Basis
Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Voorbeeld:

@{key0="value0";key1=$null;key2="value2"}

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimeZone

Hiermee geeft u de tijdzone voor Het Windows-besturingssysteem.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UpgradePolicyMode

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

  • Automatisch
  • Manual
  • Opvolgend
Type:UpgradeMode
Geaccepteerde waarden:Automatic, Manual, Rolling
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VhdContainer

Hiermee geeft u de container-URL's op die worden gebruikt voor het opslaan van besturingssysteemschijven voor de VMSS.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VirtualMachineScaleSet

Hiermee geeft u een lokaal VMSS-object. Gebruik de cmdlet Get-AzVmss om een VMSS-object op te halen. Dit virtuele-machineobject bevat de bijgewerkte status voor de VMSS.

Type:PSVirtualMachineScaleSet
Position:3
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMScaleSetName

Hiermee geeft u de naam op van de VMSS die met deze cmdlet wordt gemaakt.

Type:String
Aliassen:Name
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

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

De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

VirtualMachineScaleSet

Parameter 'VirtualMachineScaleSet' accepteert de waarde van het type VirtualMachineScaleSet uit de pijplijn

Uitvoerwaarden

PSVirtualMachineScaleSet