你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Set-AzureRMVMDataDisk
修改虚拟机数据磁盘的属性。
警告
截至 2024 年 2 月 29 日，AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新，建议用户从 AzureRM 迁移到 Az PowerShell 模块。
尽管 AzureRM 模块仍可能正常运行，但它不再维护或受支持，但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导，请参阅我们的迁移资源。
语法
Set-AzureRMVMDataDisk
[-VM] <PSVirtualMachine>
[-Name] <String>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Set-AzureRMVMDataDisk
[-VM] <PSVirtualMachine>
[-Lun] <Int32>
[[-Caching] <CachingTypes>]
[[-DiskSizeInGB] <Int32>]
[-StorageAccountType <String>]
[-WriteAccelerator]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 说明
Set-AzureRmVMDataDisk cmdlet 修改虚拟机数据磁盘的属性。
示例
示例 1：修改数据磁盘的缓存模式
PS C:\> $VM = Get-AzureRMVM -ResourceGroupName "ResourceGroup11" -VMName "ContosoVM07"
PS C:\> Set-AzureRmVMDataDisk -VM $VM -Name "DataDisk01" -Caching ReadWrite | Update-AzureRmVM第一个命令使用 Get-AzureRmVM 获取名为 ContosoVM07 的虚拟机。 该命令将其存储在$VM变量中。 第二个命令修改$VM虚拟机上名为 DataDisk01 的数据磁盘的缓存模式。 此命令将结果传递给 Update-AzureRmVM cmdlet，该 cmdlet 可实现更改。 对现金模式的更改会导致虚拟机重启。
参数
-Caching
指定磁盘的缓存模式。 此参数的可接受值为：
- ReadOnly
- ReadWrite 默认值为 ReadWrite。 更改此值会导致虚拟机重启。 此设置会影响磁盘的一致性和性能。
| Type: | Nullable<T>[CachingTypes] |
| Accepted values: | None, ReadOnly, ReadWrite |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSizeInGB
指定数据磁盘的大小（以 GB 为单位）。
| Type: | Nullable<T>[Int32] |
| Position: | 3 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Lun
指定此 cmdlet 修改的数据磁盘的逻辑单元号（LUN）。
| Type: | Nullable<T>[Int32] |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定此 cmdlet 修改的数据磁盘的名称。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StorageAccountType
虚拟机托管磁盘的帐户类型。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VM
指定此 cmdlet 修改数据磁盘的虚拟机。 若要获取虚拟机对象，请使用 Get-AzureRmVM cmdlet。
| Type: | PSVirtualMachine |
| Aliases: | VMProfile |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WriteAccelerator
指定是否应在数据磁盘上启用或禁用 WriteAccelerator。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
Nullable<T>[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.CachingTypes, Microsoft.Azure.Management.Compute, Version=21.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]