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

Update-AzVmssVM

更新 Vmss VM 的状态。

语法

DefaultParameter (默认值)

Update-AzVmssVM
    [-ResourceGroupName] <String>
    [-VMScaleSetName] <String>
    [-InstanceId] <String>
    [-ProxyAgentKeyIncarnationId <Int32>]
    [-DataDisk <PSVirtualMachineDataDisk[]>]
    [-ProtectFromScaleIn <Boolean>]
    [-ProtectFromScaleSetAction <Boolean>]
    [-AsJob]
    [-UserData <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceIdParameter

Update-AzVmssVM
    [-ResourceId] <String>
    [-ProxyAgentKeyIncarnationId <Int32>]
    [-DataDisk <PSVirtualMachineDataDisk[]>]
    [-ProtectFromScaleIn <Boolean>]
    [-ProtectFromScaleSetAction <Boolean>]
    [-AsJob]
    [-UserData <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ObjectParameter

Update-AzVmssVM
    [-VirtualMachineScaleSetVM] <PSVirtualMachineScaleSetVM>
    [-ProxyAgentKeyIncarnationId <Int32>]
    [-DataDisk <PSVirtualMachineDataDisk[]>]
    [-ProtectFromScaleIn <Boolean>]
    [-ProtectFromScaleSetAction <Boolean>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

更新 Vmss VM 的状态。 目前,唯一允许的更新是添加托管数据磁盘。

示例

示例 1:使用 New-AzVMDataDisk 将托管数据磁盘添加到 Vmss VM

$disk = Get-AzDisk -ResourceGroupName $rgname -DiskName $diskname0
$datadisk = New-AzVMDataDisk -Caching 'ReadOnly' -Lun 2 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
$VmssVM = Get-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
Update-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0 -DataDisk $datadisk

第一个命令获取现有的托管磁盘。 下一个命令使用托管磁盘创建数据磁盘对象。 下一个命令获取资源组名称、vmss 名称和实例 ID 提供的现有 Vmss VM。 最后一个命令通过添加新的数据磁盘来更新 Vmss VM。

示例 2:使用 Add-AzVMDataDisk 将托管数据磁盘添加到 Vmss VM

$disk = Get-AzDisk -ResourceGroupName $rgname -DiskName $diskname0
$VmssVM = Get-AzVmssVM -ResourceGroupName "myrg" -VMScaleSetName "myvmss" -InstanceId 0
$VmssVM = Add-AzVMDataDisk -VM $VmssVM -Lun 0 -DiskSizeInGB 10 -CreateOption Attach -StorageAccountType Standard_LRS -ManagedDiskId $disk.Id
Update-AzVmssVM -VirtualMachineScaleSetVM $VmssVM

第一个命令获取现有的托管磁盘。 下一个命令获取资源组名称、vmss 名称和实例 ID 提供的现有 Vmss VM。 下一个命令将托管磁盘添加到存储在本地$VmssVM中的 Vmss VM。 最后一个命令使用添加的数据磁盘更新 Vmss VM。

示例 3

更新 Vmss VM 的状态。 (autogenerated)

Update-AzVmssVM -InstanceId 0 -ProtectFromScaleIn $false -ProtectFromScaleSetAction $false -ResourceGroupName 'myrg' -VMScaleSetName 'myvmss'

参数

-AsJob

在后台运行 cmdlet

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DataDisk

更新 Vmss VM 的状态。 目前,唯一允许的更新是添加托管数据磁盘。

参数属性

类型:

PSVirtualMachineDataDisk[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InstanceId

指定 VMSS VM 的实例 ID。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

DefaultParameter
Position:2
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ProtectFromScaleIn

指示不应将虚拟机规模集 VM 视为在进行缩减操作期间删除。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ProtectFromScaleSetAction

指示不应将 VMSS 上启动的模型更新或作(包括缩减)应用于 VMSS VM。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ProxyAgentKeyIncarnationId

增加此参数的值允许用户重置用于保护来宾和主机之间的信道的密钥。

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False
别名:KeyIncarnationId

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ResourceGroupName

指定 VMSS 的资源组的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

DefaultParameter
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ResourceId

虚拟机规模集 VM 的资源 ID

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

ResourceIdParameter
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-UserData

将进行 base-64 编码的 Vmss Vm 的 UserData。 客户不应在此处传递任何机密。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

DefaultParameter
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False
ResourceIdParameter
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-VirtualMachineScaleSetVM

本地虚拟机规模集 VM 对象

参数属性

类型:PSVirtualMachineScaleSetVM
默认值:None
支持通配符:False
不显示:False

参数集

ObjectParameter
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-VMScaleSetName

虚拟机规模集的名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:Name

参数集

DefaultParameter
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

String

PSVirtualMachineDataDisk

PSVirtualMachineScaleSetVM

输出

PSVirtualMachineScaleSetVM