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

Set-AzVMDataDisk

修改虚拟机数据磁盘的属性。

语法

Set-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Name] <String>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzVMDataDisk
   [-VM] <PSVirtualMachine>
   [-Lun] <Int32>
   [[-Caching] <CachingTypes>]
   [[-DiskSizeInGB] <Int32>]
   [-StorageAccountType <String>]
   [-DiskEncryptionSetId <String>]
   [-WriteAccelerator]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Set-AzVMDataDisk cmdlet 修改虚拟机数据磁盘的属性。

示例

示例 1:修改数据磁盘的缓存模式

$VM = Get-AzVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
Set-AzVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzVM

第一个命令使用 Get-AzVM 获取名为 ContosoVM07 的虚拟机。 该命令将其存储在$VM变量中。 第二个命令修改$VM虚拟机上名为 DataDisk01 的数据磁盘的缓存模式。 该命令将结果传递给 Update-AzVM cmdlet,该 cmdlet 可实现更改。 对现金模式的更改会导致虚拟机重启。

示例 2

修改虚拟机数据磁盘的属性。 (自动生成)

Set-AzVMDataDisk -Caching None -Lun 1 -VM <PSVirtualMachine>

参数

-Caching

指定磁盘的缓存模式。 此参数的可接受值为:

  • ReadOnly
  • ReadWrite 默认值为 ReadWrite。 更改此值会导致虚拟机重启。 此设置会影响磁盘的一致性和性能。
类型:Nullable<T>[CachingTypes]
接受的值:None, ReadOnly, ReadWrite
Position:2
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-DefaultProfile

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

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

-DiskEncryptionSetId

指定客户托管磁盘加密集的资源 ID。 这只能为托管磁盘指定。

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

-DiskSizeInGB

指定数据磁盘的大小(以 GB 为单位)。

类型:Nullable<T>[Int32]
Position:3
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-Lun

指定此 cmdlet 修改的数据磁盘的逻辑单元号(LUN)。

类型:Nullable<T>[Int32]
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Name

指定此 cmdlet 修改的数据磁盘的名称。

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

-StorageAccountType

虚拟机托管磁盘的帐户类型。

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

-VM

指定此 cmdlet 修改数据磁盘的虚拟机。 若要获取虚拟机对象,请使用 Get-AzVM cmdlet。

类型:PSVirtualMachine
别名:VMProfile
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WriteAccelerator

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

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

输入

PSVirtualMachine

String

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

输出

PSVirtualMachine