你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzureRmVmss

参考

模块:: AzureRM.Compute

汇报 VMSS 的状态。

警告

截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。有关过渡到 Az 模块的指导，请参阅我们的迁移资源。

语法

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

说明

Update-AzureRmVmss cmdlet 将虚拟机规模集（VMSS）的状态更新为本地 VMSS 对象的状态。

示例

示例 1：将 VMSS 的状态更新为本地 VMSS 对象的状态。

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

此命令将属于 VMSS001名为 Group001 的资源组的 VMSS 的状态更新为本地 VMSS 对象的状态，$LocalVMSS。

参数

-AsJob

在后台运行 cmdlet 并返回作业以跟踪进度。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AutomaticOSUpgrade

设置当较新版本的映像可用时，是否应以滚动方式自动将 OS 升级应用于规模集实例。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-BootDiagnosticsEnabled

是否应在虚拟机规模集上启用启动诊断。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-BootDiagnosticsStorageUri

用于放置控制台输出和屏幕截图的存储帐户的 URI。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-CustomData

指定自定义数据的 base-64 编码字符串。这已解码为作为虚拟机上的文件保存的二进制数组。二进制数组的最大长度为 65535 字节。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	IAzureContextContainer
别名:	AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisableAutoRollback

禁用自动 OS 升级策略的自动回滚

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisablePasswordAuthentication

指示此 cmdlet 禁用 Linux OS 的密码身份验证。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableAutomaticUpdate

指示是否为 VMSS 中的 Windows 虚拟机启用了自动更新。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdentityId

指定与虚拟机规模集关联的用户标识列表。用户标识引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/identities/{identityName}”

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdentityType

指定用于虚拟机规模集的标识类型。类型“SystemAssignedUserAssigned”包括隐式创建的标识和一组用户分配的标识。类型“None”将从虚拟机规模集中删除任何标识。此参数的可接受值为：

SystemAssigned
UserAssigned
SystemAssignedUserAssigned
无

类型:	Nullable<T>[ResourceIdentityType]
接受的值:	SystemAssigned, UserAssigned, SystemAssignedUserAssigned, None
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ImageReferenceId

指定图像引用 ID。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImageReferenceOffer

指定虚拟机映像（VMImage）产品/服务的类型。若要获取映像产品/服务，请使用 Get-AzureRmVMImageOffer cmdlet。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImageReferencePublisher

指定 VMImage 的发布者的名称。若要获取发布者，请使用 Get-AzureRmVMImagePublisher cmdlet。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImageReferenceSku

指定 VMImage SKU。若要获取 SKU，请使用 Get-AzureRmVMImageSku cmdlet。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImageReferenceVersion

指定 VMImage 的版本。若要使用最新版本，请指定最新版本而不是特定版本的值。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImageUri

指定用户映像的 Blob URI。 VMSS 在用户映像的同一容器中创建操作系统磁盘。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-LicenseType

指定用于自带许可证方案的许可证类型。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ManagedDiskStorageAccountType

指定托管磁盘的存储帐户类型。此参数的可接受值为：

StandardLRS
高级版LRS

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaxBatchInstancePercent

一批滚动升级同时升级的总虚拟机实例的最大百分比。由于这是一个最大值，因此以前的或将来的批中的不正常实例可能会导致批处理中的实例百分比降低，以确保更高的可靠性。如果未指定该值，则该值设置为 20。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaxUnhealthyInstancePercent

规模集中虚拟机实例总数的最大百分比，这些实例可能是由于升级而同时运行不正常的，或者在滚动升级中止之前，虚拟机运行状况检查处于不正常状态。在启动任何批处理之前，将检查此约束。如果未指定该值，则该值设置为 20。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaxUnhealthyUpgradedInstancePercent

可发现处于不正常状态的已升级虚拟机实例的最大百分比。升级每个批处理后，将发生此检查。如果超过此百分比，滚动更新将中止。如果未指定该值，则该值设置为 20。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OsDiskCaching

指定操作系统磁盘的缓存模式。此参数的可接受值为：

无
ReadOnly
ReadWrite 默认值为 ReadWrite。如果更改缓存值，cmdlet 将重启虚拟机。此设置会影响磁盘的一致性和性能。

类型:	CachingTypes
接受的值:	None, ReadOnly, ReadWrite
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OsDiskWriteAccelerator

指定是否应在 OS 磁盘上启用或禁用 WriteAccelerator。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Overprovision

指示 cmdlet 是否过度预配 VMSS。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PauseTimeBetweenBatches

完成一批中所有虚拟机的更新和开始下一批之间的等待时间。持续时间应采用 ISO 8601 格式指定。默认值为 0 秒（PT0S）。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PlanName

指定计划名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PlanProduct

指定计划产品。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PlanPromotionCode

指定计划升级代码。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PlanPublisher

指定计划发布者。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProvisionVMAgent

指示是否应在 VMSS 中的 Windows 虚拟机上预配虚拟机代理。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

指定 VMSS 所属的资源组的名称。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-SinglePlacementGroup

指定单个放置组。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkuCapacity

指定 VMSS 中的实例数。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkuName

指定 VMSS 的所有实例的大小。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkuTier

指定 VMSS 的层。此参数的可接受值为：

Standard
基本

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Tag

以哈希表的形式进行键值对。例如：@{key0=“value0”;key1=$null;key2=“value2”}

类型:	Hashtable
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TimeZone

指定 Windows OS 的时区。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UltraSSDEnabled

启用或禁用在虚拟机规模集上具有一个或多个具有UltraSSD_LRS存储帐户类型的托管数据磁盘的功能的标志。仅当启用此属性时，才能将存储帐户类型UltraSSD_LRS的托管磁盘添加到 VMSS。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-UpgradePolicyMode

指定了升级到规模集中虚拟机的模式。此参数的可接受值为：

自动
手动
滚动

类型:	UpgradeMode
接受的值:	Automatic, Manual, Rolling
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VhdContainer

指定用于存储 VMSS 操作系统磁盘的容器 URL。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VirtualMachineScaleSet

指定本地 VMSS 对象。若要获取 VMSS 对象，请使用 Get-AzureRmVmss cmdlet。此虚拟机对象包含 VMSS 的更新状态。

类型:	PSVirtualMachineScaleSet
Position:	3
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-VMScaleSetName

指定此 cmdlet 创建的 VMSS 的名称。

类型:	String
别名:	Name
Position:	2
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

String

PSVirtualMachineScaleSet

参数：VirtualMachineScaleSet （ByValue）

输出